array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.readline-callback-handler-install.php', 1 => 'readline_callback_handler_install', ), 'up' => array ( 0 => 'ref.readline.php', 1 => 'Функции Readline', ), 'prev' => array ( 0 => 'function.readline-add-history.php', 1 => 'readline_add_history', ), 'next' => array ( 0 => 'function.readline-callback-handler-remove.php', 1 => 'readline_callback_handler_remove', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/readline/functions/readline-callback-handler-install.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
readline_callback_handler_install — Инициализирует callback-интерфейс readline и терминал, печатает строку приглашения и немедленно возвращает управление
Инициализирует callback-интерфейс readline, печатает
prompt
и возвращает управление.
Повторный вызов этой функции без предварительного удаления старого
callback-интерфейса приведёт к автоматической его перезаписи.
Функционал callback-функций особенно удобен в комбинации с stream_select(), поскольку он, в отличие от readline(), позволяет чередовать ввод-вывод и пользовательский ввод.
prompt
Строка приглашения.
callback
Функция передаваемая в параметр callback
должна принимать
один параметр - возвращённый пользовательский ввод.
Возвращает true
в случае успешного выполнения или false
, если возникла ошибка.
Пример #1 Пример использования callback-интерфейса 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)) {
// читаем символ и вызываем callback-функцию,
// если введён символ новой строки
readline_callback_read_char();
}
}
echo "Ввод отключён. Спасибо за внимание.\n";
?>