Построение веб-приложения на PHP: обзор архитектурных решений

Развернутые примеры реализации компонентов

Маршрутизатор с middleware и группами

Расширенный маршрутизатор поддерживает добавление промежуточного ПО (middleware) и группировку путей. Пример на основе паттерна цепочки обязанностей.

interface MiddlewareInterface {
  public function handle(Request $request, callable $next): Response;
}

class AuthMiddleware implements MiddlewareInterface {
  public function handle(Request $request, callable $next): Response {
    if (!$request->hasUser()) {
      return new Response('Не авторизован', 403);
    }
    return $next($request);
  }
}

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

  public function addMiddleware(MiddlewareInterface $middleware): void {
    $this->globalMiddlewares[] = $middleware;
  }

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

  public function dispatch(Request $request): Response {
    $uri = $request->getUri();
    $method = $request->getMethod();

    foreach ($this->routes as $route) {
      if ($route['method'] !== $method) continue;
      $regex = preg_replace('/\{([a-z]+)\}/', '(?P<$1>[^/]+)', $route['pattern']);
      if (preg_match("~^$regex$~", $uri, $matches)) {
        $request->setParams(array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY));
        $handler = $route['handler'];
        foreach (array_merge($this->globalMiddlewares, $route['middlewares']) as $middleware) {
          $handler = function ($req) use ($middleware, $handler) {
            return $middleware->handle($req, $handler);
          };
        }
        return $handler($request);
      }
    }
    return new Response('Страница не найдена', 404);
  }
}

Результат: при обращении к защищенному маршруту без аутентификации будет возвращена ошибка 403.

HTTP 403 Forbidden
Не авторизован

Работа с базой данных через PDO и подготовленные запросы

Безопасное взаимодействие с MySQL с использованием подготовленных выражений предотвращает SQL-инъекции.

class Database {
  private PDO $pdo;

  public function __construct(string $dsn, string $user, string $pass) {
    $this->pdo = new PDO($dsn, $user, $pass, [
      PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
      PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    ]);
  }

  public function findById(string $table, int $id): ?array {
    $stmt = $this->pdo->prepare("SELECT * FROM $table WHERE id = :id");
    $stmt->execute([':id' => $id]);
    $result = $stmt->fetch();
    return $result ?: null;
  }

  public function insert(string $table, array $data): int {
    $columns = implode(', ', array_keys($data));
    $placeholders = ':' . implode(', :', array_keys($data));
    $stmt = $this->pdo->prepare("INSERT INTO $table ($columns) VALUES ($placeholders)");
    $stmt->execute($data);
    return (int) $this->pdo->lastInsertId();
  }
}

Пример использования:

$db = new Database('mysql:host=localhost;dbname=test', 'root', '');
$user = $db->findById('users', 42);
if ($user) {
  echo 'Имя: ' . htmlspecialchars($user['name']);
} else {
  echo 'Пользователь не найден';
}

Результат (при наличии пользователя с id=42):

Имя: Иван

Команда для создания и выполнения миграций (без фреймворка)

Скрипт миграций позволяет версионировать изменения схемы БД.

<?php
// migrate.php
$migrationsDir = __DIR__ . '/migrations';
$files = scandir($migrationsDir);
$db = new PDO('mysql:host=localhost;dbname=test', 'root', '');
// Создать таблицу для отслеживания выполненных миграций
$db->exec("CREATE TABLE IF NOT EXISTS migrations (id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(255) UNIQUE)");
foreach ($files as $file) {
  if (pathinfo($file, PATHINFO_EXTENSION) === 'sql') {
    $stmt = $db->prepare("SELECT COUNT(*) FROM migrations WHERE name = :name");
    $stmt->execute([':name' => $file]);
    if ($stmt->fetchColumn() == 0) {
      $sql = file_get_contents($migrationsDir . '/' . $file);
      $db->exec($sql);
      $stmt = $db->prepare("INSERT INTO migrations (name) VALUES (:name)");
      $stmt->execute([':name' => $file]);
      echo "Выполнена миграция: $file\n";
    }
  }
}

Пример файла миграции 001_create_users.sql:

CREATE TABLE users (
  id INT AUTO_INCREMENT PRIMARY KEY,
  name VARCHAR(255) NOT NULL,
  email VARCHAR(255) UNIQUE NOT NULL
);

Результат выполнения:

Выполнена миграция: 001_create_users.sql

Реализация шаблонизатора с поддержкой блоков и наследования

Собственный шаблонизатор на PHP может заменить Blade в небольших проектах.

class Template {
  private string $basePath;

  public function __construct(string $basePath) {
    $this->basePath = rtrim($basePath, '/') . '/';
  }

  public function render(string $template, array $data = []): string {
    ob_start();
    extract($data);
    include $this->basePath . $template . '.php';
    return ob_get_clean();
  }
}

// Использование шаблона с секциями
// layout.php:
// <html><head><title><?= $title ?></title></head><body><?= $content ?></body></html>

// content.php:
// <?php $title = 'Главная'; ob_start(); ?>
// <h1>Добро пожаловать</h1>
// <?php $content = ob_get_clean(); include 'layout.php'; ?>

$tpl = new Template(__DIR__ . '/views');
echo $tpl->render('content');

Результат:

<html><head><title>Главная</title></head><body><h1>Добро пожаловать</h1></body></html>

Валидация входящих данных

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

class Validator {
  private array $errors = [];

  public function validate(array $data, array $rules): bool {
    foreach ($rules as $field => $ruleSet) {
      foreach ($ruleSet as $rule) {
        if ($rule === 'required' && empty($data[$field])) {
          $this->errors[$field][] = 'Поле обязательно';
        }
        if ($rule === 'email' && !empty($data[$field]) && !filter_var($data[$field], FILTER_VALIDATE_EMAIL)) {
          $this->errors[$field][] = 'Некорректный email';
        }
      }
    }
    return empty($this->errors);
  }

  public function getErrors(): array {
    return $this->errors;
  }
}

Пример:

$validator = new Validator();
$data = ['name' => '', 'email' => 'invalid'];
$rules = ['name' => ['required'], 'email' => ['required', 'email']];
if (!$validator->validate($data, $rules)) {
  print_r($validator->getErrors());
}

Результат:

Array
(
    [name] => Array
        (
            [0] => Поле обязательно
        )
    [email] => Array
        (
            [0] => Поле обязательно
            [1] => Некорректный email
        )
)