Причины неработающего PHP и способы их устранения

Расширенные примеры и команды для отладки PHP

Пример 1: Включение всех ошибок через .htaccess и php.ini

Добавьте в .htaccess (если AllowOverride включён):

php_flag display_errors On
php_flag display_startup_errors On
php_value error_reporting -1

Либо в php.ini (рекомендуется только для разработки):

display_errors = On
display_startup_errors = On
error_reporting = E_ALL

Результат:

Любая ошибка (Notice, Warning, Parse error) будет выводиться на экран.

Пример 2: Использование error_log для записи в файл

<?php
// Запись предупреждения в лог
error_log("Это сообщение в лог", 3, "/var/log/php_app.log");
// Другой способ - через trigger_error
trigger_error("Пользовательская ошибка", E_USER_WARNING);
?>

Лог-файл будет содержать временные метки и текст ошибки.

[17-Mar-2025 12:00:00 UTC] Это сообщение в лог
[17-Mar-2025 12:00:01 UTC] PHP Warning:  Пользовательская ошибка in /var/www/index.php on line 6

Пример 3: Полный обработчик ошибок и исключений

<?php
// Установка пользовательского обработчика ошибок
set_error_handler(function($severity, $message, $file, $line) {
    throw new ErrorException($message, 0, $severity, $file, $line);
});
// Установка обработчика для фатальных ошибок
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
        $msg = "Фатальная ошибка: {$error['message']} в {$error['file']}:{$error['line']}";
        error_log($msg);
        echo $msg;
    }
});
// Блок try-catch для перехвата исключений
try {
    // код с потенциальной ошибкой
    undefinedFunction(); // Вызовет ошибку
} catch (Error $e) {
    echo 'Поймана ошибка: ' . $e->getMessage();
}
?>

Результат выполнения (в зависимости от ситуации):

Поймана ошибка: Call to undefined function undefinedFunction()

Пример 4: Поиск утечки памяти с помощью memory_get_usage

<?php
function memoryDebug() {
    static $start = null;
    static $peak = 0;
    if ($start === null) $start = memory_get_usage();
    $now = memory_get_usage();
    $peak = max($peak, $now);
    error_log(sprintf("Текущее: %d, Пик: %d, Разница: %d", $now, $peak, $now - $start));
}
// Вызывать в местах, где возможна утечка
memoryDebug();
// ... большой массив
$data = range(1, 100000);
memoryDebug();
?>

[17-Mar-2025 12:01:00 UTC] Текущее: 409600, Пик: 409600, Разница: 0
[17-Mar-2025 12:01:01 UTC] Текущее: 2244608, Пик: 2244608, Разница: 1835008

Пример 5: Проверка наличия и версий расширений через CLI

# Список всех установленных модулей
php -m | sort
# Полная информация о конкретном модуле
php -r "print_r(gd_info());"
# Проверка доступности функции
php -r "echo function_exists('mysqli_connect') ? 'Да' : 'Нет';"

[PHP Modules]
bz2
calendar
Core
ctype
...
[Zend Modules]
Xdebug

Array
(
    [GD Version] => bundled (2.1.0 compatible)
    [FreeType Support] => 1
    ...
)

Да

Пример 6: Продвинутый debug_backtrace с фильтрацией

<?php
function trace(string $message = '') {
    $backtrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 5);
    foreach ($backtrace as $frame) {
        error_log(sprintf(
            "%s - %s:%d %s%s()",
            $message,
            $frame['file'] ?? 'unknown',
            $frame['line'] ?? 0,
            $frame['class'] ?? '',
            $frame['function'] ?? ''
        ));
    }
}
// Использование
trace('Вызов из index.php');
?>

[17-Mar-2025 12:02:00 UTC] Вызов из index.php - /var/www/index.php:12  trace()

Пример 7: Настройка Xdebug для профилирования

# В php.ini:
xdebug.mode=profile
xdebug.output_dir=/tmp/xdebug
xdebug.profiler_output_name=cachegrind.out.%t.%p

После выполнения скрипта в /tmp/xdebug появится файл, который можно открыть программой (например, KCachegrind или Qcachegrind) для анализа узких мест.

Файл: cachegrind.out.1742212920.12345 (бинарный)