PHP的命令行扩展Readline相关函数的使用

readline 扩展函数实现了访问 GNU Readline 库的接口。这些函数提供了可编辑的命令行。一个例子是在 Bash 中允许你使用箭头按键来插入字符或者翻看历史命令。因为这个库的交互特性,这个功能在你写的 Web 程序中没多大用处,但是当你写的脚本被用在命令行中时非常有用。

Readline 扩展的安装

Readline 扩展已经加入了 PHP 的官方安装包中,如果是新的 PHP 环境,那么在编译的时候加上 --with-readline 即可。另外,我们还需要安装操作系统的 Readline 库。当然,如果已经是正常运行的 PHP ,也可以重新编译一下。

# yum install -y readline-devel # ./congiure xxxx --with-readline

默认情况下,如果没有在编译时增加 --whit-readline ,Readline 的一些函数也是可以使用的,不过它们调用的是系统的 libedit 库。有一些函数,比如 readline_list_history() 这种函数是无法使用的。要想完整的使用 Readline 扩展的能力,那么还是需要安装操作系统的 libreadline 库(上面 yum 安装的那个 readline-devel )并在 PHP 中进行相应参数的编译安装。

基本函数操作

Readline 扩展提供的函数不多,也非常的简单易用。

读取一行

$line = readline("请输入命令:"); // 读取命令行交互信息 echo $line, PHP_EOL; // aaa

运行 PHP 代码后,我们就进入了命令提示符等待状态,并且会提示“请输入命令:”,当我们输入了 aaa 并回车之后,输入的内容就保存到了 $line 变量中。

命令历史列表相关操作

Readline 很强大的一个功能就是它自带一套命令历史记录的功能。不过这个需要我们自己手动地将命令加入到命令历史中。

$line = readline("请输入命令:"); // 读取命令行交互信息 if (!empty($line)) { readline_add_history($line); // 需要手动加入到命令历史记录中 } echo $line, PHP_EOL; // aaa $line = readline("请输入命令:"); if (!empty($line)) { readline_add_history($line); } // 命令历史记录列表 print_r(readline_list_history()); // Array // ( // [0] => aaa // [1] => bbb // )

使用 readline_add_history() 函数,就可以将一条命令加入到命令历史记录中,然后使用 readline_list_history() 就能够打印出我们之前在交互式环境中发送过的命令记录。当然,如果只是这样简单的保存再打印那就没意思了,它还能将这些历史信息保存到外部文件进行存储。

// 将命令历史记录写入到一个文件中 readline_write_history('./readline_history'); // ./readline_history中 // _HiStOrY_V2_ // aaa // bbb // 清理命令历史记录 readline_clear_history(); print_r(readline_list_history()); // Array // ( // ) // 从文件中读取命令历史记录 readline_read_history('./readline_history'); print_r(readline_list_history()); // Array // ( // [0] => bbb // [1] => bbb // )

我们使用 readline_write_history() 函数将当前的命令历史记录保存到一个文件中,然后使用 readline_clear_history() 清理掉目前命令历史记录列表中的内容,这个时候打印 readline_list_history() 的话里面已经没有任何东西了。接着,我们再使用 readline_read_history() 将命令的历史记录从文件中加载回来进行还原。这一套功能是不是就非常有意思了,我们可以记录客户的所有命令操作,不管是安全审查还是事件回放,都非常有用。

查看 Readline 状态

// 当前命令行内部的变量信息 print_r(readline_info()); // Array // ( // [line_buffer] => bbb // [point] => 3 // [end] => 3 // [mark] => 0 // [done] => 1 // [pending_input] => 0 // [prompt] => 请输入命令: // [terminal_name] => xterm-256color // [completion_append_character] => // [completion_suppress_append] => // [library_version] => 7.0 // [readline_name] => other // [attempted_completion_over] => 0 // )

readline_info() 函数就比较简单了,我们可以看到最后一条交互式命令的信息,里面包括了命令输入的内容 line_buffer ,内容长度 point ,提示信息 prompt 等内容。

命令提示效果

在 Linux 等操作系统上,我们想不起一个命令的全拼没关系,只需要记住它的前几个字符然后按两个 Tab 键就可以得到相关的命令提示了。Readline 扩展库当然也为我们准备了这样的功能。

// 类似于命令行中按 Tab 键的提示效果 readline_completion_function(function ($input, $index) { $commands = ['next', 'exit', 'quit']; $matches = []; if ($input) { // 如果关键字包含在命令中,提示命令信息 foreach ($commands as $c) { if (strpos($c, $input) !== false) { $matches[] = $c; } } }else{ $matches = $commands; } return $matches; }); // 使用 Tab 键测试一下吧 $line = trim(readline("请输入命令:")); if (!empty($line)) { readline_add_history($line); } echo $line, PHP_EOL; // 当前输入的命令信息 // 如果命令是 exit 或者 quit ,就退出程序执行 if($line == 'exit' || $line == 'quit'){ exit; }

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/zygjyd.html