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

<?php
declare(strict_types=1);

$items = [['price' => 120], ['price' => 80]];
assert(count($items) === 2, 'В учебной партии две позиции');
echo "К обработке готовы 2 позиции\n";

К обработке готовы 2 позиции

assert описывает условие, которое программист считает истинным внутри уже проверенного кода. При zend.assertions=-1 движок может вообще не сгенерировать проверку, поэтому это не валидация формы или API-запроса.

php -d zend.assertions=1 -d assert.exception=1 -r 'try { assert(2 + 2 === 5, "Нарушен внутренний инвариант"); } catch (AssertionError $e) { echo $e->getMessage(), PHP_EOL; }'

Нарушен внутренний инвариант

Параметр -d действует только в новом учебном процессе. zend.assertions имеет системный режим: включать скомпилированные без проверок assertions поздним ini_set нельзя.

<?php
declare(strict_types=1);

$reflection = new ReflectionFunction('assert_options');
echo $reflection->isDeprecated() ? "assert_options устарела\n" : "проверьте версию\n";

assert_options устарела

Reflection читает метаданные PHP 8.5.11, но не вызывает deprecated-функцию и не меняет глобальные режимы. Современный выбор делается через zend.assertions при запуске процесса и явные исключения в коде.

<?php
declare(strict_types=1);

$quantity = 0;
try {
    if ($quantity < 1) {
        throw new InvalidArgumentException('Количество должно быть положительным');
    }
} catch (InvalidArgumentException $error) {
    echo $error->getMessage(), "\n";
}

Количество должно быть положительным

Для формы, JSON и другой внешней границы явная проверка работает независимо от zend.assertions и остаётся частью production-логики.

<?php
declare(strict_types=1);

gc_collect_cycles();
$left = new stdClass();
$right = new stdClass();
$left->peer = $right;
$right->peer = $left;
unset($left, $right);
$collected = gc_collect_cycles();
echo $collected > 0 ? "цикл собран\n" : "цикл не найден\n";

цикл собран

Обычный счётчик ссылок не освобождает пару, которая ссылается сама на себя после потери внешних имён. Явный запуск делает учебное наблюдение воспроизводимым; вызывать сборщик после каждого объекта не нужно.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
$before = gc_status();
gc_disable();
$disabled = !gc_enabled();
gc_enable();
$enabled = gc_enabled();

$cycle = new stdClass();
$cycle->self = $cycle;
unset($cycle);
$collected = gc_collect_cycles();
$cacheBytes = gc_mem_caches();

memory_reset_peak_usage();
$current = memory_get_usage();
$peak = memory_get_peak_usage();
$usage = getrusage();

if (!$wasEnabled) {
    gc_disable();
}

$gcOk = is_array($before) && $disabled && $enabled
    && is_int($collected) && is_int($cacheBytes);
$metricsOk = $peak >= $current && is_array($usage);
echo $gcOk ? "GC checkpoint выполнен\n" : "ошибка GC checkpoint\n";
echo $metricsOk ? "память и CPU прочитаны\n" : "ошибка метрик\n";

GC checkpoint выполнен
память и CPU прочитаны

В реальном worker это одна диагностическая точка: режим GC временно переключается и возвращается, недостижимый цикл собирается, внутренние кеши запрашиваются к освобождению, а память/CPU читаются без публикации чисел среды.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
gc_disable();
echo gc_enabled() ? "on\n" : "off\n";
gc_enable();
echo gc_enabled() ? "on\n" : "off\n";
if (!$wasEnabled) {
    gc_disable();
}

off
on

gc_disable не отключает обычное освобождение значений с нулевым счётчиком ссылок. В реальном worker изменение подтверждают измерением, а исходный режим восстанавливают.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
$before = gc_status();
gc_disable();
$disabled = !gc_enabled();
gc_enable();
$enabled = gc_enabled();

$cycle = new stdClass();
$cycle->self = $cycle;
unset($cycle);
$collected = gc_collect_cycles();
$cacheBytes = gc_mem_caches();

memory_reset_peak_usage();
$current = memory_get_usage();
$peak = memory_get_peak_usage();
$usage = getrusage();

if (!$wasEnabled) {
    gc_disable();
}

$gcOk = is_array($before) && $disabled && $enabled
    && is_int($collected) && is_int($cacheBytes);
$metricsOk = $peak >= $current && is_array($usage);
echo $gcOk ? "GC checkpoint выполнен\n" : "ошибка GC checkpoint\n";
echo $metricsOk ? "память и CPU прочитаны\n" : "ошибка метрик\n";

GC checkpoint выполнен
память и CPU прочитаны

В реальном worker это одна диагностическая точка: режим GC временно переключается и возвращается, недостижимый цикл собирается, внутренние кеши запрашиваются к освобождению, а память/CPU читаются без публикации чисел среды.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
gc_disable();
echo gc_enabled() ? "on\n" : "off\n";
gc_enable();
echo gc_enabled() ? "on\n" : "off\n";
if (!$wasEnabled) {
    gc_disable();
}

off
on

gc_disable не отключает обычное освобождение значений с нулевым счётчиком ссылок. В реальном worker изменение подтверждают измерением, а исходный режим восстанавливают.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
$before = gc_status();
gc_disable();
$disabled = !gc_enabled();
gc_enable();
$enabled = gc_enabled();

$cycle = new stdClass();
$cycle->self = $cycle;
unset($cycle);
$collected = gc_collect_cycles();
$cacheBytes = gc_mem_caches();

memory_reset_peak_usage();
$current = memory_get_usage();
$peak = memory_get_peak_usage();
$usage = getrusage();

if (!$wasEnabled) {
    gc_disable();
}

$gcOk = is_array($before) && $disabled && $enabled
    && is_int($collected) && is_int($cacheBytes);
$metricsOk = $peak >= $current && is_array($usage);
echo $gcOk ? "GC checkpoint выполнен\n" : "ошибка GC checkpoint\n";
echo $metricsOk ? "память и CPU прочитаны\n" : "ошибка метрик\n";

GC checkpoint выполнен
память и CPU прочитаны

В реальном worker это одна диагностическая точка: режим GC временно переключается и возвращается, недостижимый цикл собирается, внутренние кеши запрашиваются к освобождению, а память/CPU читаются без публикации чисел среды.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
gc_disable();
echo gc_enabled() ? "on\n" : "off\n";
gc_enable();
echo gc_enabled() ? "on\n" : "off\n";
if (!$wasEnabled) {
    gc_disable();
}

off
on

gc_disable не отключает обычное освобождение значений с нулевым счётчиком ссылок. В реальном worker изменение подтверждают измерением, а исходный режим восстанавливают.

<?php
declare(strict_types=1);

$status = gc_status();
$required = ['runs', 'collected', 'threshold', 'roots'];
echo array_diff($required, array_keys($status)) === [] ? "основные поля есть\n" : "неожиданная версия\n";
echo is_bool(gc_enabled()) ? "режим прочитан\n" : "ошибка\n";

основные поля есть
режим прочитан

Числа зависят от уже выполненной программы, поэтому пример проверяет схему, а не выдумывает одинаковое количество циклов для всех запусков.

<?php
declare(strict_types=1);

$freed = gc_mem_caches();
echo is_int($freed) && $freed >= 0 ? "получено число освобождённых байтов\n" : "неожиданный ответ\n";

получено число освобождённых байтов

Ноль — нормальный результат: подходящих внутренних кешей могло не быть. Это не замена сборке циклов и не обещание, что RSS процесса уменьшится на то же число.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
$before = gc_status();
gc_disable();
$disabled = !gc_enabled();
gc_enable();
$enabled = gc_enabled();

$cycle = new stdClass();
$cycle->self = $cycle;
unset($cycle);
$collected = gc_collect_cycles();
$cacheBytes = gc_mem_caches();

