交互式 shell

    如果 PHP 使用 --with-readline 选项编译，则 CLISAPI 使用 -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 文件。

    CLISAPI 提供了 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 配置支持一些转义字符：

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

    注意:

    在该模式下，通过 auto_prepend_file 和 auto_append_file 解析加载的文件会有一些限制 —— 例如函数必须在调用前定义。

    交互模式

    如果 readline 扩展不可用，在 PHP 8.1.0 之前，使用 -a 选项调用 CLISAPI 会提供交互模式。 在此模式中，一个完整的 PHP 脚本应该通过 STDIN 给出，并用 CRTL+d （POSIX） 或者 CTRL+z 终止然后 ENTER （Windows），脚本执行。这与不加 -a 选项调用 CLISAPI 基本相同。

    自 PHP 8.1.0 起，如果 readline 扩展不可用，使用 -a 调用 CLISAPI 会失败。

    To Top