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

<?php
$status = connection_status();
echo $status === CONNECTION_NORMAL ? "normal\n" : "other\n";
echo connection_aborted() === 0 ? "connected\n" : "aborted\n";

normal
connected

CLI-процесс не обслуживает браузерное соединение, поэтому это только минимальная проверка типов и исходного состояния. Настоящий disconnect проверяется отдельным локальным HTTP-опытом.

<?php
// endpoint.php — только для отдельного localhost-теста.
ignore_user_abort(true);
while (ob_get_level() > 0) { ob_end_flush(); }
header('Content-Type: text/plain');
for ($part = 1; $part <= 200; $part++) {
    echo str_repeat('x', 65536);
    flush();
    if (connection_aborted()) {
        file_put_contents(__DIR__ . '/observed.txt',
            connection_status() . "\n", LOCK_EX);
        break;
    }
    usleep(10000);
}

Запускайте файл отдельным php -S на 127.0.0.1, подключайте локальный сокет, прочитайте начало ответа и закройте клиент. Проверенная harness-процедура хранится в evidence/misc-connection-http-test.py. Буферы, веб-сервер и прокси влияют на момент обнаружения; это фрагмент, а не обещание боевого SAPI.

<?php
function connectionLabels(int $status): array
{
    $labels = [];
    if (($status & CONNECTION_ABORTED) !== 0) { $labels[] = 'aborted'; }
    if (($status & CONNECTION_TIMEOUT) !== 0) { $labels[] = 'timeout'; }
    return $labels === [] ? ['normal'] : $labels;
}
foreach ([CONNECTION_NORMAL, CONNECTION_ABORTED,
          CONNECTION_ABORTED | CONNECTION_TIMEOUT] as $status) {
    echo implode('+', connectionLabels($status)), "\n";
}

normal
aborted
aborted+timeout

CONNECTION_NORMAL равен нулю, а остальные состояния — биты. Проверка status === CONNECTION_ABORTED потеряла бы второй признак в комбинированном состоянии.

<?php
// endpoint.php — только для отдельного localhost-теста.
ignore_user_abort(true);
while (ob_get_level() > 0) { ob_end_flush(); }
header('Content-Type: text/plain');
for ($part = 1; $part <= 200; $part++) {
    echo str_repeat('x', 65536);
    flush();
    if (connection_aborted()) {
        file_put_contents(__DIR__ . '/observed.txt',
            connection_status() . "\n", LOCK_EX);
        break;
    }
    usleep(10000);
}

Запускайте файл отдельным php -S на 127.0.0.1, подключайте локальный сокет, прочитайте начало ответа и закройте клиент. Проверенная harness-процедура хранится в evidence/misc-connection-http-test.py. Буферы, веб-сервер и прокси влияют на момент обнаружения; это фрагмент, а не обещание боевого SAPI.

