Способы генерации файловых ссылок в веб-приложениях на PHP

Раздел: Разработка на PHP -> Создание ссылок

Обзор методов создания ссылок на файлы

Как создать универсальную ссылку на файл, работающую на любом сервере?

Основное решение: функция генерации полного URL на основе пути файла.

function getFileUrl($filePath) {
    $protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
    $host = $_SERVER['HTTP_HOST'];
    $docRoot = $_SERVER['DOCUMENT_ROOT'];
    $relativePath = str_replace($docRoot, '', realpath($filePath));
    return $protocol . '://' . $host . $relativePath;
}

Href php файле (создание ссылки (href) в php-файле)

Эта функция определяет протокол, домен и заменяет абсолютный путь файла на относительный относительно корня документа. Пример использования:

$file = '/var/www/html/uploads/doc.pdf';
$url = getFileUrl($file);
echo '<a href="' . htmlspecialchars($url) . '">Скачать</a>';

ссылка на файл php (создание ссылки на файл в php)

Возможные проблемы:

Файл находится за пределами document root - тогда realpath вернёт false. Решение: проверять, что путь начинается с DOCUMENT_ROOT.
Некорректная кодировка пути (русские символы). Используйте rawurlencode для сегментов пути.
Несовместимость с виртуальными хостами. Убедитесь, что $_SERVER['HTTP_HOST'] соответствует нужному домену.

Как сделать простую ссылку на статический файл без участия PHP?

<a href="uploads/file.pdf">Скачать PDF</a>

Самый простой способ, если файл доступен напрямую через веб-сервер.

Проблемы: ссылка перестанет работать при перемещении файла или изменении структуры папок. Также нет контроля доступа.

Как создать ссылку через PHP-скрипт, чтобы выполнить проверку перед выдачей файла?

<a href="download.php?file=document.pdf">Скачать</a>

В скрипте download.php обрабатывается запрос:

$allowedDir = __DIR__ . '/files/';
$fileName = basename($_GET['file']);
$filePath = $allowedDir . $fileName;
if (file_exists($filePath)) {
    header('Content-Type: application/pdf');
    readfile($filePath);
} else {
    echo 'Файл не найден.';
}

Уязвимость: если не использовать basename, злоумышленник может передать '../../etc/passwd'. Всегда очищайте ввод. Также необходимо проверять расширение файла.

Как заставить браузер скачать файл, а не открыть его в окне?

// Фрагмент PHP-скрипта
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="file.pdf"');
readfile('path/to/file.pdf');

Заголовок Content-Disposition с параметром attachment вызывает диалог сохранения.

Ошибка: неправильный Content-Type может привести к открытию файла в браузере. Убедитесь, что тип установлен в application/octet-stream или соответствующий MIME.

Как вывести ссылку только при наличии файла на сервере?

$file = 'reports/report.pdf';
if (file_exists($file)) {
    echo '<a href="' . $file . '">Отчет</a>';
} else {
    echo 'Файл временно недоступен.';
}

Используется функция file_exists для проверки.

Проблема: кеширование файловой системы может давать устаревшие данные. При частом обновлении файлов используйте clearstatcache().

Как организовать ссылку на файл в защищённой директории только для авторизованных пользователей?

session_start();
if (!isset($_SESSION['user'])) {
    die('Доступ запрещен');
}
$file = $_GET['f'];
$path = '/var/secure/' . basename($file);
if (file_exists($path)) {
    header('Content-Type: application/octet-stream');
    readfile($path);
}

Скрипт проверяет сессию перед отправкой файла. Файлы хранятся вне document root.

Проблемы: при больших файлах readfile потребляет много памяти. Альтернатива – использовать fread или потоковую передачу. Также необходимо защитить скрипт от атак через подстановку имени файла.

Расширенные примеры генерации ссылок

Пример 1: Ссылка на файл с принудительным скачиванием через PHP

Пример

// download.php
$file = 'secret.pdf';
$path = __DIR__ . '/protected/' . $file;
if (file_exists($path)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="' . basename($path) . '"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($path));
    readfile($path);
    exit;
}

Браузер инициирует скачивание файла с именем secret.pdf независимо от его типа.

Пример 2: Автоматическое создание списка файлов со ссылками из папки

Пример

$dir = 'uploads/';
$files = scandir($dir);
echo '<ul>';
foreach ($files as $file) {
    if ($file === '.' || $file === '..') continue;
    $url = $dir . rawurlencode($file);
    echo '<li><a href="' . $url . '">' . htmlspecialchars($file) . '</a></li>';
}
echo '</ul>';

Выводится нумерованный список всех файлов из директории uploads с рабочими ссылками.

Пример 3: Ссылка на изображение с генерацией миниатюры (использование файлового пути)

Пример

$images = glob('gallery/*.{jpg,png,gif}', GLOB_BRACE);
foreach ($images as $img) {
    $thumb = 'thumbs/' . basename($img);
    echo '<a href="' . $img . '"><img src="' . $thumb . '" alt=""></a> ';
}

Создаются ссылки на полноразмерные изображения с превью (миниатюры должны быть заранее созданы).

Пример 4: Генерация ссылки с учётом базового URL из конфигурации

Пример

$baseUrl = 'https://example.com/storage/';
$file = 'archive.zip';
$fullUrl = $baseUrl . rawurlencode($file);
echo '<a href="' . $fullUrl . '">Скачать архив</a>';

Ссылка ведёт напрямую на файл по заранее заданному базовому URL. Полезно для CDN.

Пример 5: Ссылка с атрибутом download для принудительного скачивания средствами HTML5

Пример

$file = 'manual.pdf';
echo '<a href="' . $file . '" download>Скачать руководство</a>';

Атрибут download (без значения) указывает браузеру скачать файл, а не открывать. Работает для одноимённых файлов на том же домене.

Создание ссылки на файл в PHP - comments

ссылка на файл php (php)