memory_reset_peak_usage();
$current = memory_get_usage();
$peak = memory_get_peak_usage();
$usage = getrusage();

if (!$wasEnabled) {
    gc_disable();
}

$gcOk = is_array($before) && $disabled && $enabled
    && is_int($collected) && is_int($cacheBytes);
$metricsOk = $peak >= $current && is_array($usage);
echo $gcOk ? "GC checkpoint выполнен\n" : "ошибка GC checkpoint\n";
echo $metricsOk ? "память и CPU прочитаны\n" : "ошибка метрик\n";

GC checkpoint выполнен
память и CPU прочитаны

В реальном worker это одна диагностическая точка: режим GC временно переключается и возвращается, недостижимый цикл собирается, внутренние кеши запрашиваются к освобождению, а память/CPU читаются без публикации чисел среды.

<?php
declare(strict_types=1);

$status = gc_status();
$required = ['runs', 'collected', 'threshold', 'roots'];
echo array_diff($required, array_keys($status)) === [] ? "основные поля есть\n" : "неожиданная версия\n";
echo is_bool(gc_enabled()) ? "режим прочитан\n" : "ошибка\n";

основные поля есть
режим прочитан

Числа зависят от уже выполненной программы, поэтому пример проверяет схему, а не выдумывает одинаковое количество циклов для всех запусков.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
$before = gc_status();
gc_disable();
$disabled = !gc_enabled();
gc_enable();
$enabled = gc_enabled();

$cycle = new stdClass();
$cycle->self = $cycle;
unset($cycle);
$collected = gc_collect_cycles();
$cacheBytes = gc_mem_caches();

memory_reset_peak_usage();
$current = memory_get_usage();
$peak = memory_get_peak_usage();
$usage = getrusage();

if (!$wasEnabled) {
    gc_disable();
}

$gcOk = is_array($before) && $disabled && $enabled
    && is_int($collected) && is_int($cacheBytes);
$metricsOk = $peak >= $current && is_array($usage);
echo $gcOk ? "GC checkpoint выполнен\n" : "ошибка GC checkpoint\n";
echo $metricsOk ? "память и CPU прочитаны\n" : "ошибка метрик\n";

GC checkpoint выполнен
память и CPU прочитаны

В реальном worker это одна диагностическая точка: режим GC временно переключается и возвращается, недостижимый цикл собирается, внутренние кеши запрашиваются к освобождению, а память/CPU читаются без публикации чисел среды.

<?php
declare(strict_types=1);

$before = memory_get_usage();
$buffer = str_repeat('x', 1024 * 1024);
$after = memory_get_usage();
echo $after > $before ? "использование выросло\n" : "рост не виден\n";
unset($buffer);

использование выросло

Разность описывает наблюдение этого процесса и аллокатора, а не точный «вес строки». real_usage=true измеряет выделенные движку блоки другим масштабом.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
$before = gc_status();
gc_disable();
$disabled = !gc_enabled();
gc_enable();
$enabled = gc_enabled();

$cycle = new stdClass();
$cycle->self = $cycle;
unset($cycle);
$collected = gc_collect_cycles();
$cacheBytes = gc_mem_caches();

memory_reset_peak_usage();
$current = memory_get_usage();
$peak = memory_get_peak_usage();
$usage = getrusage();

if (!$wasEnabled) {
    gc_disable();
}

$gcOk = is_array($before) && $disabled && $enabled
    && is_int($collected) && is_int($cacheBytes);
$metricsOk = $peak >= $current && is_array($usage);
echo $gcOk ? "GC checkpoint выполнен\n" : "ошибка GC checkpoint\n";
echo $metricsOk ? "память и CPU прочитаны\n" : "ошибка метрик\n";

GC checkpoint выполнен
память и CPU прочитаны

В реальном worker это одна диагностическая точка: режим GC временно переключается и возвращается, недостижимый цикл собирается, внутренние кеши запрашиваются к освобождению, а память/CPU читаются без публикации чисел среды.

<?php
declare(strict_types=1);

$temporary = str_repeat('a', 200000);
unset($temporary);
memory_reset_peak_usage();
$current = memory_get_usage();
$peak = memory_get_peak_usage();
echo $peak >= $current ? "новый пик отсчитывается\n" : "ошибка\n";

новый пик отсчитывается

Сброс меняет только счётчик пика; уже выделенная память не освобождается. Для очистки сначала убирают владельцев данных и закрывают ресурсы.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
$before = gc_status();
gc_disable();
$disabled = !gc_enabled();
gc_enable();
$enabled = gc_enabled();

$cycle = new stdClass();
$cycle->self = $cycle;
unset($cycle);
$collected = gc_collect_cycles();
$cacheBytes = gc_mem_caches();

memory_reset_peak_usage();
$current = memory_get_usage();
$peak = memory_get_peak_usage();
$usage = getrusage();

if (!$wasEnabled) {
    gc_disable();
}

$gcOk = is_array($before) && $disabled && $enabled
    && is_int($collected) && is_int($cacheBytes);
$metricsOk = $peak >= $current && is_array($usage);
echo $gcOk ? "GC checkpoint выполнен\n" : "ошибка GC checkpoint\n";
echo $metricsOk ? "память и CPU прочитаны\n" : "ошибка метрик\n";

GC checkpoint выполнен
память и CPU прочитаны

В реальном worker это одна диагностическая точка: режим GC временно переключается и возвращается, недостижимый цикл собирается, внутренние кеши запрашиваются к освобождению, а память/CPU читаются без публикации чисел среды.

<?php
declare(strict_types=1);

$before = getrusage();
array_sum(range(1, 100));
$after = getrusage();
$keys = ['ru_utime.tv_sec', 'ru_utime.tv_usec'];
echo is_array($before) && is_array($after) && array_diff($keys, array_keys($after)) === []
    ? "CPU-счётчики получены\n"
    : "среда не поддержала счётчики\n";

CPU-счётчики получены

Это usage текущего процесса, не wall-clock длительность HTTP-запроса. Для времени ожидания берут монотонный таймер; набор полей зависит от платформы.

<?php
declare(strict_types=1);

$wasEnabled = gc_enabled();
$before = gc_status();
gc_disable();
$disabled = !gc_enabled();
gc_enable();
$enabled = gc_enabled();

$cycle = new stdClass();
$cycle->self = $cycle;
unset($cycle);
$collected = gc_collect_cycles();
$cacheBytes = gc_mem_caches();

memory_reset_peak_usage();
$current = memory_get_usage();
$peak = memory_get_peak_usage();
$usage = getrusage();

if (!$wasEnabled) {
    gc_disable();
}

$gcOk = is_array($before) && $disabled && $enabled
    && is_int($collected) && is_int($cacheBytes);
$metricsOk = $peak >= $current && is_array($usage);
echo $gcOk ? "GC checkpoint выполнен\n" : "ошибка GC checkpoint\n";
echo $metricsOk ? "память и CPU прочитаны\n" : "ошибка метрик\n";

GC checkpoint выполнен
память и CPU прочитаны

В реальном worker это одна диагностическая точка: режим GC временно переключается и возвращается, недостижимый цикл собирается, внутренние кеши запрашиваются к освобождению, а память/CPU читаются без публикации чисел среды.

<?php
declare(strict_types=1);

$ok = set_time_limit(2);
echo $ok ? "лимит принят процессом\n" : "лимит не изменён\n";

лимит принят процессом

Вызов сбрасывает отсчёт max_execution_time с этого места. Он не обещает, что web-server, proxy, supervisor или клиент будут ждать две секунды.

set_time_limit(20);
$deadline = hrtime(true) + 15_000_000_000;
foreach ($jobs as $job) {
    if (hrtime(true) >= $deadline) {
        break;
    }
    $httpClient->send($job, timeout: 3.0);
}
echo "worker завершил управляемый участок\n";

