Работа с путями в PHP: от базовых приёмов до продвинутых сценариев

Расширенные примеры работы с путями

Ниже приведены более сложные сценарии, которые часто встречаются на практике.

Пример 1. Создание и нормализация пути с учётом символических ссылок

$target = '/var/www/link_to_project'; // символическая ссылка на /home/user/project
$resolved = realpath($target);
if ($resolved === false) {
    echo 'Целевой путь не существует';
} else {
    echo 'Реальный путь: ' . $resolved; // /home/user/project
}

Реальный путь: /home/user/project

Пояснение:

realpath() прослеживает символические ссылки и возвращает канонический абсолютный путь. Если ссылка ведёт в несуществующее место - false.

Пример 2. Построение универсального относительного пути между двумя абсолютными

function getRelativePath(string $from, string $to): string {
    $fromParts = explode('/', rtrim($from, '/'));
    $toParts = explode('/', rtrim($to, '/'));
    $commonLength = 0;
    $min = min(count($fromParts), count($toParts));
    for ($i = 0; $i < $min; $i++) {
        if ($fromParts[$i] === $toParts[$i]) $commonLength++;
        else break;
    }
    $ups = array_fill(0, count($fromParts) - $commonLength, '..');
    $downs = array_slice($toParts, $commonLength);
    return implode('/', array_merge($ups, $downs)) ?: '.';
}

echo getRelativePath('/var/www/html/app', '/var/www/html/app/config/db.php');
// config/db.php

config/db.php

Использование:

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

Пример 3. Рекурсивное создание директории по пути

$path = '/tmp/nested/deep/folder';
if (!is_dir($path)) {
    // Третий параметр true разрешает рекурсивное создание
    if (mkdir($path, 0755, true)) {
        echo 'Директория создана: ' . realpath($path);
    } else {
        echo 'Ошибка создания';
    }
}

Директория создана: /tmp/nested/deep/folder

Важно:

Параметр true (recursive) в mkdir() доступен с PHP 5.0.0. Без него нужно создавать каждую вложенную папку вручную.

Пример 4. Безопасное чтение файла с проверкой расширения и размера

function readAllowedFile(string $path): ?string {
    $allowedExt = ['txt', 'csv'];
    $ext = strtolower(pathinfo($path, PATHINFO_EXTENSION));
    if (!in_array($ext, $allowedExt)) {
        echo 'Расширение не разрешено';
        return null;
    }
    if (!is_file($path) || filesize($path) > 1024 * 1024) {
        echo 'Файл не существует или слишком большой';
        return null;
    }
    return file_get_contents($path);
}

(содержимое файла, если проверка пройдена)

Пояснение:

pathinfo() с константой PATHINFO_EXTENSION извлекает только расширение. Проверка размера защищает от переполнения памяти при считывании.

Пример 5. Поиск всех файлов с определённым расширением рекурсивно (без итераторов)

function findFilesByExt(string $dir, string $ext): array {
    $result = [];
    $ext = ltrim($ext, '.');
    $iterator = new RecursiveDirectoryIterator($dir);
    $filtered = new RecursiveCallbackFilterIterator($iterator, function ($current) use ($ext) {
        return $current->isFile() && $current->getExtension() === $ext;
    });
    foreach (new RecursiveIteratorIterator($filtered) as $fileinfo) {
        $result[] = $fileinfo->getPathname();
    }
    return $result;
}

$files = findFilesByExt('/var/www', 'php');
print_r($files);

Array
(
    [0] => /var/www/index.php
    [1] => /var/www/config.php
    ...
)

Примечание:

getExtension() доступен с PHP 5.3.6. Для более старых версий используйте pathinfo($current->getFilename(), PATHINFO_EXTENSION).