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

<?php
declare(strict_types=1);

$uid = posix_getuid();
echo 'Real UID: ', $uid, "\n";

Например Real UID: 1000; значение относится к текущему процессу.

Сначала ОС вернула число; оператор = сохранил его в $uid; echo показывает значение. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$real = posix_getuid();
$effective = posix_geteuid();
echo $real === $effective ? "UID совпадают\n" : "UID различаются\n";

UID совпадают либо UID различаются.

Такой отчёт помогает понять запуск через привилегированный wrapper. Он не доказывает, кто вошёл на сайт, и не является полной проверкой доступа. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

echo 'Effective UID: ', posix_geteuid(), "\n";

Строка с фактическим effective UID.

Не запускаем whoami через exec ради уже доступного системного вызова. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (posix_geteuid() === 0) {
    fwrite(STDERR, "Импорт должен работать от отдельной непривилегированной учётной записи\n");
    exit(1);
}
echo "UID подходит для обычного запуска\n";

Для UID0 — сообщение в stderr и код1; для другого UID — строка об обычном запуске.

Это конкретная политика job, не утверждение, что любое ненулевое значение гарантирует отсутствие Linux capabilities или полный sandbox. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$gid = posix_getgid();
echo 'Real GID: ', $gid, "\n";

Строка с реальным GID.

Число можно сохранить в диагностике запуска. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$gid = posix_getgid();
$group = posix_getgrgid($gid);
echo $group === false ? "Нет записи группы для GID $gid\n" : 'Группа: ' . $group['name'] . "\n";

Название найденной системной группы либо явное сообщение об отсутствии записи.

Процесс может иметь числовую группу, для которой нет записи в доступной NSS базе, например внутри контейнера. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

echo 'Effective GID: ', posix_getegid(), "\n";

Строка с effective GID.

Сравнивайте с владельцем/группой каталога при разборе отказа записи. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$extra = posix_getgroups();
if ($extra === false) throw new RuntimeException('Не прочитаны дополнительные группы');
$groups = array_values(array_unique([posix_getegid(), ...$extra]));
echo implode(', ', $groups), "\n";

Уникальные числовые GID текущего процесса.

getgroups не обязан включать основную эффективную группу на каждой ОС, поэтому добавляем её явно. Это диагностика; ACL и особенности файловой системы всё ещё имеют значение. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$groups = posix_getgroups();
if ($groups === false) throw new RuntimeException('Группы недоступны');
echo 'Дополнительных групп: ', count($groups), "\n";

Дополнительных групп: N.

Проверка === false сохраняет различие между отказом и нормальным пустым массивом. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$target = posix_getgrnam('catalog-export');
if ($target === false) throw new RuntimeException('На стенде нужна группа catalog-export');
$groups = posix_getgroups();
if ($groups === false) throw new RuntimeException('Не прочитаны группы процесса');
$member = in_array($target['gid'], [posix_getegid(), ...$groups], true);
echo $member ? "Группа экспорта присутствует\n" : "Нужен запуск с нужным составом групп\n";

Одна из двух строк о членстве; при отсутствии настроенной группы — исключение.

Проверяем собственную сервисную среду перед экспортом. Это не обещает успешного fopen: фактическая операция тоже должна обработать отказ. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$login = posix_getlogin();
echo $login === false ? "Терминальный login недоступен\n" : "Login: $login\n";

Имя login либо сообщение об отсутствии.

Отсутствие записи у фонового job не означает, что ОС не знает его UID. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$login = posix_getlogin();
$account = posix_getpwuid(posix_geteuid());
echo 'Login session: ', $login === false ? 'нет' : $login, "\n";
echo 'Effective account: ', $account === false ? 'нет записи' : $account['name'], "\n";

Две подписанные строки; значения могут различаться.

При sudo терминальный login и действующая учётная запись — разные вопросы. Нельзя молча выдавать одно за другое. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$uid = posix_geteuid();
$account = posix_getpwuid($uid);
echo $account === false ? "Worker UID=$uid без записи NSS\n" : 'Worker: ' . $account['name'] . "\n";

Имя worker либо числовой UID без найденной записи.

UID остаётся полезным даже при неудачном преобразовании в имя. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$account = posix_getpwuid(posix_geteuid());
if ($account === false) throw new RuntimeException('Нет системной записи');
$home = $account['dir'];
if (!is_string($home) || $home === '') throw new RuntimeException('Домашний каталог не задан');
echo 'Каталог в NSS: ', $home, "\n";
echo 'HOME окружения: ', getenv('HOME') === false ? 'не задан' : getenv('HOME'), "\n";

Две строки с каталогами; они могут различаться.

