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

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

Пример 1. Проверка прав доступа с выводом отчёта

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

<?php
$files = [
    'config.php',
    'index.php',
    'templates/header.php'
];

foreach ($files as $file) {
    if (!file_exists($file)) {
        echo "Файл $file не найден\n";
    } elseif (!is_readable($file)) {
        echo "Файл $file не читается (права: " . substr(sprintf('%o', fileperms($file)), -4) . ")\n";
    } else {
        echo "Файл $file доступен\n";
    }
}
?>

Файл config.php не читается (права: 0640)
Файл index.php доступен
Файл templates/header.php доступен

Решение - исправить права chmod 644 config.php.

Пример 2. Логирование всех ошибок в собственный файл

Создание обработчика, который записывает ошибки в my_errors.log с временной меткой.

<?php
function customErrorHandler($errno, $errstr, $errfile, $errline) {
    $log = "[" . date('Y-m-d H:i:s') . "] Ошибка ($errno): $errstr в $errfile:$errline\n";
    file_put_contents('my_errors.log', $log, FILE_APPEND);
    return true; // не передаём управление стандартному обработчику
}

set_error_handler('customErrorHandler');

// Провокация ошибки
echo $undefinedVar;
?>

В файле my_errors.log появится запись:
[2025-04-09 10:30:15] Ошибка (8): Undefined variable: undefinedVar в /var/www/test.php:12

Этот метод полезен, когда нельзя менять php.ini.

Пример 3. Использование .htaccess для включения отображения ошибок

Если нет доступа к php.ini, настройки можно задать через .htaccess.

# Включить вывод ошибок для всех PHP-файлов
php_flag display_errors on
php_value error_reporting 32767  # E_ALL

Сохраните в файл .htaccess в корне сайта. Проверьте, что модуль mod_rewrite включён, иначе сервер проигнорирует директивы.

Пример 4. Обработка фатальных ошибок через register_shutdown_function

Фатальные ошибки (например, вызов неопределённого класса) не ловятся через set_error_handler. Их можно перехватить при завершении скрипта.

<?php
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error !== null && ($error['type'] === E_ERROR || $error['type'] === E_PARSE)) {
        echo "Фатальная ошибка: {$error['message']} в файле {$error['file']} на строке {$error['line']}";
        // Отправить уведомление администратору
    }
});

// Вызов несуществующего класса
$obj = new NonExistentClass();
?>

Фатальная ошибка: Class "NonExistentClass" not found в файле /var/www/test.php на строке 12

Пример 5. Диагностика include_path и подключения файлов

Ошибка «Failed to open stream» часто связана с неправильным путём. Скрипт показывает текущий путь поиска и проверяет наличие файла.

<?php
echo "Текущий include_path: " . get_include_path() . "\n\n";

$requiredFile = 'config/database.php';
if (stream_resolve_include_path($requiredFile)) {
    echo "Файл $requiredFile найден в include_path\n";
} else {
    echo "Файл $requiredFile не найден. Попробуйте:\n";
    echo "1. Указать абсолютный путь: " . __DIR__ . '/config/database.php' . "\n";
    echo "2. Добавить папку в include_path через set_include_path()\n";
}
?>

Текущий include_path: .:/usr/share/php
Файл config/database.php не найден. Попробуйте:
1. Указать абсолютный путь: /var/www/html/config/database.php
2. Добавить папку в include_path через set_include_path()

Пример 6. Получение информации о конфигурации PHP через phpinfo()

Вызов phpinfo() показывает все настройки, загруженные модули и пути.

<?php
phpinfo();
?>

После запуска найдите разделы error_reporting, display_errors, memory_limit - они подсвечены. Если какая-то директива имеет значение «no value» - это может быть причиной проблемы.

Пример 7. Проверка установленных расширений и их состояния

Отсутствие расширения (например, mysqli) приводит к ошибке вызова неизвестной функции.

<?php
$required_extensions = ['mysqli', 'mbstring', 'gd'];
foreach ($required_extensions as $ext) {
    if (extension_loaded($ext)) {
        echo "$ext загружено\n";
    } else {
        echo "$ext НЕ загружено\n";
    }
}
?>

mysqli загружено
mbstring НЕ загружено
gd загружено

Недостающее расширение устанавливается через пакетный менеджер (например, apt install php-mbstring) или включается в php.ini.