<?php
$process = proc_open([PHP_BINARY, '-n', __DIR__ . '/child.php'],
    [0 => ['file', 'NUL', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
    $pipes, __DIR__);
if (!is_resource($process)) { throw new RuntimeException('child'); }
$stdout = stream_get_contents($pipes[1]); fclose($pipes[1]);
$stderr = stream_get_contents($pipes[2]); fclose($pipes[2]);
$status = proc_close($process);
echo 'stdout=', $stdout, "\nstatus=", $status, "\nstderr=", $stderr;

stdout=maintenance
status=0
stderr=

Дочерний CLI завершился сам. Строка — сообщение в stdout; это не ненулевой код ошибки. Для CLI-автоматизации чаще пишут диагностику в STDERR и передают целый код.

<?php
$process = proc_open([PHP_BINARY, '-n', __DIR__ . '/child.php'],
    [0 => ['file', 'NUL', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
    $pipes, __DIR__);
if (!is_resource($process)) { throw new RuntimeException('child'); }
$stdout = stream_get_contents($pipes[1]); fclose($pipes[1]);
$stderr = stream_get_contents($pipes[2]); fclose($pipes[2]);
$status = proc_close($process);
echo $stdout, 'status=', $status, "\n", 'stderr=', $stderr;

before
shutdown
status=4
stderr=

exit(status: 4) — именованный аргумент, доступный с PHP 8.4. Shutdown-функция выполняется, строка finally отсутствует: exit не проходит через этот блок.

<?php
$process = proc_open([PHP_BINARY, '-n', __DIR__ . '/child.php'],
    [0 => ['file', 'NUL', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
    $pipes, __DIR__);
if (!is_resource($process)) { throw new RuntimeException('child'); }
$out = stream_get_contents($pipes[1]); fclose($pipes[1]);
$err = stream_get_contents($pipes[2]); fclose($pipes[2]);
$code = proc_close($process);
echo $out, "|", $code, "|", $err;

denied|0|

Переменная $stop содержит имя alias. Строковый status печатается, поэтому код процесса остаётся 0.

<?php
$process = proc_open([PHP_BINARY, '-n', __DIR__ . '/child.php'],
    [0 => ['file', 'NUL', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
    $pipes, __DIR__);
if (!is_resource($process)) { throw new RuntimeException('child'); }
$out = stream_get_contents($pipes[1]); fclose($pipes[1]);
$err = stream_get_contents($pipes[2]); fclose($pipes[2]);
$code = proc_close($process);
echo 'empty=', $out === '' ? 'yes' : 'no', "\ncode=", $code, "\n";

empty=yes
code=3

die(3) ничего не печатает и завершает только дочерний процесс с кодом 3. Родитель может принять решение по коду.

<?php
function totalWithInternalRule(int $price): int
{
    $result = eval('return $price * 2;');
    if (!is_int($result)) { throw new RuntimeException('rule'); }
    return $result;
}
echo totalWithInternalRule(75), "\n";

150

Строка кода записана разработчиком и не приходит от пользователя. return завершает только eval и отдаёт 150 в $result. Пример показывает механику, а не рекомендацию строить правила строками.

<?php
try {
    eval('return 1 + ;');
} catch (ParseError $error) {
    echo "invalid internal code\n";
}
$rules = [
    'double' => static fn (int $value): int => $value * 2,
    'vat20' => static fn (int $value): int => intdiv($value * 120, 100),
];
echo $rules['vat20'](500), "\n";

invalid internal code
600

ParseError перехватывается с PHP 7. Таблица известных callable решает обычную задачу выбора правила без исполнения произвольного текста и допускает статический анализ.

<?php
$before = ignore_user_abort();
$returned = ignore_user_abort(true);
echo $returned === $before ? "previous returned\n" : "mismatch\n";
echo ignore_user_abort() === 1 ? "enabled\n" : "disabled\n";
ignore_user_abort((bool) $before);
echo ignore_user_abort() === $before ? "restored\n" : "not restored\n";

previous returned
enabled
restored

Вызов с аргументом возвращает предыдущее состояние, а не новое. После опыта исходная настройка восстановлена.

<?php
// endpoint.php — только для отдельного localhost-теста.
ignore_user_abort(true);
while (ob_get_level() > 0) { ob_end_flush(); }
header('Content-Type: text/plain');
for ($part = 1; $part <= 200; $part++) {
    echo str_repeat('x', 65536);
    flush();
    if (connection_aborted()) {
        file_put_contents(__DIR__ . '/observed.txt',
            connection_status() . "\n", LOCK_EX);
        break;
    }
    usleep(10000);
}

Запускайте файл отдельным php -S на 127.0.0.1, подключайте локальный сокет, прочитайте начало ответа и закройте клиент. Проверенная harness-процедура хранится в evidence/misc-connection-http-test.py. Буферы, веб-сервер и прокси влияют на момент обнаружения; это фрагмент, а не обещание боевого SAPI.

<?php
if (!function_exists('sys_getloadavg')) {
    echo "not available on this Windows runtime\n";
} else {
    $load = sys_getloadavg();
    echo is_array($load) && count($load) === 3 ? "three samples\n" : "unavailable\n";
}

not available on this Windows runtime

PHP 8.5.11 для Windows не определяет функцию. function_exists проверяет реальную сборку; это честный платформенный результат, а не имитация Unix.

<?php
if (!function_exists('sys_getloadavg')) {
    throw new RuntimeException('Нужна Unix-платформа с sys_getloadavg');
}
$load = sys_getloadavg();
if (!is_array($load) || count($load) !== 3) {
    throw new RuntimeException('Метрика недоступна');
}
[$one, $five, $fifteen] = $load;
printf("1m=%.2f 5m=%.2f 15m=%.2f\n", $one, $five, $fifteen);
$workers = 4;
echo $one > $workers * 2 ? "defer optional job\n" : "capacity policy allows check\n";

Вывод зависит от Unix-хоста, поэтому это проверенный синтаксически контекстный пример. Load average — длина runnable/uninterruptible очереди по правилам ОС, не процент CPU. Порог 2×workers — лишь явная политика примера.

<?php
$wakeAt = microtime(true) + 0.02;
$ok = time_sleep_until($wakeAt);
var_dump($ok);
var_dump(microtime(true) >= $wakeAt);

bool(true)
bool(true)

Пауза около 20 мс ограничена учебным запуском. microtime(true) даёт дробную Unix-отметку; повторное значение после возврата не меньше цели.

<?php
$warnings = 0;
set_error_handler(static function (int $level) use (&$warnings): bool {
    if ($level === E_WARNING) { $warnings++; return true; }
    return false;
});
try {
    $ok = time_sleep_until(microtime(true) - 1);
} finally {
    restore_error_handler();
}
var_dump($ok);
echo 'warnings=', $warnings, "\n";

bool(false)
warnings=1

Предупреждение обработано только ради наблюдаемого опыта; рабочий код проверяет, что deadline ещё в будущем, и не подавляет другие ошибки.

<?php
$source = file_get_contents(__FILE__);
$payload = substr($source, __COMPILER_HALT_OFFSET__);
echo trim($payload), "\n";
__halt_compiler();
MANUAL-PAYLOAD

MANUAL-PAYLOAD

__COMPILER_HALT_OFFSET__ — byte-позиция первого байта после конструкции. Компилятор не разбирает MANUAL-PAYLOAD как PHP; код до конструкции читает этот хвост как данные.

<?php
$handle = fopen(__FILE__, 'rb');
if ($handle === false || fseek($handle, __COMPILER_HALT_OFFSET__) !== 0) {
    throw new RuntimeException('payload');
}
$json = ltrim((string) stream_get_contents($handle));
fclose($handle);
$manifest = json_decode($json, true, flags: JSON_THROW_ON_ERROR);
echo $manifest['package'], ':', $manifest['files'], "\n";
__halt_compiler();
{"package":"demo","files":3}

demo:3

JSON остаётся обычными данными и проходит json_decode. В реальном single-file package дополнительно проверяют подпись/хеш, размер и схему; сам offset не доказывает целостность.

<?php
$binary = pack('NnC', 0x10203040, 0x5060, 0x70);
echo bin2hex($binary), "\n";
echo strlen($binary), " bytes\n";

10203040506070
7 bytes

N всегда пишет 32-bit big-endian, n — 16-bit big-endian, C — один byte. Поэтому результат не зависит от native endian этой машины.

<?php
$record = pack('Z8N', 'IMG', 640);
echo bin2hex($record), "\n";
echo strlen($record), "\n";

494d47000000000000000280
12

Z8 занимает восемь bytes: IMG, NUL-терминатор и дополнение. N добавляет четыре bytes 00000280. Это бинарная запись, а не UTF-8-текстовый CSV.

<?php
$id = uniqid('job-');
var_dump(str_starts_with($id, 'job-'));
var_dump(strlen($id) === strlen('job-') + 13);
var_dump((bool) preg_match('/^job-[0-9a-f]+$/D', $id));

bool(true)
bool(true)
bool(true)

Конкретное время-зависимое значение намеренно не фиксируется. Проверка формы не превращает ID в гарантированно уникальный или секретный.

<?php
$label = uniqid('preview-', true);
$token = bin2hex(random_bytes(16));
var_dump(str_starts_with($label, 'preview-'));
var_dump(strlen($label) === strlen('preview-') + 23);
var_dump(strlen($token) === 32 && ctype_xdigit($token));

bool(true)
bool(true)
bool(true)

more_entropy удлиняет time-based label, но Manual всё равно не гарантирует uniqueness/unguessability. Для reset-ссылки используется random_bytes; в БД также ставят UNIQUE и обрабатывают редкий конфликт.

<?php
$binary = hex2bin('10203040506070');
if ($binary === false) { throw new RuntimeException('hex'); }
$header = unpack('Nrequest/nflags/Cversion', $binary);
if ($header === false) { throw new RuntimeException('header'); }
echo $header['request'], "\n";
echo dechex($header['flags']), "\n";
echo dechex($header['version']), "\n";

270544960
5060
70

Имена request/flags/version становятся ключами массива. N/n/C читают 4/2/1 bytes с тем же endian-договором, что pack.

<?php
$frame = "AA" . pack('n2', 300, 400);
$size = unpack('nwidth/nheight', $frame, 2);
if ($size === false) { throw new RuntimeException('frame'); }
echo $size['width'], 'x', $size['height'], "\n";

300x400

Offset 2 отсчитывается в bytes и пропускает ASCII-префикс AA. Имена обязательны для двух разных полей: иначе numeric key может быть перезаписан следующим кодом.

<?php
$command = [PHP_BINARY, '-n', '-d', 'browscap=' . __DIR__ . '/browscap.ini',
    __DIR__ . '/worker.php'];
$process = proc_open($command,
    [0 => ['file', 'NUL', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
    $pipes, __DIR__);
if (!is_resource($process)) { throw new RuntimeException('worker'); }
$out = stream_get_contents($pipes[1]); fclose($pipes[1]);
$err = stream_get_contents($pipes[2]); fclose($pipes[2]);
$code = proc_close($process);
echo $out, 'exit=', $code, "\n", 'stderr=', $err;

ManualBrowser|1.0|cookies=yes
exit=0
stderr=

Тестовый browscap передан только дочернему CLI на старте. База специально содержит один User-Agent и не претендует на актуальный каталог браузеров.

<?php
$command = [PHP_BINARY, '-n', __DIR__ . '/worker.php'];
$process = proc_open($command,
    [0 => ['file', 'NUL', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
    $pipes, __DIR__);
if (!is_resource($process)) { throw new RuntimeException('worker'); }
$out = stream_get_contents($pipes[1]); fclose($pipes[1]);
$err = stream_get_contents($pipes[2]); fclose($pipes[2]);
$code = proc_close($process);
echo $out, 'exit=', $code, "\n", 'stderr=', $err;

warning
bool(false)
exit=0
stderr=

Дочерний PHP запущен с -n, поэтому browscap не настроен. Пользовательский error handler превращает ожидаемое предупреждение в наблюдаемый текст только для опыта.

<?php
$html = highlight_file(__DIR__ . '/sample.php', true);
if (!is_string($html)) { throw new RuntimeException('highlight'); }
$plain = html_entity_decode(strip_tags($html), ENT_QUOTES | ENT_HTML5, 'UTF-8');
var_dump(str_contains($plain, '$message'));
var_dump(str_contains($plain, 'DEMO-NOT-A-SECRET'));

bool(true)
bool(true)

Функция читает и форматирует исходник, но не выполняет echo из sample.php. Текст-заглушка специально показывает главный риск: любые реальные секреты в исходнике тоже будут раскрыты.

<?php
$warnings = 0;
set_error_handler(static function (int $level) use (&$warnings): bool {
    if ($level === E_WARNING) { $warnings++; return true; }
    return false;
});
try { $result = highlight_file(__DIR__ . '/absent.php', true); }
finally { restore_error_handler(); }
var_dump($result);
echo 'warnings=', $warnings, "\n";

bool(false)
warnings=2

PHP 8.5.11 выдаёт отдельные предупреждения открытия файла и highlight_file. Код проверяет false, а не связывает бизнес-логику с числом диагностик. Путь фиксирован автором; разрешённые документы перечисляют явно и не показывают пользователю системные пути.

<?php
$source = '<?php $total = 2 + 3; echo $total;';
$html = highlight_string($source, true);
$plain = html_entity_decode(strip_tags($html), ENT_QUOTES | ENT_HTML5, 'UTF-8');
var_dump(is_string($html));
var_dump(str_contains($plain, '$total'));
var_dump(str_contains($plain, '2 + 3'));

bool(true)
bool(true)
bool(true)

Исходная строка включает открывающий PHP-тег, как требует Manual. Подсветка не запускает вычисление 2+3.

<?php
$ran = false;
ob_start();
$ok = highlight_string('<?php $ran = true;', false);
$html = ob_get_clean();
var_dump($ok);
var_dump(is_string($html) && $html !== '');
var_dump($ran);

bool(true)
bool(true)
bool(false)

Output buffer использован вокруг обычного вызова, а не как callback. Переменная ran остаётся false: PHP-текст только подсвечен.

<?php
$stripped = php_strip_whitespace(__DIR__ . '/source.php');
var_dump($stripped !== '');
var_dump(!str_contains($stripped, 'teaching comment'));
file_put_contents(__DIR__ . '/stripped.php', $stripped);
$process = proc_open([PHP_BINARY, '-n', __DIR__ . '/stripped.php'],
    [0 => ['file', 'NUL', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
    $pipes, __DIR__);
if (!is_resource($process)) { throw new RuntimeException('worker'); }
$out = stream_get_contents($pipes[1]); fclose($pipes[1]);
$err = stream_get_contents($pipes[2]); fclose($pipes[2]);
$code = proc_close($process);
echo $out, 'exit=', $code, "\n", 'stderr=', $err;

bool(true)
bool(true)
compact
exit=0
stderr=

Исполняется только авторский локальный fixture. Комментарий исчез, поведение осталось. Это демонстрация, не production-minifier и не защита исходника.

<?php
$warnings = 0;
set_error_handler(static function (int $level) use (&$warnings): bool {
    if ($level === E_WARNING) { $warnings++; return true; }
    return false;
});
try { $code = php_strip_whitespace(__DIR__ . '/absent.php'); }
finally { restore_error_handler(); }
var_dump($code === '');
echo 'warnings=', $warnings, "\n";

bool(true)
warnings=1

Пустая строка — официальный сигнал failure, поэтому её нельзя принимать за полезный компактный файл.

<?php
$alias = show_source(__DIR__ . '/sample.php', true);
$target = highlight_file(__DIR__ . '/sample.php', true);
var_dump(is_string($alias));
var_dump($alias === $target);

bool(true)
bool(true)

Оба имени возвращают одну и ту же разметку. Новый код обычно выбирает более понятное имя highlight_file.

<?php
ob_start();
$ok = show_source(__DIR__ . '/sample.php', false);
$html = ob_get_clean();
var_dump($ok);
var_dump(is_string($html) && $html !== '');

bool(true)
bool(true)

show_source печатает подсветку и возвращает true. Те же риски раскрытия пути/секретов относятся к нему без изменений.

<?php
$legacy = sapi_windows_cp_conv(65001, 1251, 'Привет');
if (!is_string($legacy)) { throw new RuntimeException('to 1251'); }
$restored = sapi_windows_cp_conv(1251, 65001, $legacy);
var_dump(bin2hex($legacy) === 'cff0e8e2e5f2');
var_dump($restored === 'Привет');

bool(true)
bool(true)

Кодовые страницы заданы явно: 65001 — UTF-8, 1251 — Cyrillic Windows. Это преобразование текста, а не исправление неизвестной кодировки угадыванием.

<?php
$warnings = 0;
set_error_handler(static function (int $level) use (&$warnings): bool {
    if ($level === E_WARNING) { $warnings++; return true; }
    return false;
});
try { $converted = sapi_windows_cp_conv(65001, 1251, "\xFF"); }
finally { restore_error_handler(); }
var_dump($converted);
echo 'warnings=', $warnings, "\n";

NULL
warnings=1

0xFF не является самостоятельным UTF-8-символом. null нельзя превращать в пустой текст: это ошибка входных bytes.

<?php
$process = sapi_windows_cp_get();
$ansi = sapi_windows_cp_get('ansi');
$oem = sapi_windows_cp_get('oem');
$fallback = sapi_windows_cp_get('anything-else');
var_dump($process > 0 && $ansi > 0 && $oem > 0);
var_dump($fallback === $process);
var_dump(sapi_windows_cp_is_utf8() === ($process === 65001));

bool(true)
bool(true)
bool(true)

Конкретные ANSI/OEM числа зависят от Windows-настроек, поэтому проверяется договор. Любой kind кроме ansi/oem относится к текущей process codepage.

<?php
$before = sapi_windows_cp_get();
try {
    var_dump(sapi_windows_cp_set(65001));
    var_dump(sapi_windows_cp_get() === 65001);
    var_dump(sapi_windows_cp_is_utf8());
} finally {
    sapi_windows_cp_set($before);
}
var_dump(sapi_windows_cp_get() === $before);

bool(true)
bool(true)
bool(true)
bool(true)

Изменение действует только в отдельном учебном PHP-процессе. finally возвращает прежнее значение даже при исключении.

<?php
$process = sapi_windows_cp_get();
$ansi = sapi_windows_cp_get('ansi');
$oem = sapi_windows_cp_get('oem');
$fallback = sapi_windows_cp_get('anything-else');
var_dump($process > 0 && $ansi > 0 && $oem > 0);
var_dump($fallback === $process);
var_dump(sapi_windows_cp_is_utf8() === ($process === 65001));

bool(true)
bool(true)
bool(true)

Конкретные ANSI/OEM числа зависят от Windows-настроек, поэтому проверяется договор. Любой kind кроме ansi/oem относится к текущей process codepage.

<?php
$before = sapi_windows_cp_get();
try {
    var_dump(sapi_windows_cp_set(1251));
    var_dump(sapi_windows_cp_get() === 1251);
    var_dump(sapi_windows_cp_is_utf8());
} finally {
    sapi_windows_cp_set($before);
}
var_dump(sapi_windows_cp_get() === $before);

bool(true)
bool(true)
bool(false)
bool(true)

1251 — корректная текстовая codepage, но она не UTF-8-compatible по договору функции. Код не меняет системную локаль Windows.

<?php
$before = sapi_windows_cp_get();
try {
    var_dump(sapi_windows_cp_set(65001));
    var_dump(sapi_windows_cp_get() === 65001);
    var_dump(sapi_windows_cp_is_utf8());
} finally {
    sapi_windows_cp_set($before);
}
var_dump(sapi_windows_cp_get() === $before);

bool(true)
bool(true)
bool(true)
bool(true)

Изменение действует только в отдельном учебном PHP-процессе. finally возвращает прежнее значение даже при исключении.

<?php
$before = sapi_windows_cp_get();
try {
    var_dump(sapi_windows_cp_set(1251));
    var_dump(sapi_windows_cp_get() === 1251);
    var_dump(sapi_windows_cp_is_utf8());
} finally {
    sapi_windows_cp_set($before);
}
var_dump(sapi_windows_cp_get() === $before);

bool(true)
bool(true)
bool(false)
bool(true)

1251 — корректная текстовая codepage, но она не UTF-8-compatible по договору функции. Код не меняет системную локаль Windows.

<?php
@unlink(__DIR__ . '/ready.txt');
@unlink(__DIR__ . '/observed.txt');
$process = proc_open([PHP_BINARY, '-n', __DIR__ . '/worker.php'],
    [0 => ['file', 'NUL', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
    $pipes, __DIR__, null, ['create_process_group' => true]);
if (!is_resource($process)) { throw new RuntimeException('worker'); }
$deadline = microtime(true) + 2;
while (!is_file(__DIR__ . '/ready.txt') && microtime(true) < $deadline) { usleep(10000); }
$state = proc_get_status($process);
$sent = is_file(__DIR__ . '/ready.txt')
    && sapi_windows_generate_ctrl_event(PHP_WINDOWS_EVENT_CTRL_BREAK, $state['pid']);
$deadline = microtime(true) + 2;
while (!is_file(__DIR__ . '/observed.txt') && microtime(true) < $deadline) { usleep(10000); }
$observed = is_file(__DIR__ . '/observed.txt') ? trim(file_get_contents(__DIR__ . '/observed.txt')) : '';
$stdout = stream_get_contents($pipes[1]); fclose($pipes[1]);
$stderr = stream_get_contents($pipes[2]); fclose($pipes[2]);
$code = proc_close($process);
echo $sent ? "sent\n" : "not sent\n";
echo $observed === (string) PHP_WINDOWS_EVENT_CTRL_BREAK ? "break observed\n" : "not observed\n";
echo 'exit=', $code, " stdout=", $stdout, ' stderr=', $stderr;

sent
break observed
exit=0 stdout= stderr=

Child создан с новой process group и сам зарегистрировал handler. Событие направлено только его PID/group; текущий процесс не получает сигнал.

<?php
$sent = sapi_windows_generate_ctrl_event(
    PHP_WINDOWS_EVENT_CTRL_BREAK, 2147483647
);
var_dump($sent);

bool(false)

Большой PID выбран как отсутствующая учебная process group. false обрабатывается как недоставленное управление, а не как подтверждение остановки.

<?php
$handler = static function (int $event): void {
    echo 'event=', $event, "\n";
};
var_dump(sapi_windows_set_ctrl_handler($handler, true));
var_dump(sapi_windows_set_ctrl_handler($handler, false));

bool(true)
bool(true)

Событие не отправляется; опыт проверяет регистрацию и симметричное удаление того же callable в главном потоке.

<?php
@unlink(__DIR__ . '/ready.txt');
@unlink(__DIR__ . '/observed.txt');
$process = proc_open([PHP_BINARY, '-n', __DIR__ . '/worker.php'],
    [0 => ['file', 'NUL', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
    $pipes, __DIR__, null, ['create_process_group' => true]);
if (!is_resource($process)) { throw new RuntimeException('worker'); }
$deadline = microtime(true) + 2;
while (!is_file(__DIR__ . '/ready.txt') && microtime(true) < $deadline) { usleep(10000); }
$state = proc_get_status($process);
$sent = is_file(__DIR__ . '/ready.txt')
    && sapi_windows_generate_ctrl_event(PHP_WINDOWS_EVENT_CTRL_BREAK, $state['pid']);
$deadline = microtime(true) + 2;
while (!is_file(__DIR__ . '/observed.txt') && microtime(true) < $deadline) { usleep(10000); }
$observed = is_file(__DIR__ . '/observed.txt') ? trim(file_get_contents(__DIR__ . '/observed.txt')) : '';
$stdout = stream_get_contents($pipes[1]); fclose($pipes[1]);
$stderr = stream_get_contents($pipes[2]); fclose($pipes[2]);
$code = proc_close($process);
echo $sent ? "sent\n" : "not sent\n";
echo $observed === (string) PHP_WINDOWS_EVENT_CTRL_BREAK ? "break observed\n" : "not observed\n";
echo 'exit=', $code, " stdout=", $stdout, ' stderr=', $stderr;

sent
break observed
exit=0 stdout= stderr=

Child создан с новой process group и сам зарегистрировал handler. Событие направлено только его PID/group; текущий процесс не получает сигнал.

<?php
var_dump(sapi_windows_set_ctrl_handler(null, true));
var_dump(sapi_windows_set_ctrl_handler(null, false));

bool(true)
bool(true)

null заставляет процесс игнорировать CTRL+C, но не CTRL+BREAK. Учебный процесс сразу удаляет настройку; это не рекомендация игнорировать штатную остановку воркера.

<?php
$stream = fopen(__DIR__ . '/output.txt', 'wb');
if ($stream === false) { throw new RuntimeException('file'); }
var_dump(sapi_windows_vt100_support($stream));
var_dump(sapi_windows_vt100_support($stream, true));
fclose($stream);

bool(false)
bool(false)

Перенаправленный файл не получает ENABLE_VIRTUAL_TERMINAL_PROCESSING. Поэтому цветовые escape-последовательности в лог лучше не записывать.

<?php
$stream = fopen('php://temp', 'w+');
fclose($stream);
try {
    sapi_windows_vt100_support($stream);
} catch (TypeError $error) {
    echo "closed stream rejected\n";
}

closed stream rejected

Переменная больше не содержит открытый stream resource. Это ошибка типа, а не ответ «VT100 выключен».

<?php
$green = "\033[32m";
$reset = "\033[0m";
$interactive = defined('STDOUT')
    && sapi_windows_vt100_support(STDOUT);
echo $interactive ? $green . 'OK' . $reset . PHP_EOL : "OK\n";

Результат зависит от настоящей консоли/редиректа, поэтому пример проверяется синтаксически. Даже при false сообщение остаётся читаемым без цвета.