Чтение dir не создаёт каталог и не выдаёт права. Для состояния сервиса чаще задают отдельный абсолютный путь в конфигурации. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$account = posix_getpwnam('catalog-worker');
if ($account === false) throw new RuntimeException('Настройте catalog-worker на учебном стенде');
echo 'UID=', $account['uid'], '; GID=', $account['gid'], "\n";

UID и GID настроенной учётной записи либо исключение.

Имя выбрано администратором в конфигурации, не получено из формы посетителя. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$current = posix_getpwuid(posix_geteuid());
if ($current === false || !is_string($current['name'])) throw new RuntimeException('Нет имени');
$byName = posix_getpwnam($current['name']);
echo $byName !== false && $byName['uid'] === $current['uid']
    ? "Имя и UID согласованы\n" : "Запись изменилась или lookup не удался\n";

Строка о согласованности либо изменении/отказе.

Два lookup не образуют транзакцию: каталог пользователей может изменяться. Не используйте roundtrip как процедуру входа на сайт. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$gid = posix_getegid();
$group = posix_getgrgid($gid);
echo $group === false ? "GID=$gid\n" : $group['name'] . "\n";

Имя группы либо GID=N.

Показан явный запасной вариант без потери числовой идентичности. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$extra = posix_getgroups();
if ($extra === false) throw new RuntimeException('Группы недоступны');
foreach (array_unique([posix_getegid(), ...$extra]) as $gid) {
    $group = posix_getgrgid($gid);
    echo $gid, ': ', $group === false ? '(нет записи)' : $group['name'], "\n";
}

Одна строка GID: имя для каждой уникальной группы.

Сначала устраняем повторы, затем обращаемся к NSS. Это отчёт владельцу сервиса, а не публичная страница. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$group = posix_getgrnam('catalog-export');
if ($group === false) throw new RuntimeException('Группа catalog-export недоступна');
echo 'GID экспорта: ', $group['gid'], "\n";

Строка с GID либо исключение при отсутствии настройки.

Числовой GID затем может использовать доверенный launcher, а не посетитель сайта. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$group = posix_getgrnam('catalog-export');
if ($group === false) throw new RuntimeException('Нет записи группы');
echo 'Явных записей members: ', count($group['members']), "\n";
foreach ($group['members'] as $member) echo $member, "\n";

Количество и имена из members; пустой список возможен.

Это именно содержимое записи. Пользователь с основной группой catalog-export может не оказаться в members; в уроке не делаем ошибочный отказ доступа из такого отсутствия. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') throw new RuntimeException('Нужен отдельный CLI');
$uid = posix_getuid();
if (!posix_setuid($uid)) throw new RuntimeException('ОС отклонила setuid');
echo 'Effective UID после вызова: ', posix_geteuid(), "\n";

Текущий effective UID либо исключение при отказе ОС.

Пример без выбора чужого пользователя. Даже установка своего UID не является переносимой гарантией успешности на любой системе. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli' || posix_geteuid() !== 0) {
    throw new RuntimeException('Только отдельный привилегированный учебный launcher');
}
$account = posix_getpwnam('catalog-worker');
if ($account === false || $account['uid'] === 0 || $account['gid'] === 0) {
    throw new RuntimeException('Нужна настроенная непривилегированная учётная запись');
}
if (!posix_initgroups($account['name'], $account['gid'])) {
    throw new RuntimeException('Не назначены дополнительные группы');
}
if (!posix_setgid($account['gid'])) throw new RuntimeException('Не назначен GID');
if (!posix_setuid($account['uid'])) throw new RuntimeException('Не назначен UID');
if (posix_geteuid() !== $account['uid'] || posix_getegid() !== $account['gid']) {
    throw new RuntimeException('Идентичность не совпала');
}
echo "Учебный launcher перешёл к идентичности worker\n";

При успешной настройке: Учебный launcher перешёл к идентичности worker.

Последовательность initgroups → setgid → setuid оставляет необходимые стартовые полномочия до настройки групп. Любая ошибка останавливает дальнейший запуск, вместо продолжения с неожиданными правами. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') throw new RuntimeException('Нужен отдельный CLI');
$gid = posix_getgid();
if (!posix_setgid($gid)) throw new RuntimeException('ОС отклонила GID');
echo 'Effective GID: ', posix_getegid(), "\n";

Строка с GID либо отказ.

Скобки получают одно число; проверка bool относится к операции, а не к числовому GID0. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli' || posix_geteuid() !== 0) {
    throw new RuntimeException('Только отдельный привилегированный учебный launcher');
}
$account = posix_getpwnam('catalog-worker');
if ($account === false || $account['uid'] === 0 || $account['gid'] === 0) {
    throw new RuntimeException('Нужна настроенная непривилегированная учётная запись');
}
if (!posix_initgroups($account['name'], $account['gid'])) {
    throw new RuntimeException('Не назначены дополнительные группы');
}
if (!posix_setgid($account['gid'])) throw new RuntimeException('Не назначен GID');
if (!posix_setuid($account['uid'])) throw new RuntimeException('Не назначен UID');
if (posix_geteuid() !== $account['uid'] || posix_getegid() !== $account['gid']) {
    throw new RuntimeException('Идентичность не совпала');
}
echo "Учебный launcher перешёл к идентичности worker\n";

