readline_callback_handler_install

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

readline_callback_handler_install — 初始化 readline 回调接口和终端，打印提示符并立即返回

描述

readline_callback_handler_install(string $prompt, callable $callback): true

设置 readline 回调接口，然后打印prompt并立即返回。在移除之前的回调接口之前两次调用此函数将自动且方便地覆盖旧接口。

当与stream_select()结合使用时，回调功能非常有用，因为它允许交错 I/O 和用户输入，这与readline()不同。

参数

prompt: 提示消息。
callback: callback函数接受一个参数；返回的用户输入。

返回值

始终返回 true。

示例

示例 #1 Readline 回调接口示例

<?php
function rl_callback($ret)
{
 global $c, $prompting;

 echo "您输入了： $ret\n";
 $c++;

 if ($c > 10) {
 $prompting = false;
 readline_callback_handler_remove();
 } else {
 readline_callback_handler_install("[$c] 输入内容： ", 'rl_callback');
 }
}

$c = 1;
$prompting = true;

readline_callback_handler_install("[$c] 输入内容： ", 'rl_callback');

while ($prompting) {
 $w = NULL;
 $e = NULL;
 $n = stream_select($r = array(STDIN), $w, $e, null);
 if ($n && in_array(STDIN, $r)) {
 // 读取一个字符，输入换行符时将调用回调函数
 readline_callback_read_char();
 }
}

echo "提示已禁用。全部完成。\n";
?>

参见

readline_callback_handler_remove() - 移除之前安装的回调处理程序并恢复终端设置
readline_callback_read_char() - 读取一个字符并在接收一行时通知 readline 回调接口
stream_select() - 在给定的流数组上运行等效于 select() 系统调用的操作，超时时间由秒和微秒指定

发现问题？

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加备注

用户贡献的备注 1 条备注

踩

thflori ¶

6 年前

要逐字节读取多行，您可以检查 readline_info 中的 line_buffer

<?php

function read(int $count, string $prompt = null): string
{
 $previous = '';
 readline_callback_handler_install($prompt ?? " \e[D", function ($str) use (&$previous) {
 $previous .= $str . PHP_EOL;
 });
 do {
 $r = array(STDIN);
 $n = stream_select($r, $w, $e, null);
 if ($n && in_array(STDIN, $r)) {
 readline_callback_read_char();
 $str = $previous . readline_info('line_buffer');
 }
 } while (mb_strlen($str) < $count); // 如果需要确切的字节数，请使用 strlen
 readline_callback_handler_remove();

 return $str;
}