php.ini 或 php3.ini 是 PHP 在启动时会读取的配置文件。该文件的存放路径为 /usr/local/lib/。在 PHP 3.x 版的配置文件为 php3.ini;而在 PHP 4.x 版改为 php.ini。若 PHP 安装成服务器的模块,则在 Web 服务器启动执行时会读取,之后就不再读取,因此改动配置的话要重新启动 Web 服务器。若使用独立 PHP CGI 方式,则每次都读一次。
要看目前的系统配置,可以用phpinfo()看到。以下为选项配置
- php_value name value
- 配置变量名称和值。本选项需 PHP 4.x 版之后才能使用。
- php_flag name on|off
- 配置标志布尔变量选项。本选项需 PHP 4.x 版之后才能使用。
- php_admin_value name value
- 配置 Apache 的配置文件变量。原来在 .htaccess 的配置改到这个选项配置。本选项需 PHP 4.x 版之后才能使用。
- php_admin_flag name on|off
- 配置布尔变量当标志。本选项需 PHP 4.x 版之后才能使用。
- asp_tags boolean
- 配置 PHP 程序是否解析以 ASP Script 语法 <% %> 的标记 (tag)。本选项在 PHP 3.0.4 之后才可使用。更多的细节可以参考>嵌入方法的部份。
- auto_append_file string
- 配置本选项可以让指定的文件附加在原 PHP 程序后面自动执行。若 PHP 程序中有用到 exit() 函数,则指定的文件不会执行。参数 string 即为指定自动执行的文件。
- auto_prepend_file string
- 配置本选项可以让指定的文件在原 PHP 程序之前自动执行。参数 string 即为指定自动执行的文件。
- cgi_ext string
- 本选项配置 CGI 程序的扩展名。
- display_errors boolean
- 本选项配置是否要将执行的错误信息显示在用户的浏览器上。
- doc_root string
- 配置服务器的文件及 PHP 文件放置的根目录。
- engine boolean
- 本选项需要使用apache的模块方式使用 PHP。可配置是否要使用 PHP 引擎。在 httpd.conf 中加入 php3_engine on/off 亦可配置某目录或某虚拟网站是否要用 PHP 解析器。
- error_log string
- 本选项用来配置错误记录文件。在 UNIX 系统上参数 string 即为文件名。Windows NT 会将记录记在事件检视器的日志之中。Windows 95/98 则不支持系统记录。
- error_reporting integer
- 本选项用来配置系统记录的等级。参数 integer 即为等级的级数标志,可以加在一起,默认值为 7,见下表
| 级数 | 说明 |
| 1 | 一般的错误 |
| 2 | 一般的警告 |
| 4 | 解析错误 |
| 8 | 非关键的警告 |
- open_basedir string
- 本选项用来配置提供 PHP 存取的最底层目录。从该指定目录之下的文件或目录,PHP 程序才能存取。使用本选项主要是为了系统安全性的考虑。参数 string 即为要限制的最底层目录节点。值得注意的是在 UNIX 系统中,若该节点之下的文件或目录有符号链结 (symbolic link),则可能会让使用本选项的目的打折,因此在目录的设计上考虑,也是 Webmaster 的重要任务。默认值是所有文件均可存取。在 PHP 3.0.7 版之后,可以配置多个底层目录。
- gpc_order string
- 配置 GET/POST/COOKIE 三种模块的顺序及规则。参数 string 即为要配置的规则,例如:配置成 "GP" 表示忽视 cookie,并在存取方法 (method) 相同时,以 POST 取代 GET。
- ignore_user_abort string
- 默认值为 Off。用来配置当传输未完成时,用户端断线是要继续处理。
- include_path string
- 为 PHP 程序中 require、include 及 fopen_with_path 等函数的文件搜寻路径。在 UNIX 或 Windows 中的斜线方向不同。
- log_errors boolean
- 指定程序错误时是否要记录在 log 文件中。
- magic_quotes_gpc boolean
- 配置 GET/POST/COOKIE 三种模块的特殊字符,包含单引号、双引号、反斜线、及空字符 (NUL) 是否要自动加入反斜线当溢出字符。