При успехе — строка о переходе к worker.

Основной GID выбран из passwd записи, а дополнительные группы назначены отдельно. Копируемая программа полностью показывает порядок; после завершения одноразового процесса изменения исчезают вместе с ним. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') throw new RuntimeException('Нужен CLI');
$effective = posix_geteuid();
echo posix_seteuid($effective) ? "Вызов принят\n" : "ОС отклонила вызов\n";

Вызов принят либо ОС отклонила вызов.

Некоторые POSIX реализации могут отклонять даже установку текущего значения. Результат не игнорируется. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') throw new RuntimeException('Нужен CLI');
$real = posix_getuid();
if (!posix_seteuid($real)) throw new RuntimeException('Не изменён effective UID');
echo 'Real=', posix_getuid(), '; effective=', posix_geteuid(), "\n";

Real и effective показывают исходный real UID.

На обычном непривилегированном запуске числа и так одинаковы. На специальном set-ID запуске это может снизить effective права, но saved UID и другие привилегии нельзя считать удалёнными. Для окончательного сброса см. setuid. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') throw new RuntimeException('Нужен CLI');
$gid = posix_getegid();
if (!posix_setegid($gid)) throw new RuntimeException('EGID не установлен');
echo 'EGID=', posix_getegid(), "\n";

EGID=N либо исключение.

Не подменяем успешность предположением «это же текущая группа». Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') throw new RuntimeException('Нужен CLI');
$real = posix_getgid();
$before = posix_getgroups();
if (!posix_setegid($real)) throw new RuntimeException('Группа не изменена');
$after = posix_getgroups();
echo 'EGID=', posix_getegid(), "\n";
echo $before !== false && $after !== false && $before === $after
    ? "Дополнительные группы не изменились\n" : "Проверьте состав групп\n";

Новый EGID и строка о дополнительных группах.

Так видно, что основной GID и список дополнительных групп — разные свойства процесса. Для пересчёта списка есть initgroups. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli' || posix_geteuid() !== 0) throw new RuntimeException('Нужен отдельный привилегированный стенд');
$account = posix_getpwnam('catalog-worker');
if ($account === false || $account['uid'] === 0) throw new RuntimeException('Нет непривилегированного worker');
if (!posix_initgroups($account['name'], $account['gid'])) throw new RuntimeException('initgroups не выполнен');
$groups = posix_getgroups();
if ($groups === false) throw new RuntimeException('Список не прочитан');
echo 'Назначено дополнительных GID: ', count($groups), "\n";

Количество назначенных групп либо явный отказ.

Эта отдельная демонстрация заканчивается сразу: она ещё не сменила UID и не запускает обработку данных. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli' || posix_geteuid() !== 0) {
    throw new RuntimeException('Только отдельный привилегированный учебный launcher');
}
$account = posix_getpwnam('catalog-worker');
if ($account === false || $account['uid'] === 0 || $account['gid'] === 0) {
    throw new RuntimeException('Нужна настроенная непривилегированная учётная запись');
}
if (!posix_initgroups($account['name'], $account['gid'])) {
    throw new RuntimeException('Не назначены дополнительные группы');
}
if (!posix_setgid($account['gid'])) throw new RuntimeException('Не назначен GID');
if (!posix_setuid($account['uid'])) throw new RuntimeException('Не назначен UID');
if (posix_geteuid() !== $account['uid'] || posix_getegid() !== $account['gid']) {
    throw new RuntimeException('Идентичность не совпала');
}
echo "Учебный launcher перешёл к идентичности worker\n";

При успехе — строка о переходе к worker.

Если сначала сделать setuid, может не хватить полномочий для initgroups. Новый запуск по системной конфигурации обычно проще и надёжнее ручного переключения в приложении. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$pid = posix_getpid();
echo 'Worker PID: ', $pid, "\n";

Worker PID: N.

Это номер выполняющегося PHP процесса, а не номер заказа. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$run = bin2hex(random_bytes(6));
$pid = posix_getpid();
foreach (['start', 'catalog-loaded', 'done'] as $event) {
    echo json_encode(['run' => $run, 'pid' => $pid, 'event' => $event], JSON_THROW_ON_ERROR), "\n";
}

Три JSON строки с одинаковыми run и pid, разными event.

Случайный run отделяет разные запуски даже при повторном использовании PID. Для запрета второго job используйте lock/supervisor; журнал не является замком. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

