Почему не работает PHP сценарий: подробный разбор проблем выполнения

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

1. Полная диагностика через set_error_handler и shutdown

<?php
// Включаем строгий отчёт обо всех ошибках
error_reporting(E_ALL);
ini_set('display_errors', 0); // отключаем вывод на экран
i$logFile = __DIR__ . '/debug.log';

// Пользовательский обработчик ошибок
function customError($level, $message, $file, $line) {
    global $logFile;
    $log = date('Y-m-d H:i:s') . " [$level] $message в $file:$line\n";
    file_put_contents($logFile, $log, FILE_APPEND);
    return true; // запрещаем стандартный обработчик
}
set_error_handler('customError');

// Обработка фатальных ошибок
register_shutdown_function(function() {
    global $logFile;
    $error = error_get_last();
    if ($error !== null && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
        $log = date('Y-m-d H:i:s') . " [FATAL] {$error['message']} в {$error['file']}:{$error['line']}\n";
        file_put_contents($logFile, $log, FILE_APPEND);
        echo 'Произошла критическая ошибка. Подробности в логе.';
    }
});

// Пример кода с ошибкой
echo $undefinedVar; // Notice: undefined variable
require 'nonexistent.php'; // Warning: failed to open stream
?>

Результат: в файл debug.log запишутся сообщения обо всех ошибках, включая фатальную (если файл не найден - может быть Warning, если require не сможет подключить - Fatal error, если файл отсутствует и отключено отображение).

2025-03-28 12:00:01 [8] Undefined variable: undefinedVar в /var/www/test.php:18
2025-03-28 12:00:01 [2] require(nonexistent.php): Failed to open stream: No such file or directory в /var/www/test.php:19
2025-03-28 12:00:01 [FATAL] require(): Failed opening required 'nonexistent.php' в /var/www/test.php:19

2. Проверка версии PHP и расширений

<?php
echo 'Версия PHP: ' . phpversion() . "\n\n";
$requiredExtensions = ['mbstring', 'mysqli', 'gd', 'json'];
foreach ($requiredExtensions as $ext) {
    if (extension_loaded($ext)) {
        echo "Расширение $ext: загружено (версия " . phpversion($ext) . ")\n";
    } else {
        echo "Расширение $ext: НЕ загружено\n";
    }
}
?>

Результат (пример):

Версия PHP: 8.2.12

Расширение mbstring: загружено (версия 8.2.12)
Расширение mysqli: загружено (версия 8.2.12)
Расширение gd: загружено (версия 8.2.12)
Расширение json: загружено (версия 8.2.12)

3. Использование Xdebug для трассировки

Установите Xdebug и включите в php.ini:

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.log=/tmp/xdebug.log

После этого выполните скрипт с GET-параметром XDEBUG_SESSION=1 (например, http://example.com/script.php?XDEBUG_SESSION=1). IDE (PhpStorm, VS Code) сможет ловить точки останова. В логе Xdebug будет детальная информация о вызовах функций.

4. Обработка исключений с try/catch

<?php
try {
    // Код, который может выбросить исключение
    if (!file_exists('data.txt')) {
        throw new Exception('Файл data.txt не найден.');
    }
    $content = file_get_contents('data.txt');
    if ($content === false) {
        throw new RuntimeException('Не удалось прочитать файл.');
    }
    $json = json_decode($content);
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new InvalidArgumentException('Ошибка формата JSON: ' . json_last_error_msg());
    }
    echo 'Данные успешно загружены.';
} catch (Exception $e) {
    echo 'Поймано исключение: ' . $e->getMessage() . ' в файле ' . $e->getFile() . ' на строке ' . $e->getLine();
    // Также можно записать в лог
    error_log($e->__toString());
}
?>

Результат при отсутствии файла:

Поймано исключение: Файл data.txt не найден. в файле /var/www/test.php на строке 6

5. Изменение настроек через .htaccess (Apache) или .user.ini

В корневой папке сайта создайте .htaccess (если Apache):

php_flag display_errors on
php_value error_reporting 22527   # E_ALL & ~E_DEPRECATED & ~E_STRICT
php_value memory_limit 128M
php_value upload_max_filesize 64M

Для Nginx или другого сервера используйте .user.ini:

display_errors = On
error_reporting = E_ALL
memory_limit = 256M

Эти файлы действуют только на текущую директорию и поддиректории. Важно проверить, разрешена ли переопределение директив (AllowOverride для Apache). Если нет - изменения не применятся.

6. Проверка синтаксиса всех файлов в проекте

find /путь/к/проекту -name '*.php' -exec php -l {} \; 2>&1 | grep -v 'No syntax errors'

Эта команда рекурсивно проверит синтаксис всех PHP файлов и выведет только строки с ошибками.

Результат при наличии ошибки:

PHP Parse error:  syntax error, unexpected 'echo' (T_ECHO) in /var/www/test.php on line 10