worker завершил управляемый участок

Контекстный фрагмент: отдельный worker, массив jobs и HTTP-клиент уже созданы. При штатном выходе он печатает указанную строку; break способен оставить часть jobs для следующего запуска. На Unix учёт ожидания зависит от механизма сборки/ZTS; на Windows обычно считается реальное время. Таймаут каждой зависимости обязателен отдельно.

<?php
declare(strict_types=1);

$callable = function_exists('dl');
$allowed = ini_get('enable_dl');
echo $callable ? "dl объявлена\n" : "dl отсутствует\n";
echo $allowed === '1' ? "динамическая загрузка разрешена конфигурацией\n" : "динамическая загрузка запрещена конфигурацией\n";

dl объявлена
динамическая загрузка разрешена конфигурацией

Это наблюдение текущего CLI PHP 8.5.11. Функция не вызывается: имя DLL/so, ABI, SAPI и политика сервера могут сделать реальную загрузку невозможной или опасной.

php --ini
php -m
php --ri intl

php --ini: пути конфигурации именно выбранного CLI
php -m: список загруженных модулей
php --ri intl: сведения intl либо сообщение, что расширение отсутствует

Команды показывают ini выбранного CLI, модули и сведения одного расширения; конкретные пути и версии зависят от установки. Для FPM/Apache проверяют именно тот SAPI и перезапускают обслуживающий процесс по процедуре развёртывания; dl для этого не нужен.

<?php
declare(strict_types=1);

$value = get_cfg_var('php_manual.option_that_does_not_exist');
var_dump($value);

bool(false)

false означает, что такой записи нет в конфигурационном источнике. Строки "0" и "" были бы существующими значениями и требуют строгого сравнения.

<?php
declare(strict_types=1);

$fromConfig = get_cfg_var('precision');
$before = ini_get('precision');
$temporary = (string) ((int) $before + 1);
if ($temporary === $fromConfig) {
    $temporary = (string) ((int) $temporary + 1);
}
$old = ini_set('precision', $temporary);
$runtimeChanged = $old !== false && ini_get('precision') === $temporary;
$configStayed = get_cfg_var('precision') === $fromConfig;
echo $runtimeChanged ? "runtime-значение изменилось\n" : "изменение отклонено\n";
echo $configStayed ? "значение из файла не изменилось\n" : "источник неожиданно изменился\n";
if ($old !== false) {
    ini_set('precision', $old);
}

runtime-значение изменилось
значение из файла не изменилось

Пример не зависит от конкретного precision на компьютере читателя: временное число выбирается отличным и от текущего runtime-значения, и от значения конфигурационного файла. get_cfg_var остаётся снимком конфигурационного источника, ini_get видит временное изменение, а прежняя строка возвращается перед завершением.

<?php
declare(strict_types=1);

$old = get_include_path();
$new = __DIR__ . '/vendor' . PATH_SEPARATOR . __DIR__ . '/shared';
$previous = set_include_path($new);
$parts = explode(PATH_SEPARATOR, (string) get_include_path());
echo basename($parts[0]), '|', basename($parts[1]), "\n";
if ($previous !== false) {
    set_include_path($previous);
}

vendor|shared

PATH_SEPARATOR выбирает ; на Windows и : на Unix. Явные пути проекта и Composer autoload обычно яснее глобального поиска по include_path.

<?php
declare(strict_types=1);

$before = get_required_files();
require __DIR__ . '/audit-bootstrap.php';
$after = get_required_files();
$fixture = realpath(__DIR__ . '/audit-bootstrap.php');

$path = get_include_path();
$mainIni = php_ini_loaded_file();
$scanIni = php_ini_scanned_files();
$sapi = php_sapi_name();

$fileOk = is_string($fixture) && in_array($fixture, $after, true)
    && count($after) === count($before) + 1;
$environmentOk = (is_string($path) || $path === false)
    && (is_string($mainIni) || $mainIni === false)
    && (is_string($scanIni) || $scanIni === false)
    && (is_string($sapi) || $sapi === false);
echo $fileOk ? "подключённый файл найден\n" : "файл не найден\n";
echo $environmentOk ? "среда выполнения описана\n" : "ошибка среды\n";

подключённый файл найден
среда выполнения описана

Такой отчёт помогает сравнить CLI и FPM: он подтверждает конкретный require, читает текущий include_path, основной и scan ini и SAPI, но не печатает абсолютные пути посетителю.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$names = array_map('basename', get_included_files());
sort($names);
echo implode(',', $names), "\n";

bootstrap.php,example.php

Список содержит главный файл и подключённый bootstrap. Он отражает уже выполненные include/require, а не все файлы в каталоге.

<?php
declare(strict_types=1);

require __DIR__ . '/settings.php';
echo get_required_files() === get_included_files() ? "списки совпадают\n" : "разные списки\n";

списки совпадают

get_required_files — псевдоним get_included_files. В обоих списках присутствуют и include, и require; название не разделяет их.

<?php
declare(strict_types=1);

require __DIR__ . '/settings.php';
echo get_required_files() === get_included_files() ? "списки совпадают\n" : "разные списки\n";

списки совпадают

get_required_files — псевдоним get_included_files. В обоих списках присутствуют и include, и require; название не разделяет их.

<?php
declare(strict_types=1);

$before = get_required_files();
require __DIR__ . '/audit-bootstrap.php';
$after = get_required_files();
$fixture = realpath(__DIR__ . '/audit-bootstrap.php');

$path = get_include_path();
$mainIni = php_ini_loaded_file();
$scanIni = php_ini_scanned_files();
$sapi = php_sapi_name();

$fileOk = is_string($fixture) && in_array($fixture, $after, true)
    && count($after) === count($before) + 1;
$environmentOk = (is_string($path) || $path === false)
    && (is_string($mainIni) || $mainIni === false)
    && (is_string($scanIni) || $scanIni === false)
    && (is_string($sapi) || $sapi === false);
echo $fileOk ? "подключённый файл найден\n" : "файл не найден\n";
echo $environmentOk ? "среда выполнения описана\n" : "ошибка среды\n";

подключённый файл найден
среда выполнения описана

Такой отчёт помогает сравнить CLI и FPM: он подтверждает конкретный require, читает текущий include_path, основной и scan ini и SAPI, но не печатает абсолютные пути посетителю.

<?php
declare(strict_types=1);

putenv('PHP_MANUAL_REGION=eu-test');
echo getenv('PHP_MANUAL_REGION', true), "\n";
putenv('PHP_MANUAL_REGION');
var_dump(getenv('PHP_MANUAL_REGION', true));

eu-test
bool(false)

Строка NAME=value меняет окружение процесса, NAME без = удаляет переменную. Значение не записывается в php.ini и не является безопасным хранилищем секрета.

<?php
declare(strict_types=1);

putenv('PHP_MANUAL_QUEUE=imports');
putenv('PHP_MANUAL_RETRY=3');
$environment = getenv();
echo isset($environment['PHP_MANUAL_QUEUE'], $environment['PHP_MANUAL_RETRY']) ? "два ключа есть\n" : "неполное окружение\n";
putenv('PHP_MANUAL_QUEUE');
putenv('PHP_MANUAL_RETRY');

два ключа есть

Полный массив может содержать токены и пароли, поэтому пример не выводит его. Параметр local_only влияет только на чтение одного имени; при name=null PHP возвращает общую карту окружения.

<?php
declare(strict_types=1);

$old = ini_alter('precision', 8);
echo ini_get('precision'), "\n";
echo $old !== false ? "alias вернул прежнюю строку\n" : "отказ\n";
if ($old !== false) {
    ini_set('precision', $old);
}

8
alias вернул прежнюю строку

Отдельного механизма alter нет: это alias. В новом коде имя ini_set яснее и лучше совпадает с документацией соседних операций.