echo 'PID=', posix_getpid(), '; PPID=', posix_getppid(), "\n";

Два фактических номера процесса и родителя.

Лог помогает найти дерево запуска без выполнения ps. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$startedBy = posix_getppid();
$events = ['read-config', 'validate-job'];
foreach ($events as $event) echo $event, ': parent-at-start=', $startedBy, "\n";
echo 'parent-now=', posix_getppid(), "\n";

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

Сохранённое число — снимок. Нельзя отправлять сигнал «родителю при старте» намного позже без учёта его завершения и повторного использования PID. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

echo 'PID=', posix_getpid(), '; PGID=', posix_getpgrp(), "\n";

Два числа, которые могут совпасть или отличаться.

Совпадение PID и PGID означает лидерство группы, а не повышенные права. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$leader = posix_getpgrp() === posix_getpid();
echo $leader ? "Уже лидер группы: прямой setsid обычно откажет\n" : "Не лидер группы\n";

Одна из двух строк.

Это объясняет ограничение setsid; между проверкой и действием всё равно требуется обработать системный отказ. Новая session не равна созданию дочернего процесса. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$group = posix_getpgid(0);
if ($group === false) throw new RuntimeException('PGID недоступен');
echo 'PGID=', $group, "\n";

PGID=N.

0 здесь служебное значение «я», а не несуществующий процесс. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$parent = posix_getppid();
if ($parent <= 0) throw new RuntimeException('Родитель не виден в этом namespace');
$parentGroup = posix_getpgid($parent);
if ($parentGroup === false) {
    echo "Родитель уже завершился или недоступен\n";
} else {
    echo $parentGroup === posix_getpgrp() ? "Общая группа процессов\n" : "Разные группы\n";
}

Общая/разные группы либо сообщение об отказе.

Не подставляем PPID0: для getpgid0 это был бы текущий процесс, и отчёт ложно описал бы родителя. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$sid = posix_getsid(0);
echo $sid === false ? "SID недоступен\n" : "SID=$sid\n";

SID=N либо сообщение об отказе.

Сеанс объединяет группы процессов; он не содержит заказы/корзину посетителя. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$sid = posix_getsid(posix_getpid());
if ($sid === false) throw new RuntimeException('Не прочитан SID');
echo 'PID=', posix_getpid(), '; PGID=', posix_getpgrp(), '; SID=', $sid, "\n";

Три подписанных идентификатора.

Несколько PGID могут принадлежать одному SID. Используйте эти метки при разборе терминального job control, а не как средство авторизации. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') throw new RuntimeException('Нужен одноразовый CLI');
if (!posix_setpgid(0, 0)) throw new RuntimeException('ОС не разрешила новую группу');
echo 'PGID=', posix_getpgrp(), '; PID=', posix_getpid(), "\n";

При успехе PGID совпадает с PID; возможен отказ, например для session leader.

Пример заканчивается сразу, не посылает сигналы группе и не меняет родительскую shell. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_VERSION_ID < 80500) throw new RuntimeException('Урок ошибки рассчитан на PHP8.5');
try {
    posix_setpgid(-1, 0);
} catch (ValueError $error) {
    echo "Отрицательный PID не принимается setpgid\n";
}

Отрицательный PID не принимается setpgid.

У kill отрицательный PID имеет отдельный смысл, а у setpgid недопустим. Нельзя переносить значения между функциями по созвучию. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') throw new RuntimeException('Нужен одноразовый CLI');
$sid = posix_setsid();
echo $sid === -1 ? "Новый сеанс не создан\n" : "Создан SID=$sid\n";

SID=N либо Новый сеанс не создан.

Проверка if (!$sid) ошибочна: -1 — truthy. Не меняйте сеанс длительно живущего рабочего процесса сайта. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli' || !function_exists('pcntl_fork')) throw new RuntimeException('Нужны Unix CLI, PCNTL и POSIX');
$child = pcntl_fork();
if ($child === -1) throw new RuntimeException('fork не выполнен');
if ($child === 0) {
    $sid = posix_setsid();
    echo $sid === -1 ? "Не создан сеанс ребёнка\n" : "Ребёнок создал новый сеанс\n";
    exit($sid === -1 ? 1 : 0);
}
if (pcntl_waitpid($child, $status) !== $child) throw new RuntimeException('Ожидание ребёнка не выполнено');
echo "Родитель дождался собственного ребёнка\n";

Строка ребёнка о результате setsid, затем строка родителя.

Ребёнок наследует PGID родителя, но получает другой PID и обычно уже не лидер группы. Он сразу завершается; waitpid не оставляет zombie. Для production supervisor обычно запускает foreground worker сам. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$pid = posix_getpid();
echo posix_kill($pid, 0) ? "Сигнал своему PID разрешён\n" : "Проверка не удалась\n";

