Readline callback handler remove: примеры (PHP)

Простые примеры использования

В этом примере устанавливается, а затем немедленно удаляется обработчик ввода.

<?
readline_callback_handler_install('Введите что-нибудь: ', function($input) {
    echo "Вы ввели: $input";
});

$result = readline_callback_handler_remove();
var_dump($result);
?>

bool(true)

При вызове функции без предварительной установки обработчика возвращается false.

<?
$result = readline_callback_handler_remove();
var_dump($result);
?>

bool(false)

Похожие функции в PHP

Функция readline() является стандартным способом для синхронного чтения строки из консоли. Она блокирует выполнение скрипта до получения ввода от пользователя. Используется в простых CLI-скриптах, где не требуется обработка других событий во время ожидания ввода.

Настройка неблокирующего режима для потока STDIN с помощью stream_set_blocking(STDIN, false) позволяет проверять наличие ввода без остановки выполнения программы. Этот метод требует ручного опроса потока и менее удобен для сложных интерактивных сценариев по сравнению с callback-механизмом.

Аналоги в других языках

В Python для асинхронной работы с stdin можно использовать модуль selectors для мониторинга нескольких потоков ввода-вывода.

import sys, selectors
sel = selectors.DefaultSelector()
sel.register(sys.stdin, selectors.EVENT_READ)
print("Ожидание ввода...")
events = sel.select(timeout=5)
if events:
    data = sys.stdin.readline().rstrip()
    print(f"Ввод: {data}")
else:
    print("Таймаут")

В Node.js модуль readline предоставляет интерфейс для чтения потока построчно, поддерживая событийную модель.

const readline = require('readline');
const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout
});
rl.question('Введите текст: ', (answer) => {
  console.log(`Вы ввели: ${answer}`);
  rl.close();
});

В отличие от PHP, где callback-обработчик удаляется явно, в Node.js интерфейс закрывается методом close(). Python и JS используют событийные циклы, которые являются более общей концепцией асинхронного программирования.

Типичные ошибки

Вызов функции до readline_callback_handler_install() приводит к возврату false, но не генерирует исключение. Это может привести к логическим ошибкам, если результат не проверяется.

<?
// Ошибка: попытка удалить несуществующий обработчик
if (!readline_callback_handler_remove()) {
    echo "Обработчик не был установлен.\n";
}
?>

Обработчик не был установлен.

Неучёт возвращаемого значения может скрыть проблему, когда удаление обработчика не произошло.

<?
readline_callback_handler_install('> ', fn($in)=>null);
// ... какой-то код ...
readline_callback_handler_remove(); // Возвращаемое значение игнорируется
?>

Изменения в версиях PHP

В PHP 8.1.0 не было внесено значимых изменений в работу функции readline_callback_handler_remove(). Функция сохраняет стабильное поведение с момента её введения в PHP 5.1.0. Отсутствие изменений подчёркивает её узкоспециализированное назначение.

Расширенные примеры

Пример реализации интерактивного ввода с ограничением по времени с использованием callback-механизма и последующим удалением обработчика.

<?
$input = null;
readline_callback_handler_install('У вас 5 секунд: ', function($data) use (&$input) {
    $input = $data;
});

$start = time();
while (true) {
    $elapsed = time() - $start;
    if ($elapsed >= 5) {
        echo "\nВремя вышло!\n";
        break;
    }
    
    // Обработка событий ввода
    $r = array(STDIN);
    $w = $e = null;
    if (stream_select($r, $w, $e, 0, 10000) > 0) {
        readline_callback_read_char();
    }
    
    if ($input !== null) {
        echo "\nВы успешно ввели: $input\n";
        break;
    }
}

readline_callback_handler_remove();
?>

Сценарий, где обработчик ввода меняется в зависимости от состояния приложения с обязательным удалением предыдущего.

<?
function installHandler1() {
    readline_callback_handler_remove(); // Безопасное удаление старого
    readline_callback_handler_install('Первый вопрос: ', function($answer) {
        echo "Ответ 1: $answer\n";
        installHandler2();
    });
}

function installHandler2() {
    readline_callback_handler_remove();
    readline_callback_handler_install('Второй вопрос: ', function($answer) {
        echo "Ответ 2: $answer\n";
    });
}

installHandler1();
// Эмуляция ввода для примера
fwrite(STDOUT, "ответ1\n");
readline_callback_read_char();
readline_callback_read_char(); // Чтение символов для активации callback
?>