Разработка PHP приложения: структура, инструменты, настройка

Расширенные примеры и сценарии использования

Создание собственного автозагрузчика с регистрацией

Если стандартный composer dump-autoload не подходит, можно реализовать автозагрузку через spl_autoload_register с дополнительной логикой.

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

class Loader
{
    public static function register()
    {
        spl_autoload_register(function ($class) {
            $prefix = 'App\\';
            $baseDir = __DIR__ . '/../../src/';
            $len = strlen($prefix);
            if (strncmp($prefix, $class, $len) !== 0) {
                return;
            }
            $relativeClass = substr($class, $len);
            $file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
            if (file_exists($file)) {
                require $file;
            } else {
                throw new \RuntimeException("Class $class not found in $file");
            }
        });
    }
}

// index.php
require 'src/Core/Loader.php';
\App\Core\Loader::register();
\App\Models\User::greet();

Результат: при обращении к любому классу из пространства имён App будет подключаться соответствующий файл. Ошибка генерируется при отсутствии файла.

Привет от User!

Автоматизация через Composer scripts

В секцию scripts файла composer.json можно добавить команды, выполняемые при определённых событиях. Например, очистка кэша после обновления зависимостей.

{
  "scripts": {
    "post-update-cmd": [
      "@clear-cache"
    ],
    "pre-install-cmd": [
      "echo 'Начало установки зависимостей'"
    ],
    "clear-cache": "rm -rf var/cache/*"
  }
}

Результат: после выполнения composer update автоматически очистится папка var/cache. Команды можно задавать как строку, так и массив.

Настройка файла .env с библиотекой phpdotenv

Библиотека vlucas/phpdotenv позволяет загружать переменные окружения из файла .env в массив $_ENV или getenv().

composer require vlucas/phpdotenv

Создайте .env:

DB_HOST=127.0.0.1
DB_NAME=test
DB_USER=root
DB_PASS=secret

Загрузите в точке входа:

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

$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();

echo 'Подключение к ' . $_ENV['DB_HOST'] . '...';

Результат: в выводе появится Подключение к 127.0.0.1.... Если файл .env отсутствует, будет выброшено исключение (Dotenv\Exception\InvalidPathException).

Makefile для типичных задач

Утилита make помогает стандартизировать команды разработки. Пример Makefile для PHP проекта:

.PHONY: install test clean

install:
	composer install --no-dev --optimize-autoloader

test:
	php vendor/bin/phpunit --testdox

clean:
	rm -rf vendor composer.lock .env

serve:
	php -S localhost:8000 -t public

Теперь можно выполнять make install, make test и т.д. Результат: минимализация ручного ввода команд и снижение вероятности ошибок.

Интеграция PHPUnit с автозагрузкой проекта

Добавьте PHPUnit через Composer в раздел require-dev:

composer require --dev phpunit/phpunit

Конфигурация phpunit.xml:

<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="vendor/autoload.php">
    <testsuites>
        <testsuite name="Unit">
            <directory>tests/Unit</directory>
        </testsuite>
    </testsuites>
</phpunit>

Пример теста tests/Unit/UserTest.php:

<?php
use PHPUnit\Framework\TestCase;
use App\Models\User;

class UserTest extends TestCase
{
    public function testGreet()
    {
        $user = new User();
        $this->assertEquals('Hello', $user->greet());
    }
}

Результат: запуск vendor/bin/phpunit выведет отчёт о прохождении тестов, основанный на автозагрузке Composer.

PHPUnit 10.x.y
✓ User → testGreet
Time: 0.01 seconds, Memory: 4.00 MB
OK (1 test, 1 assertion)