Реализация index.php: от простого к сложному

Расширенные примеры

Пример 1: Самописный роутер с поддержкой middleware

Этот пример показывает, как создать расширенный роутер, который поддерживает группы маршрутов и проверку аутентификации. Код организован в классах.

<?php
// src/Router.php
namespace App\Core;

class Router
{
    private array $routes = [];
    private array $middlewares = [];

    public function add(string $method, string $path, callable $handler, array $middlewares = []): void
    {
        $this->routes[] = compact('method', 'path', 'handler', 'middlewares');
    }

    public function get(string $path, callable $handler, array $middlewares = []): void
    {
        $this->add('GET', $path, $handler, $middlewares);
    }

    public function post(string $path, callable $handler, array $middlewares = []): void
    {
        $this->add('POST', $path, $handler, $middlewares);
    }

    public function dispatch(string $method, string $uri): void
    {
        foreach ($this->routes as $route) {
            if ($route['method'] !== $method) continue;
            $pattern = preg_replace('/\{([a-z]+)\}/', '(?P<$1>[^/]+)', $route['path']);
            $pattern = '#^' . $pattern . '$#';
            if (preg_match($pattern, $uri, $matches)) {
                // Запуск middlewares
                foreach ($route['middlewares'] as $middleware) {
                    if (is_callable($middleware)) {
                        $result = $middleware();
                        if ($result !== true) {
                            http_response_code(403);
                            echo 'Доступ запрещён';
                            return;
                        }
                    }
                }
                // Вызов обработчика
                $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY);
                call_user_func_array($route['handler'], $params);
                return;
            }
        }
        http_response_code(404);
        echo 'Страница не найдена';
    }
}

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

<?php
require 'vendor/autoload.php';

$router = new App\Core\Router();

$auth = function () {
    return isset($_SESSION['user_id']);
};

$router->get('/', function () {
    echo 'Главная страница';
}, [$auth]);

$router->get('/profile/{id}', function ($id) {
    echo "Профиль пользователя $id";
});

$router->dispatch($_SERVER['REQUEST_METHOD'], parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH));

Результат:

При запросе /profile/42 выводится: Профиль пользователя 42. При запросе / без авторизации (сессия не установлена) выводится: Доступ запрещён и код 403.

Пример 2: Работа с PDO - подготовленные запросы и транзакции

Демонстрирует безопасное добавление записи и выполнение в рамках одной транзакции.

<?php
$pdo = new PDO('mysql:host=localhost;dbname=test', 'root', '', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);

try {
    $pdo->beginTransaction();

    $stmt = $pdo->prepare('INSERT INTO users (name, email) VALUES (:name, :email)');
    $stmt->execute([':name' => 'Иван', ':email' => 'ivan@example.com']);
    $userId = $pdo->lastInsertId();

    $stmt = $pdo->prepare('INSERT INTO profiles (user_id, bio) VALUES (:uid, :bio)');
    $stmt->execute([':uid' => $userId, ':bio' => 'Привет!']);

    $pdo->commit();
    echo "Пользователь создан с ID $userId";
} catch (PDOException $e) {
    $pdo->rollBack();
    echo "Ошибка: " . $e->getMessage();
}

Результат (при успехе):

Пользователь создан с ID 1

Если вторая вставка не удалась (например, неверное поле), транзакция откатывается, и первая запись не сохраняется.

Пример 3: Управление сессиями с защитой от фиксации

Показывает полный цикл входа и выхода с регенерацией ID и установкой флагов cookie.

<?php
// В начале index.php
ini_set('session.use_strict_mode', 1);
session_set_cookie_params([
    'lifetime' => 0,
    'path' => '/',
    'domain' => '',
    'secure' => isset($_SERVER['HTTPS']),
    'httponly' => true,
    'samesite' => 'Lax',
]);
session_start();

// Функция входа
function login(int $userId, string $username): void
{
    session_regenerate_id(true);
    $_SESSION['user_id'] = $userId;
    $_SESSION['username'] = $username;
    $_SESSION['login_time'] = time();
    setcookie('session_created', time(), [
        'expires' => time() + 86400,
        'path' => '/',
        'secure' => isset($_SERVER['HTTPS']),
        'httponly' => true,
        'samesite' => 'Lax',
    ]);
}

// Функция выхода
function logout(): void
{
    $_SESSION = [];
    if (ini_get('session.use_cookies')) {
        $params = session_get_cookie_params();
        setcookie(session_name(), '', time() - 42000,
            $params['path'], $params['domain'],
            $params['secure'], $params['httponly']
        );
    }
    session_destroy();
    header('Location: /login');
    exit;
}

// Пример использования
if (isset($_POST['login'])) {
    // ... проверка пароля
    login($id, $username);
}

Результат:

После успешного входа идентификатор сессии меняется (можно проверить через cookie). При выходе сессия уничтожается, cookie очищается.

Пример 4: Шаблонизатор Twig с наследованием и фильтрами

Создадим базовый шаблон и дочерний.

Файл templates/base.html.twig:

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>{% block title %}Мой сайт{% endblock %}</title>
</head>
<body>
    <header>{% block header %}Шапка{% endblock %}</header>
    <main>{% block content %}{% endblock %}</main>
    <footer>{% block footer %}Подвал{% endblock %}</footer>
</body>
</html>

Файл templates/index.html.twig:

{% extends 'base.html.twig' %}

{% block title %}Главная - {{ parent() }}{% endblock %}
{% block content %}
    <h1>Добро пожаловать, {{ name|e }}!</h1>
    <p>Сегодня {{ 'now'|date('d.m.Y') }}</p>
{% endblock %}

Код index.php:

<?php
require 'vendor/autoload.php';

$loader = new \Twig\Loader\FilesystemLoader(__DIR__ . '/templates');
$twig = new \Twig\Environment($loader);
echo $twig->render('index.html.twig', ['name' => 'Мир']);

Результат (HTML):

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Главная - Мой сайт</title>
</head>
<body>
    <header>Шапка</header>
    <main>
        <h1>Добро пожаловать, Мир!</h1>
        <p>Сегодня 15.03.2025</p>
    </main>
    <footer>Подвал</footer>
</body>
</html>

Пример 5: Обработка ошибок и исключений в index.php

Глобальный обработчик для отлова всех исключений и вывода пользователю дружественного сообщения.

<?php
// index.php в начале
set_error_handler(function ($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) {
        return;
    }
    throw new ErrorException($message, 0, $severity, $file, $line);
});

set_exception_handler(function (Throwable $e) {
    http_response_code(500);
    if (ini_get('display_errors')) {
        echo "<h1>Ошибка приложения</h1>";
        echo "<p>" . htmlspecialchars($e->getMessage()) . "</p>";
        echo "<pre>" . htmlspecialchars($e->getTraceAsString()) . "</pre>";
    } else {
        // Логирование в файл
        error_log($e->getMessage() . ' in ' . $e->getFile() . ' on line ' . $e->getLine());
        echo "<h1>Внутренняя ошибка сервера</h1>";
    }
    exit;
});

// Далее идет код приложения
// ...

Результат:

При возникновении исключения (например, деление на ноль) будет показана либо подробная информация (в режиме разработки), либо общее сообщение (в продакшене), а ошибка записана в лог.