Одна строка результата проверки.

В отличие от названия kill вызов с0 никого не завершает. Даже успешная проверка не гарантирует, что бизнес-задача продвигается. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli' || !function_exists('pcntl_signal')) throw new RuntimeException('Нужны CLI и PCNTL');
$received = false;
pcntl_async_signals(true);
if (!pcntl_signal(SIGUSR1, function () use (&$received) { $received = true; })) {
    throw new RuntimeException('Обработчик не установлен');
}
if (!posix_kill(posix_getpid(), SIGUSR1)) throw new RuntimeException('Сигнал не отправлен');
pcntl_signal_dispatch();
echo $received ? "Обработчик получил уведомление\n" : "Доставка ещё не подтверждена\n";

При обработанном сигнале — Обработчик получил уведомление.

Обработчик установлен до отправки и только меняет флаг. Это демонстрация уведомления, не передача JSON/заказа: для данных используют канал, socket или очередь. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$path = __DIR__ . '/catalog.txt';
echo posix_access($path, POSIX_R_OK) ? "Real UID может читать файл\n" : "Чтение не подтверждено\n";

Для доступной fixture — Real UID может читать файл.

filename передан строкой; R_OK просит чтение. Возвращается bool, а не содержимое файла. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$flags = POSIX_R_OK | POSIX_X_OK;
if (!posix_access(__DIR__, $flags)) {
    $code = posix_get_last_error();
    echo 'Каталог недоступен real IDs: ', $code, ' ', posix_strerror($code), "\n";
} else {
    echo "Real IDs разрешают список и проход\n";
}

Сообщение об успешной диагностике либо код и текст отказа.

Не используем logical || вместо битового |: иначе два флага превратятся в bool. X у каталога не означает «выполнить каталог». Потенциально меняющийся путь всё равно проверяют в самой операции. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (!function_exists('posix_eaccess')) throw new RuntimeException('Нужна поддержка eaccess и PHP8.3+');
echo posix_eaccess(__DIR__ . '/catalog.txt', POSIX_R_OK)
    ? "Effective IDs могут читать каталог товаров\n" : "Чтение не подтверждено\n";

Для доступного файла — строка об effective чтении.

Вход — путь к данным, выход — только ответ на проверку доступа. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$path = __DIR__ . '/catalog.txt';
echo 'Real: ', posix_access($path, POSIX_R_OK) ? 'да' : 'нет', "\n";
echo 'Effective: ', posix_eaccess($path, POSIX_R_OK) ? 'да' : 'нет', "\n";

Две строки; обычный запуск обычно даёт одинаковый ответ.

Различие возможно в специальном launcher с разными IDs. Проверки не читают файл и не подтверждают целостность его содержимого. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$working = posix_getcwd();
if ($working === false) throw new RuntimeException('Рабочий каталог не определён');
echo 'CWD: ', $working, "\n";
echo 'Каталог скрипта: ', __DIR__, "\n";

Два абсолютных пути, которые не обязаны совпасть.

Открытие catalog.txt ищет относительно CWD, а __DIR__ . /catalog.txt — рядом с данным исходником. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$before = posix_getcwd();
if ($before === false) throw new RuntimeException('Не определён CWD');
try {
    if (!chdir(__DIR__)) throw new RuntimeException('chdir не выполнен');
    echo 'Читаем относительно: ', posix_getcwd(), "\n";
} finally {
    if (!chdir($before)) throw new RuntimeException('Не восстановлен CWD');
}
echo "Рабочий каталог восстановлен\n";

Путь скрипта, затем строка о восстановлении.

В библиотеке изменение CWD влияет на другой код процесса; абсолютные пути часто избавляют от этой скрытой зависимости. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$dir = sys_get_temp_dir() . '/php-fifo-' . bin2hex(random_bytes(8));
if (!mkdir($dir, 0700)) throw new RuntimeException('Каталог не создан');
$path = $dir . '/events';
try {
    if (!posix_mkfifo($path, 0600)) throw new RuntimeException('FIFO не создан');
    echo filetype($path), "\n";
} finally {
    if (file_exists($path)) unlink($path);
    rmdir($dir);
}

fifo

Только собственный случайный каталог; не открываем канал, поэтому не ждём второго процесса. После удаления имени уже открытые дескрипторы у других участников жили бы по правилам ОС. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$dir = sys_get_temp_dir() . '/php-fifo-mode-' . bin2hex(random_bytes(8));
if (!mkdir($dir, 0700)) throw new RuntimeException('Каталог не создан');
$path = $dir . '/events';
$oldMask = umask(0077);
try {
    if (!posix_mkfifo($path, 0666)) throw new RuntimeException('FIFO не создан');
    clearstatcache(true, $path);
    printf("Режим: %04o\n", fileperms($path) & 0777);
} finally {
    umask($oldMask);
    if (file_exists($path)) unlink($path);
    rmdir($dir);
}

