(PHP 4, PHP 5, PHP 7, PHP 8)
popen — Открывает файловый указатель процесса
Открывает поток к процессу, выполняемый при помощи форка
команды, заданной в параметре command.
commandКоманда
mode
Режим. Либо 'r' для чтения, либо 'w' для записи.
В Windows для popen() по умолчанию используется текстовый режим, т.е. любые символы \n,
записанные в канал или прочитанные из него, будут преобразованы в \r\n.
Если это нежелательно, можно принудительно использовать двоичный режим, установив для mode
значение 'rb' и 'wb' соответственно.
Возвращает файловый указатель, идентичный возвращаемому функцией fopen(), за исключением того, что он односторонний (может быть использован только для чтения или записи) и должен быть закрыт при помощи pclose(). Этот указатель может быть использован с fgets(), fgetss() и fwrite(). Если в качестве режима указано 'r', файловый указатель аналогичен потоку вывода (STDOUT) команды, если же указано 'w', то файловый указатель аналогичен потоку ввода (STDIN) команды.
В случае возникновения ошибки возвращает false.
Пример #1 Пример использования функции popen()
<?php
$handle = popen("/bin/ls", "r");
?>Если команда для выполнения не может быть найдена, будет возвращён корректный ресурс. Это может выглядеть странно, но имеет смысл; это даёт вам возможность получить доступ к любому сообщению об ошибке, которое вернёт оболочка:
Пример #2 Пример использования функции popen()
<?php
error_reporting(E_ALL);
/* Добавляем перенаправление, чтобы прочитать stderr. */
$handle = popen('/path/to/executable 2>&1', 'r');
echo "'$handle'; " . gettype($handle) . "\n";
$read = fread($handle, 2096);
echo $read;
pclose($handle);
?>Замечание:
Если вам нужна двухсторонняя передача (в обе стороны одновременно), используйте proc_open().