PHP: полный мануал с примерами, функциями и ООП

Зачем нужен диалог с процессом через PTY

У старой локальной складской программы нет API: она печатает «SKU?», ждёт введённый артикул и отвечает «STOCK 7». Простая команда exec с готовой строкой не описывает весь такой диалог. Expect даёт программе псевдотерминал (PTY) и позволяет ждать определённый текст перед отправкой следующего ответа. Польза — автоматизация известного интерактивного протокола там, где действительно нет удобного программного интерфейса.

PTY — пара концов виртуального терминала. Дочерняя программа воспринимает свою сторону как терминал; родитель читает вывод и отправляет ввод. Это отличается от HTTP запроса и обычного файла: возможны эхо ввода, переводы строк CRLF, управляющие последовательности и приглашение без завершающего . «Ждать две секунды через sleep» не означает дождаться приглашения; нужен условный переход по фактическому выводу.

<?php
declare(strict_types=1);

$output = 'SKU? ';
$state = $output === 'SKU? ' ? 'send_sku' : 'unexpected';
if ($state === 'send_sku') echo "Следующий шаг: отправить A42 и перевод строки\n";

Следующий шаг: отправить A42 и перевод строки

Требования, установка и честная граница PHP8

Статус версии. Полный раздел сохраняет API из официального Manual, включая наследуемые расширения. На проверенной странице PECL последний опубликованный stable Expect — 0.4.0 от 13 января 2020 года; его metadata задаёт PHP не выше 7.99.99. Поэтому наличие страницы в Manual PHP8 не доказывает готовность этой версии расширения для PHP8.5.11. Здесь не предлагается понижать рабочий сайт до PHP7 и не заявляется, что пакет проверен на PHP8. Примеры служат для чтения/сопровождения существующих совместимых установок и изолированного стенда.

Расширение не входит в штатный PHP. Официальные требования: libexpect не ниже 5.43.0 и Tcl; при сборке нужны соответствующие development headers и совпадающие версии phpize/php-config/PHP ABI. Историческая configure опция — --with-expect[=DIR]. Установленный бинарник expect или libexpect.so сам по себе не добавляет PHP функцию expect_popen. PHP модуль загружается в ini конкретного SAPI. Официальная инструкция упоминает php_expect.dll, но готовый Windows DLL пакет там недоступен: это не рабочий шаг «включите отсутствующий файл».

<?php
declare(strict_types=1);

echo 'Модуль: ', extension_loaded('expect') ? 'есть' : 'нет', "\n";
echo 'Функция: ', function_exists('expect_popen') ? 'есть' : 'нет', "\n";
echo 'Wrapper: ', in_array('expect', stream_get_wrappers(), true) ? 'есть' : 'нет', "\n";

Три строки с фактической доступностью модуля, функции и wrapper.

expect_popen возвращает stream resource. Он передаётся в expect_expectl, fwrite и fclose; у этой книги нет новых классов PHP8 вместо него. Для проекта на современном PHP сначала ищите API, batch/JSON режим нужной программы, затем управляемый запуск через функции запуска процессов. Если интерфейс действительно только терминальный, выбирайте поддерживаемую реализацию PTY/Expect как отдельный проверяемый компонент, с ограниченным временем и правами.

Все настройки: время, буфер и журналирование

В учебном диалоге ставим timeout2, loguser0, logfile пусто. Это предотвращает смешивание терминального вывода с нашим отчётом. Обработка timeout обязательна даже при ограничении в настройке. Для долгого job добавьте отдельный общий deadline и политику остановки дочернего процесса: новый expect вызов снова может ждать свой timeout. loguser0 не отключает logfile; не записывайте пароли/токены в терминальный transcript.

<?php
declare(strict_types=1);

if (!extension_loaded('expect')) throw new RuntimeException('Модуль не загружен');
foreach (['expect.timeout' => '2', 'expect.loguser' => '0', 'expect.logfile' => '', 'expect.match_max' => '4096'] as $key => $value) {
    if (ini_set($key, $value) === false) throw new RuntimeException('Не изменена настройка ' . $key);
}
echo "Ожидание ограничено, transcript отключён\n";

Ожидание ограничено, transcript отключён

Полностью представленный локальный собеседник

Для примеров создаём только собственную учебную программу. Она не авторизуется на сервере, не меняет файлы и не выполняет присланные команды. Через три секунды без ввода она завершится с NO_INPUT, чтобы ошибочный тест не удерживал процесс бесконечно. Сам Expect тоже ограничен timeout2.