<?php
declare(strict_types=1);

$old = ini_alter('precision', 9);
$changed = ini_get('precision');
$bytes = ini_parse_quantity('1M');
ini_restore('precision');
$restored = ini_get('precision');

$cycleOk = is_string($old) && $changed === '9' && $restored === $old;
echo $cycleOk ? "ini-цикл завершён\n" : "ini-цикл нарушен\n";
echo $bytes === 1_048_576 ? "1M = 1048576 байт\n" : "ошибка размера\n";

ini-цикл завершён
1M = 1048576 байт

Первый результат ini_alter сохраняется до изменения, ini_parse_quantity переводит именно ini-сокращение, а ini_restore возвращает значение начала запроса. Это иной сценарий, чем точечное чтение одной директивы.

<?php
declare(strict_types=1);

$old = ini_set('precision', '7');
echo ini_get('precision'), "\n";
echo is_string($old) ? "прежнее значение сохранено\n" : "изменение запрещено\n";
if ($old !== false) {
    ini_set('precision', $old);
}

7
прежнее значение сохранено

ini_set возвращает прежнюю строку, а не true. Изменение действует в текущем запросе и только для директивы, допускающей runtime-уровень.

<?php
declare(strict_types=1);

var_dump(ini_get('php_manual.unknown_directive'));
var_dump(ini_set('php_manual.unknown_directive', '1'));

bool(false)
bool(false)

Неизвестное имя даёт false и при чтении, и при попытке изменения. Для известной, но системной директивы ini_set тоже может вернуть false.

<?php
declare(strict_types=1);

$all = ini_get_all(null, true);
$memory = $all['memory_limit'];
echo isset($memory['global_value'], $memory['local_value'], $memory['access']) ? "три поля есть\n" : "неполная запись\n";
echo is_int($memory['access']) ? "access — маска\n" : "неожиданный тип\n";

три поля есть
access — маска

global_value — исходное для области, local_value — эффективное здесь, access — комбинация INI_* флагов. Публично весь массив не выводят.

<?php
declare(strict_types=1);

$values = ini_get_all(null, false);
echo is_string($values['memory_limit']) ? "memory_limit — строка\n" : "неожиданный тип\n";
echo array_key_exists('max_execution_time', $values) ? "таймаут найден\n" : "нет таймаута\n";

memory_limit — строка
таймаут найден

details=false меняет форму каждого элемента на строку значения. Единицы вроде 128M ещё нужно разобрать, прежде чем сравнивать как байты.

<?php
declare(strict_types=1);

foreach (['128M', '2K', '-1'] as $value) {
    echo $value, ' => ', ini_parse_quantity($value), "\n";
}

128M => 134217728
2K => 2048
-1 => -1

M и K используют степени 1024. -1 часто является специальным «без лимита», а не отрицательным объёмом; смысл задаёт конкретная директива.

<?php
declare(strict_types=1);

$old = ini_alter('precision', 9);
$changed = ini_get('precision');
$bytes = ini_parse_quantity('1M');
ini_restore('precision');
$restored = ini_get('precision');

$cycleOk = is_string($old) && $changed === '9' && $restored === $old;
echo $cycleOk ? "ini-цикл завершён\n" : "ini-цикл нарушен\n";
echo $bytes === 1_048_576 ? "1M = 1048576 байт\n" : "ошибка размера\n";

ini-цикл завершён
1M = 1048576 байт

Первый результат ini_alter сохраняется до изменения, ini_parse_quantity переводит именно ini-сокращение, а ini_restore возвращает значение начала запроса. Это иной сценарий, чем точечное чтение одной директивы.

<?php
declare(strict_types=1);

$configured = ini_get('precision');
ini_set('precision', '7');
ini_restore('precision');
echo ini_get('precision') === $configured ? "исходное значение восстановлено\n" : "проверьте уровни конфигурации\n";

исходное значение восстановлено

ini_restore ничего полезного не возвращает. Он возвращает директиву к значению, действовавшему до runtime-изменения в этом запросе.

<?php
declare(strict_types=1);

$old = ini_alter('precision', 9);
$changed = ini_get('precision');
$bytes = ini_parse_quantity('1M');
ini_restore('precision');
$restored = ini_get('precision');

$cycleOk = is_string($old) && $changed === '9' && $restored === $old;
echo $cycleOk ? "ini-цикл завершён\n" : "ini-цикл нарушен\n";
echo $bytes === 1_048_576 ? "1M = 1048576 байт\n" : "ошибка размера\n";

ini-цикл завершён
1M = 1048576 байт

Первый результат ini_alter сохраняется до изменения, ini_parse_quantity переводит именно ini-сокращение, а ini_restore возвращает значение начала запроса. Это иной сценарий, чем точечное чтение одной директивы.

<?php
declare(strict_types=1);

$old = ini_set('precision', '7');
echo ini_get('precision'), "\n";
echo is_string($old) ? "прежнее значение сохранено\n" : "изменение запрещено\n";
if ($old !== false) {
    ini_set('precision', $old);
}

7
прежнее значение сохранено

ini_set возвращает прежнюю строку, а не true. Изменение действует в текущем запросе и только для директивы, допускающей runtime-уровень.

<?php
declare(strict_types=1);

var_dump(ini_get('php_manual.unknown_directive'));
var_dump(ini_set('php_manual.unknown_directive', '1'));

bool(false)
bool(false)

Неизвестное имя даёт false и при чтении, и при попытке изменения. Для известной, но системной директивы ini_set тоже может вернуть false.

<?php
declare(strict_types=1);

$main = php_ini_loaded_file();
$scanned = php_ini_scanned_files();
echo is_string($main) || $main === false ? "главный ini: допустимый результат\n" : "ошибка\n";
echo is_string($scanned) || $scanned === false ? "scan ini: допустимый результат\n" : "ошибка\n";

главный ini: допустимый результат
scan ini: допустимый результат

Для php_ini_loaded_file false означает, что основной ini не загружен. Для php_ini_scanned_files false означает, что каталог дополнительного сканирования не настроен; пустая строка означает настроенный каталог без распознанных дополнительных ini, а непустая строка перечисляет найденные файлы. Пути раскрывают устройство сервера, поэтому полный вывод держат в закрытой диагностике.

<?php
declare(strict_types=1);

$before = get_required_files();
require __DIR__ . '/audit-bootstrap.php';
$after = get_required_files();
$fixture = realpath(__DIR__ . '/audit-bootstrap.php');

$path = get_include_path();
$mainIni = php_ini_loaded_file();
$scanIni = php_ini_scanned_files();
$sapi = php_sapi_name();

$fileOk = is_string($fixture) && in_array($fixture, $after, true)
    && count($after) === count($before) + 1;
$environmentOk = (is_string($path) || $path === false)
    && (is_string($mainIni) || $mainIni === false)
    && (is_string($scanIni) || $scanIni === false)
    && (is_string($sapi) || $sapi === false);
echo $fileOk ? "подключённый файл найден\n" : "файл не найден\n";
echo $environmentOk ? "среда выполнения описана\n" : "ошибка среды\n";

подключённый файл найден
среда выполнения описана

Такой отчёт помогает сравнить CLI и FPM: он подтверждает конкретный require, читает текущий include_path, основной и scan ini и SAPI, но не печатает абсолютные пути посетителю.

<?php
declare(strict_types=1);

$main = php_ini_loaded_file();
$scanned = php_ini_scanned_files();
echo is_string($main) || $main === false ? "главный ini: допустимый результат\n" : "ошибка\n";
echo is_string($scanned) || $scanned === false ? "scan ini: допустимый результат\n" : "ошибка\n";

главный ini: допустимый результат
scan ini: допустимый результат

