学步园

交互式运行 PHP。如果编译 PHp时加入了
Readline 扩展（Windows 下不可用），那将会得到一个很好的外壳，包括一个自动完成的功能（例如可以在键入变量名的时候，按下 TAB 键，PHp会自动完成该变量名）以及命令历史记录，可以用上下键来访问。历史记录存在
~/.php_history 文件中。

Note:

通过 auto_ppend_file 和
auto_append_file包含的文件在此模式下会被解析，但有些限制，例如函数必须在被调用之前定义。

用该参数，可以指定一个放置 php.ini文件的目录，或者直接指定一个自定义的 INI文件（其文件名可以不是
php.ini），例如：

如果不指定此选项，PHp将在默认位置搜索文件。

完全忽略 php.ini。此参数在 PHp4.3.0 以后有效。

用该参数可以自行设置任何可以在 php.ini文件中设置的配置选项的值，其语法为：

例子（因版面原因而折行显示）：

激活扩展信息模式，被用于调试／测试。

解析并运行 -f选项给定的文件名。该参数为可选参数，可以省略，仅指明需要运行的文件名即可。

该参数提供了对指定 PHp代码进行语法检查的方便的方法。如果成功，则向标准输出写入 No syntax errors detected in <filename>字符串，并且外壳返回值为
0。如果失败，则输出 Errors parsing <filename>以及内部解析器错误信息到标准输出，同时外壳返回值将别设置为
255。

该参数将无法检查致命错误（如未定义函数），如果也希望检测致命错误，请使用 -f参数。

Note:

该参数不能和 -r一同使用。

使用该参数，PHp将打印出内置以及已加载的 PHp及 Zend 模块：

使用该参数可以在命令行内运行单行 PHp代码。无需加上 PHp的起始和结束标识符（<?php 和
?>），否则将会导致语法解析错误。

Note:

使用这种形式的 PHp时，应注意避免和外壳环境进行的命令行参数替换相冲突。

显示语法解析错误的范例

$ php-r "$foo = get_defined_constants();" Command line code(1) : Parse error - parse error, unexpected '='

这里的问题在于即使使用了双引号 "，sh/bash 仍然实行了参数替换。由于 $foo没有被定义，被替换后它所在的位置变成了空字符，因此在运行时，实际被 PHp读取的代码为：

$ php-r " = get_defined_constants();"

正确的方法是使用单引号 '。在用单引号引用的字符串中，变量不会被 sh/bash 还原成其原值。

$ php-r '$foo = get_defined_constants(); var_dump($foo);' array(370) { ["E_ERROR"]=> int(1) ["E_WARNING"]=> int(2) ["E_PARSE"]=> int(4) ["E_NOTICE"]=> int(8) ["E_CORE_ERROR"]=> [...]

如果使用的外壳不是 sh/bash，可能会碰到更多问题。请将碰到的 Bug 向
» http://bugs.php.net/报告。注意，当试图将 shell 变量用到代码中或者使用反斜线时仍然很容易碰到问题。

Note:

-r在 CLI SAPI 中有效，在
CGI SAPI 中无效。

Note:

此选项只用于非常基本的用途。因此一些配置指令（例如
auto_ppend_file 和
auto_append_file）在此模式下被忽略。

在处理 stdin 之前先执行 PHp代码。PHp5 新加。

对每个输入行都执行 PHp代码。PHp5 新加。

此模式下有两个特殊变量：$argn和
$argi。$argn包含 PHp当前处理的行内容，而
$argi 则包含该行号。

对每个输入行都执行 PHp文件。PHp5 新加。

在处理完输入后执行的 PHp代码。PHp5 新加。

使用 -B，-R和
-E选项来计算一个项目总行数的例子。

显示有语法高亮色彩的源代码。

该参数使用内建机制来解析文件并为其生成一个 HTML高亮版本并将结果写到标准输出。请注意该过程所做的只是生成了一个 <code> [...] </code> 的
HTML 标记的块，并不包含任何的 HTML 头。

Note:

该选项不能和 -r参数同时使用。

将 PHP，PHpSAPI 和 Zend 的版本信息写入标准输出。例如：

显示除去了注释和多余空白的源代码。

Note:

该选项不能和 -r参数同时使用。

加载 Zend 扩展库。如果仅给定一个文件名，PHp将试图从当前系统扩展库的默认路径（在 Linux 系统下，该路径通常由
/etc/ld.so.conf指定）加载该扩展库。如果用一个绝对路径指定文件名，则不会使用系统的扩展库默认路径。如果用相对路径指定的文件名，则 PHp仅试图在当前目录的相对目录加载扩展库。