PHP ошибка 'No such file or directory': полное руководство по исправлению

Расширенные примеры и нестандартные случаи ошибки 'No such file or directory'

Пример 1: Диагностика с debug_backtrace

Узнать, какая именно функция и из какого файла вызвала ошибку, можно с помощью debug_backtrace().

<?php
function my_file_get_contents($filename) {
    $result = @file_get_contents($filename);
    if ($result === false) {
        $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2);
        $caller = $trace[1];
        echo "Ошибка в {$caller['file']} на строке {$caller['line']}: файл '$filename' не найден";
    }
    return $result;
}

my_file_get_contents('/nonexistent/file.txt');
?>

Ошибка в /var/www/html/index.php на строке 9: файл '/nonexistent/file.txt' не найден

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

Если путь передан с опечаткой, полезно найти похожие файлы в той же директории.

<?php
$target = 'conig.php'; // опечатка
$dir = dirname(__FILE__);
$similar = glob($dir . '/*onig*'); // ищем по маске
if (!empty($similar)) {
    echo "Возможно, вы имели в виду: " . implode(', ', $similar);
} else {
    echo "Файл не найден и похожих нет.";
}
?>

Возможно, вы имели в виду: /var/www/html/config.php

Пример 3: Работа с символическими ссылками и realpath

Символическая ссылка может вести в несуществующее место. realpath() возвращает false в таком случае.

<?php
$link = '/var/www/current';
$real = realpath($link);
if ($real === false) {
    echo "Ссылка $link ведёт в никуда. Проверьте целостность файловой системы.";
} else {
    echo "Реальный путь: $real";
}
?>

Ссылка /var/www/current ведёт в никуда. Проверьте целостность файловой системы.

Пример 4: Обработка ошибки при загрузке composer autoload

После перемещения проекта может сломаться путь к vendor/autoload.php. Проверяйте его через константу __DIR__ и выдавайте понятное сообщение.

<?php
$autoloadPath = __DIR__ . '/../vendor/autoload.php';
if (!file_exists($autoloadPath)) {
    // Попытка найти в соседних директориях
    $fallbacks = [
        __DIR__ . '/../../vendor/autoload.php',
        __DIR__ . '/vendor/autoload.php'
    ];
    foreach ($fallbacks as $path) {
        if (file_exists($path)) {
            require $path;
            break;
        }
    }
    if (!class_exists('Composer\Autoload\ClassLoader')) {
        die('Composer autoload не найден. Запустите composer install.');
    }
} else {
    require $autoloadPath;
}
?>

Пример 5: Ошибка при использовании PDO с SQLite (файл базы данных)

При указании пути к файлу SQLite базы данных ошибка 'No such file or directory' возникает, если каталог не существует или не доступен для записи.

<?php
$dbPath = '/var/data/app.db';
$dir = dirname($dbPath);
if (!is_dir($dir)) {
    if (!mkdir($dir, 0755, true)) {
        die("Не удалось создать директорию $dir");
    }
}
try {
    $pdo = new PDO("sqlite:$dbPath");
    echo "База данных открыта/создана.";
} catch (PDOException $e) {
    echo "Ошибка подключения: " . $e->getMessage();
}
?>

Ошибка подключения: SQLSTATE[HY000] [14] unable to open database file

Пример 6: Использование PHP built-in server и проверка корневой директории

При запуске встроенного сервера (php -S localhost:8000) относительные пути считаются от корня сервера, а не от текущего скрипта, что часто вызывает ошибку.

<?php
// router.php (используется с php -S)
$uri = $_SERVER['REQUEST_URI'];
$file = __DIR__ . $uri;
if (file_exists($file) && is_file($file)) {
    return false; // отдать статику
} else {
    echo "Файл $uri не найден. Текущая рабочая директория: " . getcwd();
}
?>

В этом примере явно указан __DIR__ для точного поиска.