Организация кода: модульная структура и роутинг на PHP

Расширенные примеры модульной архитектуры с пошаговыми пояснениями

Ниже приведены детальные примеры реализации модулей и страниц с использованием PSR-4 автозагрузки, маршрутизации и обработки запросов.

Пример 1: Полная структура мини-приложения с автозагрузкой и роутингом

Создадим проект, который выводит информацию о пользователях через REST-подобные URL.

# Структура:
myapp/
  composer.json
  public/
    index.php
    .htaccess
  src/
    Core/
      Router.php
    Module/
      User/
        Controller.php
        Repository.php
  vendor/

# .htaccess
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [QSA,L]

# composer.json
{
    "name": "myapp/demo",
    "autoload": {
        "psr-4": {
            "MyApp\\": "src/"
        }
    },
    "require": {}
}

# src/Core/Router.php
<?php
namespace MyApp\Core;

class Router {
    private array $routes = [];

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

    public function dispatch(string $method, string $uri): void {
        $uri = parse_url($uri, PHP_URL_PATH);
        foreach ($this->routes as $route) {
            if ($route['method'] !== $method) continue;
            $pattern = preg_replace('/\{([^}]+)\}/', '(?P<$1>[^/]+)', $route['pattern']);
            $pattern = '#^' . $pattern . '$#';
            if (preg_match($pattern, $uri, $matches)) {
                $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY);
                call_user_func($route['handler'], $params);
                return;
            }
        }
        http_response_code(404);
        echo '404 Not Found';
    }
}

# src/Module/User/Repository.php
<?php
namespace MyApp\Module\User;

class Repository {
    private array $data = [
        1 => ['name' => 'Alice', 'email' => 'alice@example.com'],
        2 => ['name' => 'Bob', 'email' => 'bob@example.com']
    ];

    public function find(int $id): ?array {
        return $this->data[$id] ?? null;
    }

    public function all(): array {
        return $this->data;
    }
}

# src/Module/User/Controller.php
<?php
namespace MyApp\Module\User;

class Controller {
    private Repository $repo;

    public function __construct() {
        $this->repo = new Repository();
    }

    public function list(): string {
        $users = $this->repo->all();
        $output = '<h1>Users</h1><ul>';
        foreach ($users as $id => $user) {
            $output .= "<li><a href='user/{$id}'>{$user['name']}</a></li>";
        }
        return $output . '</ul>';
    }

    public function show(int $id): string {
        $user = $this->repo->find($id);
        if (!$user) {
            return '<h1>User not found</h1>';
        }
        return "<h1>User: {$user['name']}</h1><p>Email: {$user['email']}</p>";
    }
}

# public/index.php
<?php
require_once '../vendor/autoload.php';

use MyApp\Core\Router;
use MyApp\Module\User\Controller;

$router = new Router();
$controller = new Controller();

$router->add('GET', '/', function() use ($controller) {
    echo $controller->list();
});

$router->add('GET', '/user/{id}', function(array $params) use ($controller) {
    $id = (int)$params['id'];
    echo $controller->show($id);
});

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

# Запуск: php -S localhost:8000 -t public/
  

Результат запроса GET /:

<h1>Users</h1><ul><li><a href='user/1'>Alice</a></li><li><a href='user/2'>Bob</a></li></ul>
  

Результат запроса GET /user/1:

<h1>User: Alice</h1><p>Email: alice@example.com</p>
  

Пример 2: Использование Slim Framework для модульной организации

Покажем, как разбить приложение на модули с помощью контейнера зависимостей и групп маршрутов.

# composer.json (только необходимые зависимости)
{
    "require": {
        "slim/slim": "^4.0",
        "php-di/php-di": "^7.0"
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

# src/Module/User/UserController.php
<?php
namespace App\Module\User;

use Psr\Container\ContainerInterface;
use Slim\Psr7\Response;
use Slim\Psr7\Request;

class UserController {
    private ContainerInterface $container;

    public function __construct(ContainerInterface $container) {
        $this->container = $container;
    }

    public function list(Request $request, Response $response): Response {
        $repo = $this->container->get(UserRepository::class);
        $users = $repo->all();
        $payload = json_encode($users);
        $response->getBody()->write($payload);
        return $response->withHeader('Content-Type', 'application/json');
    }

    public function show(Request $request, Response $response, array $args): Response {
        $id = (int)$args['id'];
        $repo = $this->container->get(UserRepository::class);
        $user = $repo->find($id);
        if (!$user) {
            $response->getBody()->write(json_encode(['error' => 'Not found']));
            return $response->withStatus(404)->withHeader('Content-Type', 'application/json');
        }
        $payload = json_encode($user);
        $response->getBody()->write($payload);
        return $response->withHeader('Content-Type', 'application/json');
    }
}

# src/Module/User/UserRepository.php
<?php
namespace App\Module\User;

class UserRepository {
    public function all(): array {
        return [
            ['id' => 1, 'name' => 'Alice'],
            ['id' => 2, 'name' => 'Bob']
        ];
    }

    public function find(int $id): ?array {
        foreach ($this->all() as $user) {
            if ($user['id'] === $id) return $user;
        }
        return null;
    }
}

# public/index.php
<?php
use DI\ContainerBuilder;
use Slim\Factory\AppFactory;

require_once '../vendor/autoload.php';

$containerBuilder = new ContainerBuilder();
$container = $containerBuilder->build();

AppFactory::setContainer($container);
$app = AppFactory::create();

// Регистрация репозитория
$container->set(App\Module\User\UserRepository::class, function() {
    return new App\Module\User\UserRepository();
});

// Определение маршрутов модуля User
$app->group('/users', function ($group) {
    $group->get('', [App\Module\User\UserController::class, 'list']);
    $group->get('/{id:[0-9]+}', [App\Module\User\UserController::class, 'show']);
});

$app->run();

# Запуск: php -S localhost:8000 -t public/
  

Результат запроса GET /users:

[{"id":1,"name":"Alice"},{"id":2,"name":"Bob"}]
  

Результат запроса GET /users/1:

{"id":1,"name":"Alice"}
  

Пример 3: Модульная структура с использованием Composer-пакетов

Можно вынести каждый модуль в отдельный Composer-пакет и подключать его через репозиторий. Это удобно для крупных проектов с командной разработкой.

# В корне проекта composer.json:
{
    "repositories": [
        {
            "type": "path",
            "url": "modules/*"
        }
    ],
    "require": {
        "myapp/user-module": "*"
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

# modules/user-module/composer.json
{
    "name": "myapp/user-module",
    "autoload": {
        "psr-4": {
            "MyApp\\UserModule\\": "src/"
        }
    },
    "require": {}
}

# modules/user-module/src/UserService.php
<?php
namespace MyApp\UserModule;

class UserService {
    public function greet(string $name): string {
        return "Hello, $name!";
    }
}

# public/index.php (после composer update)
<?php
require_once 'vendor/autoload.php';

$service = new MyApp\UserModule\UserService();
echo $service->greet('World');
  

Hello, World!
  

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