如果 PHP 使用 --with-readline 选项编译,则 CLI SAPI 使用 -a 选项时会提供交互式 shell。自 PHP 7.1.0 起,如果启用了 readline 扩展 ,交互式 shell 也可以在 Windows 上使用。
使用交互式 shell,你可以输入 PHP 代码并直接执行。
示例 #1 使用交互式 shell 执行代码
$ php -a Interactive shell php > echo 5+8; 13 php > function addTwo($n) php > { php { return $n + 2; php { } php > var_dump(addtwo(2)); int(4) php >
交互式 shell 还有对函数、常量、类名、变量、静态方法调用和类常量的 Tab 键补全功能。
示例 #2 Tab 键补全
当可能有多个补全时,按两次 Tab 键将会得到补全列表:
php > strp[TAB][TAB] strpbrk strpos strptime php > strp
当仅可能有一个补全,按一次 Tab 键即可在同一行中补全剩余:
php > strpt[TAB]ime(
补全也适用于当前交互式 shell 会话期间定义的名称:
php > $fooThisIsAReallyLongVariableName = 42; php > $foo[TAB]ThisIsAReallyLongVariableName
交互式 shell 会存储你的操作历史记录,可以通过上下键访问。历史记录存储于 ~/.php_history 文件。
CLI SAPI 提供了 cli.pager
和
cli.prompt
两个 php.ini 配置。cli.pager
配置允许外部程序(例如 less)充当分页器输出而不是直接在屏幕上显示。
cli.prompt
配置可以更改 php >
提示符。
在交互式 shell 中还可以使用缩写符号设置 php.ini 配置。
示例 #3 在交互式 shell 中设置 php.ini 配置
cli.prompt
配置:
php > #cli.prompt=hello world :> hello world :>
使用反引号可以在提示中执行 PHP 代码:
php > #cli.prompt=`echo date('H:i:s');` php > 15:49:35 php > echo 'hi'; hi 15:49:43 php > sleep(2); 15:49:45 php >
设置分页器为 less:
php > #cli.pager=less php > phpinfo(); (output displayed in less) php >
cli.prompt
配置支持一些转义字符:
字符 | 描述 |
---|---|
\e |
用于添加提示符颜色。一个例子是 \e[032m\v \e[031m\b \e[34m\> \e[0m
|
\v |
PHP 版本。 |
\b |
指明 PHP 所在的块。例如 /* 表示在多行注释中。外部作用域用 php 来表示。
|
\> |
指明提示字符。默认是 > ,但当 shell 位于未结束的块或者字符串时会发生变化。可能的字符有
' " { ( >
|
注意:
在该模式下,通过 auto_prepend_file 和 auto_append_file 解析加载的文件会有一些限制 —— 例如函数必须在调用前定义。
如果 readline 扩展不可用,在 PHP 8.1.0 之前,使用 -a 选项调用 CLI SAPI 会提供交互模式。
在此模式中,一个完整的 PHP 脚本应该通过 STDIN 给出,并用 CRTL+d
(POSIX) 或者 CTRL+z
终止然后 ENTER
(Windows),脚本执行。这与不加 -a 选项调用 CLI SAPI 基本相同。
自 PHP 8.1.0 起,如果 readline 扩展不可用,使用 -a 调用 CLI SAPI 会失败。