Для php_ini_loaded_file false означает, что основной ini не загружен. Для php_ini_scanned_files false означает, что каталог дополнительного сканирования не настроен; пустая строка означает настроенный каталог без распознанных дополнительных ini, а непустая строка перечисляет найденные файлы. Пути раскрывают устройство сервера, поэтому полный вывод держат в закрытой диагностике.

<?php
declare(strict_types=1);

$before = get_required_files();
require __DIR__ . '/audit-bootstrap.php';
$after = get_required_files();
$fixture = realpath(__DIR__ . '/audit-bootstrap.php');

$path = get_include_path();
$mainIni = php_ini_loaded_file();
$scanIni = php_ini_scanned_files();
$sapi = php_sapi_name();

$fileOk = is_string($fixture) && in_array($fixture, $after, true)
    && count($after) === count($before) + 1;
$environmentOk = (is_string($path) || $path === false)
    && (is_string($mainIni) || $mainIni === false)
    && (is_string($scanIni) || $scanIni === false)
    && (is_string($sapi) || $sapi === false);
echo $fileOk ? "подключённый файл найден\n" : "файл не найден\n";
echo $environmentOk ? "среда выполнения описана\n" : "ошибка среды\n";

подключённый файл найден
среда выполнения описана

Такой отчёт помогает сравнить CLI и FPM: он подтверждает конкретный require, читает текущий include_path, основной и scan ini и SAPI, но не печатает абсолютные пути посетителю.

<?php
declare(strict_types=1);

echo function_exists('restore_include_path') ? "историческая функция есть\n" : "в PHP 8 функция удалена\n";

в PHP 8 функция удалена

Не создавайте polyfill, который молча угадывает старое значение. Сохраняйте результат get_include_path до изменения.

<?php
declare(strict_types=1);

$master = get_include_path();
set_include_path(__DIR__ . '/temporary-master');
echo basename((string) get_include_path()), "\n";
ini_restore('include_path');
echo get_include_path() === $master ? "master возвращён\n" : "master отличается\n";

$previous = get_include_path();
try {
    set_include_path(__DIR__ . '/temporary-nested');
    echo basename((string) get_include_path()), "\n";
} finally {
    if ($previous !== false) {
        set_include_path($previous);
    }
}
echo get_include_path() === $previous ? "предыдущее значение возвращено\n" : "не удалось вернуть\n";

temporary-master
master возвращён
temporary-nested
предыдущее значение возвращено

ini_restore("include_path") — прямой replacement restore_include_path для master-значения. Сохранённая строка и finally возвращают значение предыдущего компонента при вложенном временном изменении.

<?php
declare(strict_types=1);

$old = get_include_path();
$new = __DIR__ . '/vendor' . PATH_SEPARATOR . __DIR__ . '/shared';
$previous = set_include_path($new);
$parts = explode(PATH_SEPARATOR, (string) get_include_path());
echo basename($parts[0]), '|', basename($parts[1]), "\n";
if ($previous !== false) {
    set_include_path($previous);
}

vendor|shared

PATH_SEPARATOR выбирает ; на Windows и : на Unix. Явные пути проекта и Composer autoload обычно яснее глобального поиска по include_path.

<?php
declare(strict_types=1);

$master = get_include_path();
set_include_path(__DIR__ . '/temporary-master');
echo basename((string) get_include_path()), "\n";
ini_restore('include_path');
echo get_include_path() === $master ? "master возвращён\n" : "master отличается\n";

$previous = get_include_path();
try {
    set_include_path(__DIR__ . '/temporary-nested');
    echo basename((string) get_include_path()), "\n";
} finally {
    if ($previous !== false) {
        set_include_path($previous);
    }
}
echo get_include_path() === $previous ? "предыдущее значение возвращено\n" : "не удалось вернуть\n";

temporary-master
master возвращён
temporary-nested
предыдущее значение возвращено

ini_restore("include_path") — прямой replacement restore_include_path для master-значения. Сохранённая строка и finally возвращают значение предыдущего компонента при вложенном временном изменении.

<?php
declare(strict_types=1);

$directory = sys_get_temp_dir();
echo is_string($directory) && $directory !== '' ? "каталог получен от среды\n" : "каталог неизвестен\n";

каталог получен от среды

Путь зависит от ОС и конфигурации процесса. Его существование не даёт права хранить там секрет бессрочно и не означает, что два сервера видят один каталог.

<?php
declare(strict_types=1);

$directory = sys_get_temp_dir();
$path = tempnam($directory, 'phpmanual-');
if ($path === false) {
    throw new RuntimeException('Не удалось создать временный файл');
}
file_put_contents($path, 'draft');
echo is_file($path) ? "временный файл создан\n" : "нет файла\n";
unlink($path);

временный файл создан

Функция возвращает каталог, но не резервирует имя. tempnam атомарно создаёт файл; приложение всё равно задаёт права, лимит размера и гарантированную уборку.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') {
    echo "нужен CLI\n";
    return;
}
$changed = cli_set_process_title('php-manual-worker');
$title = cli_get_process_title();
echo $changed && $title === 'php-manual-worker' ? "имя worker установлено\n" : "платформа не поддерживает имя\n";

имя worker установлено

Опыт выполняется в отдельном CLI-процессе, который сразу завершается. Заголовок помогает оператору отличать worker в диспетчере процессов, но не является уникальным ID или механизмом блокировки.

<?php
declare(strict_types=1);

cli_set_process_title('shop:catalog-import');
$title = cli_get_process_title();
$pid = getmypid();
echo str_starts_with((string) $title, 'shop:') && is_int($pid) && $pid > 0
    ? "роль и PID известны\n"
    : "среда не поддержана\n";

роль и PID известны

Название отвечает на вопрос «что делает процесс», PID — «какой именно запуск». PID может быть переиспользован ОС; постоянный ID задания храните отдельно.

<?php
declare(strict_types=1);

if (PHP_SAPI !== 'cli') {
    echo "нужен CLI\n";
    return;
}
$changed = cli_set_process_title('php-manual-worker');
$title = cli_get_process_title();
echo $changed && $title === 'php-manual-worker' ? "имя worker установлено\n" : "платформа не поддерживает имя\n";

имя worker установлено

Опыт выполняется в отдельном CLI-процессе, который сразу завершается. Заголовок помогает оператору отличать worker в диспетчере процессов, но не является уникальным ID или механизмом блокировки.

<?php
declare(strict_types=1);

cli_set_process_title('shop:catalog-import');
$title = cli_get_process_title();
$pid = getmypid();
echo str_starts_with((string) $title, 'shop:') && is_int($pid) && $pid > 0
    ? "роль и PID известны\n"
    : "среда не поддержана\n";

роль и PID известны

Название отвечает на вопрос «что делает процесс», PID — «какой именно запуск». PID может быть переиспользован ОС; постоянный ID задания храните отдельно.

<?php
declare(strict_types=1);

$identity = get_current_user();
echo is_string($identity) ? "строка системной идентичности получена\n" : "неожиданный тип\n";
echo getmypid() !== false ? "процесс определён отдельно\n" : "PID недоступен\n";

строка системной идентичности получена
процесс определён отдельно

На Unix get_current_user относится к владельцу главного файла, а в Windows — к учётной записи процесса; source-less запуск способен вернуть пустую строку. Ни один вариант не обозначает вошедшего покупателя. Для авторизации нужен пользователь приложения.

<?php
declare(strict_types=1);

$owner = get_current_user();
$uid = getmyuid();
$gid = getmygid();
$inode = getmyinode();
$modified = getlastmod();

$identityOk = is_string($owner)
    && (is_int($uid) || $uid === false)
    && (is_int($gid) || $gid === false);
$fileOk = (is_int($inode) || $inode === false)
    && (is_int($modified) || $modified === false);