<?php
fwrite(STDOUT, 'SKU? ');
fflush(STDOUT);
$read = [STDIN]; $write = []; $except = [];
$ready = stream_select($read, $write, $except, 3);
if ($ready !== 1) { fwrite(STDOUT, "NO_INPUT\n"); exit(2); }
$line = fgets(STDIN);
if ($line === false) { fwrite(STDOUT, "NO_INPUT\n"); exit(2); }
$sku = trim($line);
fwrite(STDOUT, $sku === 'A42' ? "STOCK 7\n" : "UNKNOWN\n");

После ввода A42: STOCK 7; другой артикул: UNKNOWN; без ввода до трёх секунд: NO_INPUT.

Команда строится из фиксированного PHP_BINARY и известного пути к этому файлу. На Unix каждый аргумент экранируется escapeshellarg, потому что expect_popen выполняет строку через Bourne shell. Не подставляйте целую команду из $_GET/$_POST. Даже корректное quoting не заменяет ограничение разрешённых действий: пользовательский выбор должен отображаться на заранее известную команду, а не на произвольный исполняемый файл.

Шаблоны, метки, выходные группы и все константы

Один вызов ожидания получает список вариантов. Каждый вариант — массив из шаблона, возвращаемой метки и необязательного вида шаблона. Массив cases делайте плотным списком 0,1,2…; если отфильтровали, примените array_values. Используйте уникальные строковые метки, которые не спутать с числовыми кодами EOF/timeout. Успех совпадения не означает успех всей бизнес-операции: «SKU?» только разрешает отправить артикул.

Случаи завершения проверяются явно и сравниваются строго. Не пишите if ($result): метка может быть 0 или пустой строкой, а отрицательный служебный код тоже truthy. Перекрывающиеся шаблоны делают поведение хрупким; держите набор подходящим текущему состоянию. match[0] — совпавший фрагмент, не весь transcript; группы regex находятся в match[1]…match[9] с ограничением libexpect.

expect://: файловая оболочка вокруг процесса

Альтернативный вход — fopen("expect://command", "r"). Это всё равно запуск команды через PTY, а не чтение удалённого URL. Wrapper не включён без расширения и не ограничивается allow_url_fopen. Поэтому выключение одной ini директивы не делает непроверенный путь пользователя безопасным.

<?php
declare(strict_types=1);

if (!in_array('expect', stream_get_wrappers(), true)) throw new RuntimeException('Нет wrapper');
ini_set('expect.loguser', '0');
ini_set('expect.timeout', '2');
$stream = fopen("expect://printf 'READY\\n'", 'r');
if ($stream === false) throw new RuntimeException('Не открыт PTY');
try {
    $state = expect_expectl($stream, [['READY', 'ready', EXP_EXACT]]);
    if ($state !== 'ready') throw new RuntimeException('Не получен READY');
    echo "Учебная программа готова\n";
} finally { fclose($stream); }

Учебная программа готова

Ошибки диалога, безопасность и современные альтернативы

Для старого SSH/SCP диалога меняются приглашения, локаль, баннер, prompt, host verification и права пользователя сервера. Надёжный код моделирует ограниченное число переходов, обрабатывает отказ аутентификации/неизвестное состояние и прекращает действие. Нельзя автоматически отвечать yes на неизвестный SSH host key ради прохождения примера: доверие проверяется заранее. Для передачи файлов предпочтителен программный SFTP/SSH клиент с проверкой сервера; для новой утилиты — аргументы или JSON stdin вместо автоматизации меню.

Стоимость определяется блокирующим ожиданием, числом переходов, объёмом вывода и сложностью шаблонов. Не держите HTTP worker минутами ради интерактивного меню. Для фоновой задачи храните job ID/состояние отдельно и запускайте управляемый процесс под минимальными правами. Для больших выгрузок терминальный интерфейс особенно неудобен: структурированный API обычно легче ограничить по объёму, протестировать и обработать после отказа.

Развить пример и выбрать подходящий интерфейс

Задание 1: отправьте B17 вместо A42. Решение: обрабатывайте UNKNOWN отдельной меткой, а не как timeout. Задание 2: замените приглашение на «Артикул?». Решение: обновить согласованный протокол или точный шаблон; ожидание старого SKU? будет ошибкой. Задание 3: дочерний процесс выводит STOCK 12. Решение: EXP_REGEXP извлечёт группу 12; проверка бизнес-диапазона остаётся в приложении. Задание 4: прекратите ввод. Решение: EXP_TIMEOUT и NO_INPUT означают разные события родителя и ребёнка; общего успешного результата нет.

Полный официальный раздел включён, но исторический пакет не становится современным от переписывания примера. Для нового проекта сначала оцените exec/proc_open и передачу данных другой программе, HTTP API и sockets. Для чтения терминального кода пригодятся состояния и ветвления, различие синтаксисов шаблонов и владение потоками.