Chapter 3. Configuration
The special value none disables auto-appending.
Note: If the script is terminated with exit(), auto-append will not occur.
auto_prepend_filestring
Specifies the name of a file that is automatically parsed before the main file. The file is included as if it was called with the include() function, soinclude_pathis used.
The special value none disables auto-prepending.
cgi_extstring
display_errorsboolean
This determines whether errors should be printed to the screen as part of the HTML output or not.
doc_rootstring
PHP’s "root directory" on the server. Only used if non-empty. If PHP is configured withsafe mode, no files outside this directory are served.
engineboolean
This directive is really only useful in the Apache module version of PHP. It is used by sites that would like to turn PHP parsing on and off on a per-directory or per-virtual server basis. By puttingengine offin the appropriate places in thehttpd.conffile, PHP can be enabled or disabled.
error_logstring
Name of file where script errors should be logged. If the special valuesyslogis used, the errors are sent to the system logger instead. On UNIX, this means syslog(3) and on Windows NT it means the event log. The system logger is not supported on Windows 95.
error_reportinginteger
Set the error reporting level. The parameter is an integer representing a bit field. Add the values of the error reporting levels you want.
Table 3-1. Error Reporting Levels
bit value enabled reporting
1 normal errors
2 normal warnings
4 parser errors
8 non-critical style-related warnings
The default value for this directive is 7 (normal errors, normal warnings and parser errors are shown).
open_basedirstring
Limit the files that can be opened by PHP to the specified directory-tree.
When a script tries to open a file with, for example, fopen or gzopen, the location of the file is checked. When the file is outside the specified directory-tree, PHP will refuse to open it. All symbolic links are resolved, so it’s not possible to avoid this restriction with a symlink.
The special value . indicates that the directory in which the script is stored will be used as base-directory.
Under Windows, separate the directories with a semicolon. On all other systems, separate the directories with a colon.
As an Apache module, open_basedir paths from parent directories are now automatically inherited.
Note: Support for multiple directories was added in 3.0.7.
The default is to allow all files to be opened.
gpc_orderstring
Set the order of GET/POST/COOKIE variable parsing. The default setting of this directive is "GPC". Setting this to
"GP", for example, will cause PHP to completely ignore cookies and to overwrite any GET method variables with POST-method variables of the same name.
ignore_user_abortstring
On by default. If changed to Off scripts will be terminated as soon as they try to output something after a client has aborted their connection. ignore_user_abort().
include_pathstring
Specifies a list of directories where the require(), include() and fopen_with_path() functions look for files. The format is like the system’s PATH environment variable: a list of directories separated with a colon in UNIX or semicolon in Windows.
Example 3-1. UNIX include_path
include_path=.:/home/httpd/php-lib Example 3-2. Windows include_path
include_path=".;c:\www\phplib"
The default value for this directive is.(only the current directory).
isapi_extstring
log_errorsboolean
Tells whether script error messages should be logged to the server’s error log. This option is thus server-specific.
magic_quotes_gpcboolean
Sets the magic_quotes state for GPC (Get/Post/Cookie) operations. When magic_quotes are on, all ’ (single-quote), "
(double quote), \ (backslash) and NUL’s are escaped with a backslash automatically. If magic_quotes_sybase is also on, a single-quote is escaped with a single-quote instead of a backslash.
magic_quotes_runtimeboolean
Ifmagic_quotes_runtimeis enabled, most functions that return data from any sort of external source including databases and text files will have quotes escaped with a backslash. Ifmagic_quotes_sybaseis also on, a single-quote is escaped with a single-quote instead of a backslash.
magic_quotes_sybaseboolean
Ifmagic_quotes_sybaseis also on, a single-quote is escaped with a single-quote instead of a backslash if magic_quotes_gpcormagic_quotes_runtimeis enabled.
max_execution_timeinteger
This sets the maximum time in seconds a script is allowed to take before it is terminated by the parser. This helps prevent poorly written scripts from tying up the server. The default setting is30.
Chapter 3. Configuration
memory_limitinteger
This sets the maximum amount of memory in bytes that a script is allowed to allocate. This helps prevent poorly written scripts for eating up all available memory on a server.
nsapi_extstring
register_globalsboolean
Tells whether or not to register the EGPCS (Environment, GET, POST, Cookie, Server) variables as global variables.
You may want to turn this off if you don’t want to clutter your scripts’ global scope with user data. This makes the most sense when coupled withtrack_vars- in which case you can access all of the EGPCS variables through the
$HTTP_ENV_VARS,$HTTP_GET_VARS,$HTTP_POST_VARS,$HTTP_COOKIE_VARS, and$HTTP_SERVER_VARS arrays in the global scope.
short_open_tagboolean
Tells whether the short form (<? ?>of PHP’s open tag should be allowed. If you want to use PHP in combination with XML, you have to disable this option. If disabled, you must use the long form of the open tag (<?php ?>).
sql.safe_modeboolean
track_errorsboolean
If enabled, the last error message will always be present in the global variable $php_errormsg.
track_varsboolean
If enabled, then Environment, GET, POST, Cookie, and Server variables can be found in the global associative arrays
$HTTP_ENV_VARS,$HTTP_GET_VARS,$HTTP_POST_VARS,$HTTP_COOKIE_VARS, and$HTTP_SERVER_VARS. Note that as of PHP 4.0.3, track_vars is always turned on.
upload_tmp_dirstring
The temporary directory used for storing files when doing file upload. Must be writable by whatever user PHP is running as.
user_dirstring
The base name of the directory used on a user’s home directory for PHP files, for examplepublic_html. warn_plus_overloadingboolean
If enabled, this option makes PHP output a warning when the plus (+) operator is used on strings. This is to make it easier to find scripts that need to be rewritten to using the string concatenator instead (.).