Режим: 0600

0666 & ~0077 оставляет чтение/запись владельцу. Десятичное666 — другое число. umask меняет окружение процесса и здесь восстановлен; это не готовый многопоточный шаблон. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$dir = sys_get_temp_dir() . '/php-node-' . bin2hex(random_bytes(8));
if (!mkdir($dir, 0700)) throw new RuntimeException('Каталог не создан');
$path = $dir . '/events';
try {
    if (!posix_mknod($path, POSIX_S_IFIFO | 0600)) throw new RuntimeException('ОС отклонила mknod');
    echo filetype($path), "\n";
} finally {
    if (file_exists($path)) unlink($path);
    rmdir($dir);
}

fifo на разрешающей это ОС либо исключение; устройство не создаётся.

Битовая маска описывает одновременно тип и доступ; major/minor здесь не используются. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$dir = sys_get_temp_dir() . '/php-node-file-' . bin2hex(random_bytes(8));
if (!mkdir($dir, 0700)) throw new RuntimeException('Каталог не создан');
$path = $dir . '/report';
try {
    if (!posix_mknod($path, POSIX_S_IFREG | 0600)) throw new RuntimeException('Узел не создан');
    echo filetype($path), ': ', filesize($path), "\n";
} finally {
    if (file_exists($path)) unlink($path);
    rmdir($dir);
}

file: 0 на поддерживающей ОС.

mknod создаёт узел, но не открывает stream и не записывает отчёт. В прикладном коде fopen($path, "x") объединяет создание с получением дескриптора. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

echo posix_isatty(STDOUT) ? "Отчёт идёт в терминал\n" : "Отчёт идёт в файл или канал\n";

Результат зависит от перенаправления вывода.

php report.php и php report.php > report.txt дадут разные ветки без изменения кода. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$interactive = posix_isatty(STDOUT);
$items = [['sku' => 'A42', 'stock' => 7]];
if ($interactive) echo "Остатки каталога\n";
foreach ($items as $item) echo $item['sku'], ';', $item['stock'], "\n";

В терминале заголовок и A42;7; в pipe/файле только A42;7.

Не добавляем progress bar и управляющие коды к данным, которые получает следующая программа. Для общего CSV с кавычками используйте fputcsv. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$terminal = posix_ttyname(STDOUT);
echo $terminal === false ? "STDOUT не имеет имени терминала\n" : "Терминал: $terminal\n";

Путь терминала либо сообщение о его отсутствии.

При перенаправлении вывода отсутствие terminal name нормально. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

foreach (['stdin' => STDIN, 'stdout' => STDOUT] as $name => $stream) {
    if (!posix_isatty($stream)) {
        echo "$name: не терминал\n";
        continue;
    }
    $terminal = posix_ttyname($stream);
    echo $name, ': ', $terminal === false ? 'имя недоступно' : $terminal, "\n";
}

Две строки о stdin/stdout; один может быть терминалом, другой — файлом.

Например CLI утилита может читать клавиатуру, а результат отправлять в файл. Проверяем каждый поток отдельно. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$path = posix_ctermid();
echo $path === false || $path === '' ? "Путь не получен\n" : "Controlling terminal path: $path\n";

Путь вроде /dev/tty либо сообщение об отсутствии.

Никакого чтения клавиатуры не происходит; программа только получает имя. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$controlling = posix_ctermid();
$output = posix_ttyname(STDOUT);
echo 'Controlling path: ', $controlling === false || $controlling === '' ? '(нет)' : $controlling, "\n";
echo 'STDOUT device: ', $output === false ? '(не терминал)' : $output, "\n";

Две строки; при перенаправлении stdout его terminal name может отсутствовать, хотя общий путь ctermid есть.

Так объясняется, почему нельзя решать интерактивность только по ctermid; для конкретного потока используйте isatty. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$system = posix_uname();
if ($system === false) throw new RuntimeException('Данные ОС недоступны');
echo $system['sysname'], ' / ', $system['machine'], "\n";

Например Linux / x86_64; точные строки задаёт ОС.

Возвращается массив: квадратные скобки выбирают конкретное поле. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$system = posix_uname();
if ($system === false) throw new RuntimeException('uname не выполнен');
$report = ['os' => $system['sysname'], 'release' => $system['release'], 'php' => PHP_VERSION];
$report['nis_domain'] = $system['domainname'] ?? '(поле отсутствует)';
echo json_encode($report, JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES), "\n";

JSON с ОС, выпуском, PHP и NIS полем/маркером отсутствия.

