交互式 shell

如果 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.pagercli.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 配置支持一些转义字符:

cli.prompt 转义字符
字符 描述
\e 用于添加提示符颜色。一个例子是 \e[032m\v \e[031m\b \e[34m\> \e[0m
\v PHP 版本。
\b 指明 PHP 所在的块。例如 /* 表示在多行注释中。外部作用域用 php 来表示。
\> 指明提示字符。默认是 >,但当 shell 位于未结束的块或者字符串时会发生变化。可能的字符有 ' " { ( >

注意:

在该模式下,通过 auto_prepend_fileauto_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 会失败。

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top