echo $identityOk ? "идентичность entrypoint прочитана\n" : "нет метаданных владельца\n";
echo $fileOk ? "метаданные entrypoint прочитаны\n" : "нет метаданных файла\n";

идентичность entrypoint прочитана
метаданные entrypoint прочитаны

Один закрытый deploy-check читает все пять API, но намеренно не выводит имя, UID/GID, inode или timestamp. На Windows и source-less CLI часть значений относится к процессу либо может быть false/пустой строкой.

<?php
declare(strict_types=1);

$modifiedAt = getlastmod();
echo is_int($modifiedAt) && $modifiedAt > 0
    ? "Unix timestamp главного файла получен\n"
    : "время изменения недоступно\n";

Unix timestamp главного файла получен

Первый пример показывает один вызов без массива и callback. Возвращённое число — Unix timestamp entrypoint, а не дата последнего include и не версия всего релиза.

<?php
declare(strict_types=1);

$owner = get_current_user();
$uid = getmyuid();
$gid = getmygid();
$inode = getmyinode();
$modified = getlastmod();

$identityOk = is_string($owner)
    && (is_int($uid) || $uid === false)
    && (is_int($gid) || $gid === false);
$fileOk = (is_int($inode) || $inode === false)
    && (is_int($modified) || $modified === false);
echo $identityOk ? "идентичность entrypoint прочитана\n" : "нет метаданных владельца\n";
echo $fileOk ? "метаданные entrypoint прочитаны\n" : "нет метаданных файла\n";

идентичность entrypoint прочитана
метаданные entrypoint прочитаны

Один закрытый deploy-check читает все пять API, но намеренно не выводит имя, UID/GID, inode или timestamp. На Windows и source-less CLI часть значений относится к процессу либо может быть false/пустой строкой.

<?php
declare(strict_types=1);

$gid = getmygid();
echo is_int($gid) ? "GID владельца entrypoint получен\n" : "GID недоступен\n";

GID владельца entrypoint получен

Это отдельный минимальный вызов. На Unix число описывает группу владельца entrypoint; на Windows и необычных файловых системах его смысл ограничен.

<?php
declare(strict_types=1);

$owner = get_current_user();
$uid = getmyuid();
$gid = getmygid();
$inode = getmyinode();
$modified = getlastmod();

$identityOk = is_string($owner)
    && (is_int($uid) || $uid === false)
    && (is_int($gid) || $gid === false);
$fileOk = (is_int($inode) || $inode === false)
    && (is_int($modified) || $modified === false);
echo $identityOk ? "идентичность entrypoint прочитана\n" : "нет метаданных владельца\n";
echo $fileOk ? "метаданные entrypoint прочитаны\n" : "нет метаданных файла\n";

идентичность entrypoint прочитана
метаданные entrypoint прочитаны

Один закрытый deploy-check читает все пять API, но намеренно не выводит имя, UID/GID, inode или timestamp. На Windows и source-less CLI часть значений относится к процессу либо может быть false/пустой строкой.

<?php
declare(strict_types=1);

$inode = getmyinode();
echo is_int($inode) ? "inode главного файла получен\n" : "inode недоступен\n";

inode главного файла получен

Inode полезен только внутри конкретной файловой системы и может измениться после замены файла. Это не глобальный ID релиза и не хеш содержимого.

<?php
declare(strict_types=1);

$owner = get_current_user();
$uid = getmyuid();
$gid = getmygid();
$inode = getmyinode();
$modified = getlastmod();

$identityOk = is_string($owner)
    && (is_int($uid) || $uid === false)
    && (is_int($gid) || $gid === false);
$fileOk = (is_int($inode) || $inode === false)
    && (is_int($modified) || $modified === false);
echo $identityOk ? "идентичность entrypoint прочитана\n" : "нет метаданных владельца\n";
echo $fileOk ? "метаданные entrypoint прочитаны\n" : "нет метаданных файла\n";

идентичность entrypoint прочитана
метаданные entrypoint прочитаны

Один закрытый deploy-check читает все пять API, но намеренно не выводит имя, UID/GID, inode или timestamp. На Windows и source-less CLI часть значений относится к процессу либо может быть false/пустой строкой.

<?php
declare(strict_types=1);

$pid = getmypid();
echo is_int($pid) && $pid > 0 ? "PID процесса получен\n" : "PID недоступен\n";

PID процесса получен

PID различает одновременно работающие процессы на одной ОС в текущий момент. Он не является вечным идентификатором заказа: после завершения номер может быть переиспользован.

<?php
declare(strict_types=1);

cli_set_process_title('shop:catalog-import');
$title = cli_get_process_title();
$pid = getmypid();
echo str_starts_with((string) $title, 'shop:') && is_int($pid) && $pid > 0
    ? "роль и PID известны\n"
    : "среда не поддержана\n";

роль и PID известны

Название отвечает на вопрос «что делает процесс», PID — «какой именно запуск». PID может быть переиспользован ОС; постоянный ID задания храните отдельно.

<?php
declare(strict_types=1);

$uid = getmyuid();
echo is_int($uid) ? "UID владельца entrypoint получен\n" : "UID недоступен\n";

UID владельца entrypoint получен

Число относится к владельцу главного файла в текущей среде. Оно не обозначает вошедшего пользователя сайта и само по себе не доказывает право на конкретную операцию.

<?php
declare(strict_types=1);

$owner = get_current_user();
$uid = getmyuid();
$gid = getmygid();
$inode = getmyinode();
$modified = getlastmod();

$identityOk = is_string($owner)
    && (is_int($uid) || $uid === false)
    && (is_int($gid) || $gid === false);
$fileOk = (is_int($inode) || $inode === false)
    && (is_int($modified) || $modified === false);
echo $identityOk ? "идентичность entrypoint прочитана\n" : "нет метаданных владельца\n";
echo $fileOk ? "метаданные entrypoint прочитаны\n" : "нет метаданных файла\n";

идентичность entrypoint прочитана
метаданные entrypoint прочитаны

Один закрытый deploy-check читает все пять API, но намеренно не выводит имя, UID/GID, inode или timestamp. На Windows и source-less CLI часть значений относится к процессу либо может быть false/пустой строкой.

<?php
$options = getopt('n:', ['format:']);
echo $options['n'], '|', $options['format'], "\n";

5|json

Сохраните как import.php и запустите: php import.php -n 5 --format=json. Двоеточие после имени означает обязательное значение; getopt читает аргументы процесса, а не $_GET.

<?php
$rest = null;
$options = getopt('', ['dry-run'], $rest);
$path = $argv[$rest] ?? null;
echo isset($options['dry-run']) ? "без записи\n" : "с записью\n";
echo $path ?? "путь не передан", "\n";

без записи
catalog.csv

Команда: php import.php --dry-run catalog.csv. Третий параметр получает индекс первого необработанного аргумента и передаётся по ссылке.

<?php
declare(strict_types=1);

$name = php_sapi_name();
echo $name === PHP_SAPI ? "имя SAPI согласовано\n" : "неожиданное различие\n";
echo $name === 'cli' ? "запуск из терминала\n" : "другой интерфейс\n";

имя SAPI согласовано
запуск из терминала

Проверенный пример запущен CLI. У сайта возможны fpm-fcgi, apache2handler или cli-server; это влияет на окружение и жизненный цикл.

<?php
declare(strict_types=1);

$before = get_required_files();
require __DIR__ . '/audit-bootstrap.php';
$after = get_required_files();
$fixture = realpath(__DIR__ . '/audit-bootstrap.php');

$path = get_include_path();
$mainIni = php_ini_loaded_file();
$scanIni = php_ini_scanned_files();
$sapi = php_sapi_name();

$fileOk = is_string($fixture) && in_array($fixture, $after, true)
    && count($after) === count($before) + 1;
$environmentOk = (is_string($path) || $path === false)
    && (is_string($mainIni) || $mainIni === false)
    && (is_string($scanIni) || $scanIni === false)
    && (is_string($sapi) || $sapi === false);