?? предотвращает предположение, что GNU поле есть в каждой сборке. Для реальной возможности проверяйте нужную функцию/константу. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$times = posix_times();
if ($times === false) throw new RuntimeException('CPU счётчики недоступны');
echo 'User ticks: ', $times['utime'], '; system ticks: ', $times['stime'], "\n";

Два числовых счётчика, в коротком процессе могут быть0.

Маленькая задача может быть короче одного системного тика, и ноль не означает, что код не исполнялся. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (!defined('POSIX_SC_CLK_TCK')) throw new RuntimeException('Нужна поддержка POSIX_SC_CLK_TCK, PHP8.4+');
$hz = posix_sysconf(POSIX_SC_CLK_TCK);
$before = posix_times();
if ($hz <= 0 || $before === false) throw new RuntimeException('Нет корректных счётчиков');
$digest = '';
for ($i = 0; $i < 10000; $i++) $digest = hash('sha256', 'catalog-' . $i);
$after = posix_times();
if ($after === false) throw new RuntimeException('Не прочитан итог');
$ticks = ($after['utime'] - $before['utime']) + ($after['stime'] - $before['stime']);
if ($ticks < 0) throw new RuntimeException('Счётчик переполнился или изменился');
printf("CPU seconds: %.6f\n", $ticks / $hz);

Неотрицательное измерение CPU секунд, возможно0 на быстрой машине.

Не зашиваем100 ticks/s; узнаём частоту ОС. Это одно измерение конкретного участка, не универсальный рейтинг быстродействия PHP. Для latency API нужны отдельные wall-clock интервалы. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$limits = posix_getrlimit();
if ($limits === false) throw new RuntimeException('Лимиты недоступны');
echo 'Soft openfiles: ', $limits['soft openfiles'] ?? '(нет ключа)', "\n";
echo 'Hard openfiles: ', $limits['hard openfiles'] ?? '(нет ключа)', "\n";

Два лимита или маркеры отсутствующего ключа.

Служба наследует лимиты launcher/supervisor; значения интерактивной shell могут быть другими. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$limits = posix_getrlimit(POSIX_RLIMIT_NOFILE);
if ($limits === false) throw new RuntimeException('NOFILE недоступен');
[$soft, $hard] = $limits;
echo 'Soft=', $soft, '; hard=', $hard, "\n";
if (is_int($soft) && $soft < 128) echo "Мало дескрипторов для проекта с большим числом соединений\n";

Soft/hard и дополнительное сообщение для числового soft<128.

Строку unlimited не преобразуем в0. Выбор128 — политика учебного проекта, а не универсальный минимум для PHP. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') throw new RuntimeException('Нужен отдельный CLI');
$limits = posix_getrlimit(POSIX_RLIMIT_CORE);
if ($limits === false) throw new RuntimeException('Не прочитан CORE');
$hard = $limits[1] === 'unlimited' ? POSIX_RLIMIT_INFINITY : $limits[1];
if (!posix_setrlimit(POSIX_RLIMIT_CORE, 0, $hard)) throw new RuntimeException('Лимит не принят');
echo "Soft CORE=0, hard сохранён\n";

Soft CORE=0, hard сохранён.

Изменяем soft в разрешённых пределах. Это не включает шифрование секретов и не отменяет все внешние механизмы сборщика crash dumps; показываем именно RLIMIT_CORE. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (PHP_VERSION_ID < 80500) throw new RuntimeException('Урок рассчитан на PHP8.5');
try {
    posix_setrlimit(POSIX_RLIMIT_CORE, -2, 0);
} catch (ValueError $error) {
    echo "Значение -2 не является корректным лимитом\n";
}

Значение -2 не является корректным лимитом.

Этот неверный аргумент отвергается до изменения лимита. Для безграничного значения есть POSIX_RLIMIT_INFINITY, не произвольное отрицательное число. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$bytes = posix_sysconf(POSIX_SC_PAGESIZE);
if ($bytes <= 0) throw new RuntimeException('Размер страницы не определён');
echo 'Страница ОС: ', $bytes, " байт\n";

Например Страница ОС: 4096 байт.

Это страница памяти ядра, не HTML страница и не размер PHP массива. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$online = posix_sysconf(POSIX_SC_NPROCESSORS_ONLN);
$configuredMaximum = 4;
$workers = $online > 0 ? min($online, $configuredMaximum) : 1;
echo 'Предварительный предел worker: ', $workers, "\n";

Число от1 до4.

CPU значение — только стартовый ориентир. Дополнительно учитывают container quota, RAM на задачу, лимиты API и измерение latency; автоматическое создание N процессов здесь не происходит. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$limit = posix_pathconf(__DIR__, POSIX_PC_NAME_MAX);
echo is_int($limit) && $limit > 0 ? "NAME_MAX=$limit байт\n" : "Предел имени не определён\n";

Положительный предел в байтах либо явное неизвестное значение.

