Как задать публичный путь в PHP: основные подходы

Расширенные примеры настройки публичного пути

Пример 1: Универсальный помощник для определения пути

Функция, которая корректно определяет публичный путь как в веб-среде, так и в CLI, используя разные источники.

function getPublicPath(): string
{
    if (php_sapi_name() === 'cli') {
        // В CLI используем константу, определённую в точке входа
        if (defined('PUBLIC_PATH')) {
            return PUBLIC_PATH;
        }
        // Если константа не задана, берём текущий рабочий каталог
        return realpath(getcwd());
    }
    
    // В веб-среде сначала пробуем __DIR__ из index.php
    if (defined('PUBLIC_PATH')) {
        return PUBLIC_PATH;
    }
    
    // Запасной вариант: DOCUMENT_ROOT
    if (!empty($_SERVER['DOCUMENT_ROOT'])) {
        return rtrim($_SERVER['DOCUMENT_ROOT'], DIRECTORY_SEPARATOR);
    }
    
    // Fallback: текущий каталог
    return realpath(dirname($_SERVER['SCRIPT_FILENAME']));
}

// Пример использования:
$public = getPublicPath();
echo "Public path: $public\n";

Public path: /var/www/html/myproject/public

Пояснение: Функция проверяет среду выполнения и выбирает наиболее подходящий источник. В CLI предполагается, что константа PUBLIC_PATH уже определена скриптом, который запускает задачу. В веб-среде приоритет отдаётся константе, затем DOCUMENT_ROOT. Это даёт гибкость и не требует дублирования кода.

Пример 2: Использование переменных окружения для публичного пути

В файле .env определите PUBLIC_PATH=/var/www/project/public. Затем в PHP получите значение через getenv().

// .env
PUBLIC_PATH=/var/www/project/public

// PHP
$publicPath = getenv('PUBLIC_PATH');
if (!$publicPath) {
    $publicPath = rtrim(realpath(__DIR__), DIRECTORY_SEPARATOR);
}
define('PUBLIC_PATH', $publicPath);

// Результат: константа установлена в указанное значение.
echo PUBLIC_PATH; // /var/www/project/public

Проблема: Переменные окружения могут быть не загружены. Решение: Использовать библиотеку vlucas/phpdotenv для загрузки .env в проект.

Пример 3: Автоматическое определение публичного пути через Composer autoload

В composer.json можно определить константу при загрузке:

{
    "autoload": {
        "files": ["bootstrap.php"]
    }
}

В файле bootstrap.php:

<?php
// bootstrap.php
if (!defined('PUBLIC_PATH')) {
    define('PUBLIC_PATH', rtrim(realpath(__DIR__ . '/../public'), DIRECTORY_SEPARATOR));
}

Тогда при любом включении autoload.php константа будет доступна.

// После require 'vendor/autoload.php';
echo PUBLIC_PATH; // /var/www/project/public

Пример 4: Настройка .htaccess для смены DocumentRoot

Если нет доступа к конфигурации сервера, можно изменить корень документа через .htaccess, чтобы публичный путь совпадал с каталогом приложения.

RewriteEngine On
RewriteRule ^(.*)$ public/$1 [L]

Теперь все запросы идут в подкаталог public, и публичный путь можно получить через __DIR__ из файлов внутри public.

// index.php (в корне проекта)
echo __DIR__;  // /var/www/project (корень, а не public)
// после редиректа реальный исполняемый файл - /var/www/project/public/index.php

Важно: В таком случае константа PUBLIC_PATH должна быть определена в public/index.php как __DIR__, что даст /var/www/project/public.

Пример 5: Обработка символических ссылок с помощью realpath

Если публичный каталог является симлинком (например, /home/user/domains/example.com/public_html -> /var/www/project/public), то __DIR__ вернёт путь через симлинк, а realpath(__DIR__) - реальный физический путь. Выбор зависит от задачи.

$symlinkPath = __DIR__;               // /home/user/.../public_html
$realPath    = realpath(__DIR__);     // /var/www/project/public
echo "Symlink: $symlinkPath\n";
echo "Real   : $realPath\n";

Symlink: /home/user/domains/example.com/public_html
Real   : /var/www/project/public

Рекомендация: Для внутреннего использования (include файлов) предпочтительнее реальный путь, чтобы избежать путаницы при кэшировании. Для генерации URL (например, для asset) может потребоваться путь через симлинк, так как браузер обращается по симлинку.

Пример 6: Определение публичного пути в консольных скриптах с передачей аргументов

Если скрипт запускается из CLI и должен знать публичный путь, можно передать его как аргумент или переменную окружения.

#!/usr/bin/env php
<?php
$publicPath = $argv[1] ?? getenv('PUBLIC_PATH') ?? false;
if (!$publicPath) {
    die("Укажите публичный путь первым аргументом или в переменной окружения PUBLIC_PATH\n");
}
define('PUBLIC_PATH', rtrim($publicPath, DIRECTORY_SEPARATOR));
echo "Публичный путь: " . PUBLIC_PATH . "\n";

# bash
$ php script.php /var/www/project/public
Публичный путь: /var/www/project/public