echo $fileOk ? "подключённый файл найден\n" : "файл не найден\n";
echo $environmentOk ? "среда выполнения описана\n" : "ошибка среды\n";

подключённый файл найден
среда выполнения описана

Такой отчёт помогает сравнить CLI и FPM: он подтверждает конкретный require, читает текущий include_path, основной и scan ini и SAPI, но не печатает абсолютные пути посетителю.

<?php
declare(strict_types=1);

$system = php_uname('s');
$machine = php_uname('m');
echo $system !== '' ? "семейство ОС получено\n" : "нет ОС\n";
echo $machine !== '' ? "архитектура получена\n" : "нет архитектуры\n";

семейство ОС получено
архитектура получена

Режим a включает hostname и детали сборки; публичному посетителю они обычно не нужны. Для ветвления часто достаточно PHP_OS_FAMILY и проверки конкретной функции.

<?php
declare(strict_types=1);

$system = php_uname('s');
$release = php_uname('r');
$knownFamily = in_array(PHP_OS_FAMILY, ['Windows', 'BSD', 'Darwin', 'Solaris', 'Linux', 'Unknown'], true);
echo $system !== '' && $release !== '' ? "строки платформы прочитаны\n" : "платформа неизвестна\n";
echo $knownFamily ? "ветка выбрана без публикации hostname\n" : "неизвестное семейство\n";

строки платформы прочитаны
ветка выбрана без публикации hostname

php_uname используется для локального решения и не выводится целиком. Для структуры путей всё равно предпочтительнее PHP_OS_FAMILY, DIRECTORY_SEPARATOR и проверка нужной возможности.

<?php
declare(strict_types=1);

$available = function_exists('zend_thread_id');
$consistent = PHP_ZTS && PHP_DEBUG ? $available : !$available;
echo $consistent ? "наличие функции совпало с режимом сборки\n" : "проверьте сборку\n";
if ($available) {
    echo zend_thread_id() >= 0 ? "thread ID получен\n" : "ошибка ID\n";
}

наличие функции совпало с режимом сборки

Проверенная сборка NTS non-debug, поэтому второй строки нет. Функция появится только при одновременных ZTS и debug; это диагностический номер потока, не ID пользователя и не межсерверный ключ.

<?php
declare(strict_types=1);

$parts = ['pid=' . getmypid()];
if (function_exists('zend_thread_id')) {
    $parts[] = 'thread=' . zend_thread_id();
}
echo str_starts_with(implode(';', $parts), 'pid=') ? "ID запуска собран\n" : "ошибка\n";

ID запуска собран

PID доступен шире; thread добавляется только там, где функция существует. Для распределённой трассировки нужен отдельный request/job ID.

<?php
declare(strict_types=1);

$available = extension_loaded('json');
var_dump($available);

bool(true)

extension_loaded возвращает bool. В поддерживаемой ветке PHP расширение JSON обязательно, поэтому учебный запуск предсказуемо показывает true. В реальном проекте следующий шаг — до первого использования зависимости явно обработать false понятной ошибкой или альтернативой.

<?php
declare(strict_types=1);

$coreReady = extension_loaded('Core');
$constants = get_defined_constants(false);
$ordinary = get_loaded_extensions(false);
$zend = get_loaded_extensions(true);

ob_start();
$creditsOk = phpcredits(CREDITS_QA);
ob_end_clean();
ob_start();
$infoOk = phpinfo(INFO_MODULES);
ob_end_clean();
$engine = zend_version();

$capabilitiesOk = $coreReady && isset($constants['PHP_VERSION'])
    && in_array('Core', $ordinary, true) && is_array($zend);
$reportsOk = $creditsOk === true && $infoOk === true && $engine !== '';
echo $capabilitiesOk ? "возможности подтверждены\n" : "неполная среда\n";
echo $reportsOk ? "локальные отчёты сформированы и отброшены\n" : "ошибка отчёта\n";

возможности подтверждены
локальные отчёты сформированы и отброшены

Пример отличается от полного inventory: код проверяет конкретные факты, phpcredits/phpinfo удерживает в локальном буфере и удаляет, а наружу отдаёт только две безопасные фразы.

<?php
declare(strict_types=1);

$functions = get_extension_funcs('json');
echo is_array($functions) && in_array('json_encode', $functions, true)
    ? "json_encode доступна\n"
    : "нет нужного API\n";

json_encode доступна

Список имён помогает диагностировать сборку. Он не говорит, умеет ли функция обработать конкретные данные и правильно ли настроено приложение.

<?php
declare(strict_types=1);

$functions = get_extension_funcs('lesson_extension_that_does_not_exist');
var_dump($functions);

bool(false)

false отличается от пустого массива. Перед вызовом API обычно понятнее проверить extension_loaded и выдать сообщение о зависимости.

<?php
declare(strict_types=1);

$loaded = array_map('strtolower', get_loaded_extensions());
foreach (['core', 'json', 'reflection'] as $required) {
    echo $required, ': ', in_array($required, $loaded, true) ? 'есть' : 'нет', "\n";
}

core: есть
json: есть
reflection: есть

Вместо публичного phpinfo отчёт ограничен тремя именами. Список относится к текущему процессу: CLI и сайт могут загрузить разные ini и расширения.

<?php
declare(strict_types=1);

$coreReady = extension_loaded('Core');
$constants = get_defined_constants(false);
$ordinary = get_loaded_extensions(false);
$zend = get_loaded_extensions(true);

ob_start();
$creditsOk = phpcredits(CREDITS_QA);
ob_end_clean();
ob_start();
$infoOk = phpinfo(INFO_MODULES);
ob_end_clean();
$engine = zend_version();

$capabilitiesOk = $coreReady && isset($constants['PHP_VERSION'])
    && in_array('Core', $ordinary, true) && is_array($zend);
$reportsOk = $creditsOk === true && $infoOk === true && $engine !== '';
echo $capabilitiesOk ? "возможности подтверждены\n" : "неполная среда\n";
echo $reportsOk ? "локальные отчёты сформированы и отброшены\n" : "ошибка отчёта\n";

возможности подтверждены
локальные отчёты сформированы и отброшены

Пример отличается от полного inventory: код проверяет конкретные факты, phpcredits/phpinfo удерживает в локальном буфере и удаляет, а наружу отдаёт только две безопасные фразы.

<?php
declare(strict_types=1);

foreach (['get_magic_quotes_gpc', 'get_magic_quotes_runtime'] as $name) {
    echo $name, ': ', function_exists($name) ? 'есть' : 'удалена', "\n";
}

get_magic_quotes_gpc: удалена
get_magic_quotes_runtime: удалена

В PHP 8.5.11 обе функции отсутствуют. Возвращать всегда false пользовательским polyfill бессмысленно: старое автоматическое экранирование больше не происходит.

<?php
declare(strict_types=1);

$input = ['customer' => "O'Reilly"];
echo $input['customer'], "\n";
echo htmlspecialchars($input['customer'], ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), "\n";

O'Reilly
O'Reilly

Данные хранятся как есть. Для SQL применяют параметры подготовленного запроса, для HTML — контекстное экранирование при выводе; stripslashes не является универсальной очисткой.

<?php
declare(strict_types=1);

foreach (['get_magic_quotes_gpc', 'get_magic_quotes_runtime'] as $name) {
    echo $name, ': ', function_exists($name) ? 'есть' : 'удалена', "\n";
}

get_magic_quotes_gpc: удалена
get_magic_quotes_runtime: удалена

В PHP 8.5.11 обе функции отсутствуют. Возвращать всегда false пользовательским polyfill бессмысленно: старое автоматическое экранирование больше не происходит.

<?php
declare(strict_types=1);

