Диагностика ошибок запуска PHP: от выявления причины до решения

Расширенные примеры диагностики и исправления ошибок запуска PHP

Приведённые ниже примеры помогут глубже понять механизмы загрузки PHP и локализовать проблему.

Пример 1. Комплексный скрипт для проверки окружения

Создайте файл check.php:

<?php
// Скрипт выводит все ошибки запуска, которые видны в error_log
error_reporting(E_ALL);
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);

// Список критических расширений
$extensions = ['curl', 'mbstring', 'pdo_mysql', 'openssl', 'json'];
foreach ($extensions as $ext) {
    if (extension_loaded($ext)) {
        echo "$ext: OK\n";
    } else {
        echo "$ext: NOT LOADED\n";
    }
}

// Вывод загруженного php.ini и директории сканирования
phpinfo(INFO_GENERAL);
?>

curl: OK
mbstring: OK
pdo_mysql: NOT LOADED
... (далее phpinfo)

Если какое-то расширение не загружено, обратитесь к выводу phpinfo для проверки директив.

Пример 2. Проверка наличия всех ini-файлов и их синтаксиса (имитация)

Хотя PHP не проверяет синтаксис ini напрямую, можно написать скрипт, который загружает каждый файл и ловит ошибки:

<?php
$iniFiles = glob('/etc/php/8.2/*/php.ini') + glob('/etc/php/8.2/*/conf.d/*.ini');
foreach ($iniFiles as $file) {
    // Пытаемся загрузить файл через функцию parse_ini_file
    $loaded = @parse_ini_file($file, true);
    if ($loaded === false) {
        echo "Ошибка синтаксиса в файле: $file\n";
    } else {
        echo "$file загружен успешно\n";
    }
}
?>

/etc/php/8.2/cli/php.ini загружен успешно
/etc/php/8.2/cli/conf.d/10-opcache.ini загружен успешно
... (возможны ошибки при некорректном синтаксисе)

Обратите внимание: parse_ini_file не полностью эмулирует механизм PHP, но может выявить грубые ошибки (отсутствие закрывающих кавычек и т.п.).

Пример 3. Использование опции -c для загрузки альтернативного php.ini

Если основной конфиг повреждён, временно укажите запасной:

php -c /path/to/backup/php.ini -m

Вывод покажет список модулей, загруженных с альтернативной конфигурацией. Сравните с обычным запуском.

Пример 4. Логирование ошибок запуска в отдельный файл

Иногда ошибки startup не видны на экране. Настройте запись в error_log в php.ini:

error_log = /var/log/php_startup_errors.log
display_errors = Off
display_startup_errors = Off

Затем выполните команду:

php -r '' 2>&1 | tee -a /var/log/php_startup_errors.log

Просмотрите лог после каждой попытки исправления.

Пример 5. Имитация ошибки загрузки расширения и её исправление

Создайте временное расширение-пустышку для теста (только для демонстрации). На практике достаточно использовать любое несуществующее имя:

# Добавьте в php.ini:
extension=nonexistent.so

PHP Warning: PHP Startup: Unable to load dynamic library 'nonexistent.so' (tried: /usr/lib/php/20200930/nonexistent.so (lib nonexistent)...) in Unknown on line 0

Отключите или исправьте строку, заменив на корректное имя.

Пример 6. Настройка include_path для уменьшения ошибок startup

Неверный include_path не вызывает ошибки startup напрямую, но может затруднить загрузку пользовательских скриптов. Проверьте:

php -i | grep include_path

include_path => .:/usr/share/php

Если нужно добавить каталог с пользовательскими библиотеками, отредактируйте php.ini:

include_path = ".:/usr/share/php:/home/user/my_libs"

Пример 7. Обработка множественных файлов конфигурации с помощью PHP_INI_SCAN_DIR

Переменная окружения PHP_INI_SCAN_DIR позволяет переопределить каталог сканирования дополнительных ini-файлов:

PHP_INI_SCAN_DIR=/custom/conf.d php -i

Это удобно для изолированного тестирования.

Пример 8. Устранение ошибки "undefined symbol" при загрузке расширения

Такая ошибка обычно возникает из-за несоответствия версий PHP или отсутствия общего символа. Например:

PHP Warning: PHP Startup: Unable to load dynamic library 'http.so' (tried: /usr/lib/php/20200930/http.so (/usr/lib/php/20200930/http.so: undefined symbol: php_http_params))

Решение: перекомпилируйте расширение для текущей версии PHP или установите версию из репозитория, совпадающую с установленной. На Ubuntu используйте pecl с указанием версии API:

sudo pecl install -f http