Спрашиваем каталог, а не ещё не существующий полный путь файла. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$directory = __DIR__;
$name = 'catalog-2026-10.csv';
$limit = posix_pathconf($directory, POSIX_PC_NAME_MAX);
if (!is_int($limit) || $limit <= 0) throw new RuntimeException('Лимит не определён, нужна политика приложения');
if (strlen($name) > $limit) throw new RuntimeException('Имя слишком длинное');
echo "Имя помещается в предел компонента\n";

Имя помещается в предел компонента при достаточном положительном лимите.

Это проверка одного требования. Права, свободное место, зарезервированные имена и race при создании ещё проверяются фактическим fopen. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$stream = fopen(__DIR__ . '/catalog.txt', 'rb');
if ($stream === false) throw new RuntimeException('Файл не открыт');
try {
    $limit = posix_fpathconf($stream, POSIX_PC_NAME_MAX);
    echo is_int($limit) && $limit > 0 ? "NAME_MAX=$limit\n" : "Предел не определён\n";
} finally { fclose($stream); }

Предел NAME_MAX либо сообщение об отсутствии достоверного значения.

В функцию передан сам $stream. Закрытие в finally освобождает дескриптор независимо от результата. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

if (posix_isatty(STDOUT)) throw new RuntimeException('Запустите пример с перенаправлением в pipe');
$limit = posix_fpathconf(STDOUT, POSIX_PC_PIPE_BUF);
$record = "A42;7\n";
if (!is_int($limit) || $limit <= 0) throw new RuntimeException('PIPE_BUF не определён');
echo strlen($record) <= $limit ? "Запись укладывается в PIPE_BUF\n" : "Запись превышает PIPE_BUF\n";

При stdout в pipe и достаточном лимите — Запись укладывается в PIPE_BUF.

PIPE_BUF ограничивает атомарность отдельного системного write в pipe, а не общую ёмкость канала. PHP stream buffering/частичные fwrite не превращаются автоматически в гарантию одного syscall. Проверка isattyfalse сама по себе также не доказывает pipe; это явная предпосылка запуска. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$path = __DIR__ . '/missing-' . bin2hex(random_bytes(8));
if (!posix_access($path, POSIX_F_OK)) {
    $error = posix_get_last_error();
    echo 'Отказ: ', $error, ' ', posix_strerror($error), "\n";
}

Строка с кодом/текстом отказа для отсутствующего пути.

Ничего не создаём и не удаляем; запоминаем errno до любой другой POSIX операции. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$path = __DIR__ . '/missing-' . bin2hex(random_bytes(8));
if (!posix_access($path, POSIX_R_OK)) {
    $captured = posix_get_last_error();
    $pid = posix_getpid();
    echo json_encode(['pid' => $pid, 'operation' => 'access', 'errno' => $captured,
        'message' => posix_strerror($captured)], JSON_THROW_ON_ERROR), "\n";
}

Одна JSON строка с сохранённым errno и PID.

Не включаем в публичный ответ внутренние пути/детали ОС. Следующий успех не является способом «очистить ошибку». Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

posix_access(__DIR__ . '/missing-' . bin2hex(random_bytes(8)), POSIX_F_OK);
$short = posix_errno();
$long = posix_get_last_error();
echo $short === $long ? "Оба имени читают один код\n" : "Код изменился\n";

Оба имени читают один код.

Это чтение одного сохранённого значения, а не две независимые проверки файла. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$ok = posix_access(__DIR__, POSIX_R_OK | POSIX_X_OK);
if ($ok) {
    echo "Каталог доступен\n";
} else {
    $error = posix_errno();
    echo 'Доступ не подтверждён: ', posix_strerror($error), "\n";
}

Сообщение об успехе либо текст отказа.

После успеха не читаем старую ошибку, чтобы не создать ложную тревогу. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

echo posix_strerror(0), "\n";

Системная строка для кода0, например Success; зависит от libc/локали.

Передали0 — получили его описание. Это не проверка успешности предыдущего запроса. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.

<?php
declare(strict_types=1);

$path = __DIR__ . '/missing-' . bin2hex(random_bytes(8));
if (posix_access($path, POSIX_F_OK) === false) {
    $number = posix_get_last_error();
    $description = posix_strerror($number);
    echo 'POSIX ', $number, ': ', $description, "\n";
}

Код и текст ошибки отсутствующего пути.

Число позволяет сопоставлять записи на одном стенде; человек читает описание. Для принятия решения сохраняем отдельный факт отказа access. Контекст: отдельный Unix CLI процесс с расширением POSIX; числовые ID, пути и системные сообщения зависят от стенда. Проверен PHP синтаксис, а не выполнение POSIX на Windows. Изменения прав/лимитов предназначены только для одноразового учебного процесса.