Управление через index.php: практические решения для веб-разработчика

1. Полный Front Controller с роутингом и автозагрузкой

<?php
// index.php
require_once __DIR__ . '/vendor/autoload.php';

use App\Router;
use App\Request;

$request = new Request($_SERVER['REQUEST_URI'], $_SERVER['REQUEST_METHOD']);
$router = new Router();

$router->addRoute('/', 'HomeController', 'index');
$router->addRoute('/user/{id}', 'UserController', 'show');

$response = $router->dispatch($request);
$response->send();

Результат: все запросы, например /user/42, будут обработаны методом show контроллера UserController с параметром id=42.

2. .htaccess с проверкой существования файла и игнорированием некоторых путей

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/assets/   <!-- исключаем папку assets -->
RewriteRule ^(.*)$ index.php [QSA,L]

Результат: все запросы к несуществующим файлам, кроме тех, что начинаются с /assets/, направляются в index.php.

3. nginx с обработкой статики и PHP-FPM

server {
    listen 80;
    server_name example.com;
    root /var/www/html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }

    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        expires 1y;
        add_header Cache-Control public;
    }
}

Результат: статические файлы кешируются на год, PHP-запросы передаются в index.php.

4. index.php как консольный скрипт (CLI) с проверкой окружения

<?php
if (php_sapi_name() !== 'cli') {
    http_response_code(403);
    echo 'Доступ только из командной строки';
    exit;
}

// парсинг аргументов
$options = getopt('', ['action:', 'id::']);
switch ($options['action'] ?? 'help') {
    case 'migrate':
        echo "Запуск миграций...\n";
        break;
    default:
        echo "Использование: php index.php --action=migrate\n";
}

Результат: вызов php index.php --action=migrate выполнит миграции, а обращение через браузер вернёт 403.

5. Цепочка middleware в index.php

<?php
$middlewares = [
    function($request, $next) {
        // проверка авторизации
        if (!$request->hasAuth()) {
            return new Response('Unauthorized', 401);
        }
        return $next($request);
    },
    function($request, $next) {
        // логирование
        error_log($request->getMethod() . ' ' . $request->getUri());
        return $next($request);
    }
];

$app = function($request) {
    // основное приложение
    return new Response('Hello', 200);
};

$pipeline = array_reduce(array_reverse($middlewares), function($next, $middleware) {
    return function($request) use ($middleware, $next) {
        return $middleware($request, $next);
    };
}, $app);

$response = $pipeline($request);
$response->send();

Результат: запрос проходит через проверку авторизации и логирование перед выполнением основного кода.

6. Контроль версий через константу в index.php

<?php
define('APP_VERSION', '2.1.0');

// если запрошен файл с версией для кеширования (cache busting)
if (isset($_GET['v']) && $_GET['v'] === APP_VERSION) {
    // версия совпадает, можно вернуть контент с длинным кешем
    header('Cache-Control: public, max-age=31536000');
}

// подключение ресурса версиированного CSS
$cssFile = '/css/style.css?v=' . APP_VERSION;
echo '<link rel="stylesheet" href="' . $cssFile . '">';

Результат: при смене APP_VERSION браузеры будут загружать новый CSS, обходя кеш.

7. Логирование всех запросов с деталями

<?php
$logFile = __DIR__ . '/logs/access.log';
$data = [
    'time' => date('Y-m-d H:i:s'),
    'ip' => $_SERVER['REMOTE_ADDR'],
    'method' => $_SERVER['REQUEST_METHOD'],
    'uri' => $_SERVER['REQUEST_URI'],
    'user_agent' => $_SERVER['HTTP_USER_AGENT'] ?? 'unknown'
];
file_put_contents($logFile, json_encode($data) . PHP_EOL, FILE_APPEND | LOCK_EX);

// далее обработка запроса

cat logs/access.log
{"time":"2025-04-01 14:23:10","ip":"192.168.1.1","method":"GET","uri":"/home","user_agent":"Mozilla/5.0"}
{"time":"2025-04-01 14:23:11","ip":"192.168.1.2","method":"POST","uri":"/api/login","user_agent":"curl/7.68"}