Next: Uninstalling, Previous: Installing Roadsend PHP on Windows, Up: Installation and Configuration
The configuration file determines how Roadsend PHP runs and tells it where to find runtime files. You may edit the configuration file by hand, or (in Windows) use the Roadsend Compiler Studio IDE to maintain it.
On Unix, the configuration file is located at /etc/pcc.conf. On Windows, this file is located in c:\roadsend\etc\pcc.conf.
On Windows the configuration file can be edited from within the Roadsend Studio IDE. See IDE Configuration.
A sample configuration file is listed below.
; Roadsend PCC Configuration File ;; ;; lines starting with a semicolon are considered comments ;; ;; DIRECTIVE: home (home "/opt/roadsend/pcc/lib") ;; DIRECTIVE: include (include "./" "/usr/local/lib/php/") ;; DIRECTIVE: library ;Library directives add directories to the dynamic-load search path. (library "./" "/usr/local/pcclibs/") ;; DIRECTIVE: web-libs ; these libraries will be loaded by the web modules and ; the interpreter before the script is run ; the default enables all extensions (web-libs php-std php-pcre php-xml php-mysql php-curl php-sqlite) ;; DIRECTIVE: default-commandline-lib ; these libraries will be used as if with -u on the commandline ; the default enables all extensions (default-commandline-lib php-std php-pcre php-xml php-mysql php-curl php-sqlite) ;; DIRECTIVE: ini ; this directive sets PHP ini flags ; this is an ini entry to tell the mysql lib where the socket is (ini (mysql.default_socket "/var/run/mysqld/mysqld.sock")) ; session configuration (ini (session.cookie_lifetime 0) (session.cookie_path "/") (session.cookie_domain "") (session.cookie_secure #f) (session.save_path "/tmp") (session.name "PHPSESSID") (session.auto_start 0) (session.use_cookies 1) (session.use_only_cookies 0) (session.referer_check "") (session.cache_limiter "nocache") (session.cache_expire 180) (session.use_trans_id 0) (url_rewriter.tags "a=href,area=href,frame=src,input=src,form=fakeentry") (session.gc_probability 1) (session.gc_divisor 100) (session.gc_maxlifetime 1440)) ; file uploads (ini (file_uploads 1) ; leave this unset for the system default ;(upload_tmp_dir "/tmp") ; note this is specified in bytes (upload_max_filesize 2048000)) ;; DIRECTIVE: debug-level ; a level of 0 will turn off all debugging messages. ; set to 1 to receive verbose errors and warnings while ; compiling and running ; debug level (debug-level 1)
Configuration directives are in the form:
(directive-name [value1 value2 .. valueN])
Each value will be either a literal (unquoted) or a string (quoted):
(literal-directive value) (string-directive "a value")
Any line starting with a semicolon is considered a comment and ignored.
A list of valid directives and how to use them follows.
Configuration Directives
Directive | Examples |
Description
|
---|---|---|
debug-level | (debug-level 0) |
Set the debug level. A value of 0 turns off all debug messages. A value of 1 or 2 will display
debugging information you may find helpful if you are having a problem compiling or interpreting. It
will produce output to STDERR for command line compiling or to the web server error log for interpreting
or running web applications.
|
home | (home "/opt/roadsend/pcc/lib") |
This is the "base" directory for Roadsend PHP.
|
include | (include "./" "/usr/local/lib/php/") |
This is the list of paths for searching for include files, and is analogous to the PHP include_path.
|
library | (library "./" "/usr/local/roadsend/pcc/lib/") |
This is the list of paths to search for extensions and user created libraries.
Library directives add directories to the dynamic-load search path.
|
web-libs | (web-libs "testlib") |
These libraries will be loaded by the web module and the interpreter before the script is run.
If a library depends on other libraries, it should be listed after them in the configuration file.
|
default-commandline-lib | (default-commandline-lib php-std php-pcre php-xml php-mysql) |
These libraries will be used as if with -u on the commandline. This means they will always be loaded
and linked to applications built on the command line. You may remove those that are unnecessary, or add
others you would always like included. You should never remove php-std.
|
ini | (ini (mysql.default_socket "/var/run/mysqld/mysqld.sock")) |
This creates an "ini entry". An ini entry is a key/value pair that
adjusts the behavior of your programs. Each supported entry has a
similar effect to the entry of the same name in the php.ini
configuration file for Zend PHP. (See
http://www.php.net/configuration for more about php.ini
for Zend PHP).
|
Note
If you are changing a value that needs to be reflected in your web server, you may need to restart it for the changes to take effect.