$input = ['customer' => "O'Reilly"];
echo $input['customer'], "\n";
echo htmlspecialchars($input['customer'], ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), "\n";

O'Reilly
O'Reilly

Данные хранятся как есть. Для SQL применяют параметры подготовленного запроса, для HTML — контекстное экранирование при выводе; stripslashes не является универсальной очисткой.

<?php
declare(strict_types=1);

$stream = fopen('php://temp', 'w+');
$open = get_resources('stream');
echo in_array($stream, $open, true) ? "поток найден\n" : "нет\n";
fclose($stream);
echo is_resource($stream) ? "ещё открыт\n" : "поток закрыт\n";

поток найден
поток закрыт

Фильтр stream ограничивает диагностический список. Он не закрывает ресурсы автоматически и не показывает владельца логической операции.

<?php
declare(strict_types=1);

try {
    get_resources('lesson_unknown_resource_type');
} catch (ValueError $error) {
    echo "неизвестный тип отклонён\n";
}

неизвестный тип отклонён

С PHP 8 неизвестный type вызывает ValueError. Сначала узнают реальные типы из конкретного API; не принимают произвольное имя из запроса пользователя.

<?php
declare(strict_types=1);

ob_start();
$result = phpcredits(CREDITS_GENERAL);
$text = ob_get_clean();
echo $result === true && is_string($text) && $text !== '' ? "credits сформированы локально\n" : "ошибка\n";

credits сформированы локально

Полный текст остаётся внутри переменной и не печатается. Для пользовательского интерфейса у этой функции почти нет практической причины; ссылка на официальные credits обычно проще.

<?php
declare(strict_types=1);

$coreReady = extension_loaded('Core');
$constants = get_defined_constants(false);
$ordinary = get_loaded_extensions(false);
$zend = get_loaded_extensions(true);

ob_start();
$creditsOk = phpcredits(CREDITS_QA);
ob_end_clean();
ob_start();
$infoOk = phpinfo(INFO_MODULES);
ob_end_clean();
$engine = zend_version();

$capabilitiesOk = $coreReady && isset($constants['PHP_VERSION'])
    && in_array('Core', $ordinary, true) && is_array($zend);
$reportsOk = $creditsOk === true && $infoOk === true && $engine !== '';
echo $capabilitiesOk ? "возможности подтверждены\n" : "неполная среда\n";
echo $reportsOk ? "локальные отчёты сформированы и отброшены\n" : "ошибка отчёта\n";

возможности подтверждены
локальные отчёты сформированы и отброшены

Пример отличается от полного inventory: код проверяет конкретные факты, phpcredits/phpinfo удерживает в локальном буфере и удаляет, а наружу отдаёт только две безопасные фразы.

<?php
declare(strict_types=1);

ob_start();
$result = phpinfo(INFO_GENERAL);
$text = ob_get_clean();
echo $result === true && str_contains((string) $text, PHP_VERSION) ? "локальные сведения сформированы\n" : "ошибка\n";

локальные сведения сформированы

Даже INFO_GENERAL раскрывает среду. Мы только проверяем локальный буфер и не отдаём его по HTTP. Для постоянного health-check возвращайте белый список: версия приложения и состояние зависимостей.

<?php
declare(strict_types=1);

$coreReady = extension_loaded('Core');
$constants = get_defined_constants(false);
$ordinary = get_loaded_extensions(false);
$zend = get_loaded_extensions(true);

ob_start();
$creditsOk = phpcredits(CREDITS_QA);
ob_end_clean();
ob_start();
$infoOk = phpinfo(INFO_MODULES);
ob_end_clean();
$engine = zend_version();

$capabilitiesOk = $coreReady && isset($constants['PHP_VERSION'])
    && in_array('Core', $ordinary, true) && is_array($zend);
$reportsOk = $creditsOk === true && $infoOk === true && $engine !== '';
echo $capabilitiesOk ? "возможности подтверждены\n" : "неполная среда\n";
echo $reportsOk ? "локальные отчёты сформированы и отброшены\n" : "ошибка отчёта\n";

возможности подтверждены
локальные отчёты сформированы и отброшены

Пример отличается от полного inventory: код проверяет конкретные факты, phpcredits/phpinfo удерживает в локальном буфере и удаляет, а наружу отдаёт только две безопасные фразы.

<?php
declare(strict_types=1);

echo phpversion() === PHP_VERSION ? "версия PHP согласована\n" : "неожиданное различие\n";
$calculatedId = PHP_MAJOR_VERSION * 10000 + PHP_MINOR_VERSION * 100 + PHP_RELEASE_VERSION;
echo $calculatedId === PHP_VERSION_ID ? "числовая версия согласована\n" : "ошибка формулы\n";
var_dump(phpversion('lesson_extension_that_does_not_exist'));

версия PHP согласована
числовая версия согласована
bool(false)

Без аргумента функция сообщает версию PHP, с именем — версию расширения либо false. PHP_VERSION_ID выводится из трёх числовых компонентов и подходит для простого feature threshold; произвольные строки сравнивайте version_compare, а не строковыми операторами.

<?php
declare(strict_types=1);

$version = phpversion('standard');
echo is_string($version) && version_compare($version, '8.0.0', '>=') ? "standard совместимо\n" : "версия неизвестна\n";

standard совместимо

Имя должно соответствовать загруженному расширению. Наличие версии не доказывает наличие каждой платформенной функции; проверяйте function_exists там, где API условен.

<?php
declare(strict_types=1);

foreach ([['8.5.0', '8.4.9'], ['8.5.0RC1', '8.5.0']] as [$left, $right]) {
    echo $left, version_compare($left, $right, '>') ? " новее\n" : " не новее\n";
}

8.5.0 новее
8.5.0RC1 не новее

Функция понимает сегменты и метки dev/alpha/beta/RC. Оператор передают только из документированного набора, а не напрямую из пользовательского ввода.

<?php
declare(strict_types=1);

$versions = ['8.5.0', '8.5.0RC1', '8.4.9'];
usort($versions, 'version_compare');
echo implode(' < ', $versions), "\n";

8.4.9 < 8.5.0RC1 < 8.5.0

Без version_compare лексикографический порядок ломается на разной длине сегментов и prerelease-метках. Для Composer-ограничений используйте его собственный resolver, а не самодельный разбор.

<?php
declare(strict_types=1);

$engine = zend_version();
echo $engine !== '' ? "версия Zend Engine получена\n" : "пустая версия\n";
echo version_compare(PHP_VERSION, '8.0.0', '>=') ? "PHP 8+\n" : "старая ветка\n";

версия Zend Engine получена
PHP 8+

zend_version нужна для диагностики движка. Совместимость приложения обычно выражают версией PHP и расширений, а не подменяют её номером Zend Engine.

<?php
declare(strict_types=1);

$coreReady = extension_loaded('Core');
$constants = get_defined_constants(false);
$ordinary = get_loaded_extensions(false);
$zend = get_loaded_extensions(true);

ob_start();
$creditsOk = phpcredits(CREDITS_QA);
ob_end_clean();
ob_start();
$infoOk = phpinfo(INFO_MODULES);
ob_end_clean();
$engine = zend_version();

$capabilitiesOk = $coreReady && isset($constants['PHP_VERSION'])
    && in_array('Core', $ordinary, true) && is_array($zend);
$reportsOk = $creditsOk === true && $infoOk === true && $engine !== '';
echo $capabilitiesOk ? "возможности подтверждены\n" : "неполная среда\n";
echo $reportsOk ? "локальные отчёты сформированы и отброшены\n" : "ошибка отчёта\n";

возможности подтверждены
локальные отчёты сформированы и отброшены

Пример отличается от полного inventory: код проверяет конкретные факты, phpcredits/phpinfo удерживает в локальном буфере и удаляет, а наружу отдаёт только две безопасные фразы.