(PHP 5 >= 5.1.0)

readline_callback_handler_installInitializes the readline callback interface and terminal, prints the prompt and returns immediately


bool readline_callback_handler_install ( string $prompt , callable $callback )

Sets up a readline callback interface then prints prompt and immediately returns. Calling this function twice without removing the previous callback interface will automatically and conveniently overwrite the old interface.

The callback feature is useful when combined with stream_select() as it allows interleaving of IO and user input, unlike readline().

Список параметров


The prompt message.


The callback function takes one parameter; the user input returned.

Возвращаемые значения

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.


Пример #1 Readline Callback Interface Example

function rl_callback($ret)

"You entered: $retn";

    if (
$c 10) {
$prompting false;
    } else {
readline_callback_handler_install("[$c] Enter something: "'rl_callback');

$c 1;
$prompting true;

readline_callback_handler_install("[$c] Enter something: "'rl_callback');

while (
$prompting) {
$w NULL;
$e NULL;
$n stream_select($r = array(STDIN), $w$enull);
    if (
$n && in_array(STDIN$r)) {
// read a character, will call the callback when a newline is entered

"Prompting disabled. All done.n";

Смотрите также

  • readline_callback_handler_remove() - Removes a previously installed callback handler and restores terminal settings
  • readline_callback_read_char() - Reads a character and informs the readline callback interface when a line is received
  • stream_select() - Запускает эквивалент системного вызова select() на заданных массивах потоков с таймаутом, указанным параметрами tv_sec и tv_usec