Путь к классам PHP: от ручного require до PSR-4

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

Пример 1. PSR-4 с несколькими пространствами имён и поддиректориями

Структура проекта:

project/
├── composer.json
├── src/
│   ├── Controllers/
│   │   └── HomeController.php
│   ├── Models/
│   │   ├── User.php
│   │   └── Traits/
│   │       └── Timestampable.php
│   └── Services/
│       └── Mailer.php
└── public/
    └── index.php

composer.json:

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

src/Controllers/HomeController.php:

<?php
namespace App\Controllers;

class HomeController {
    public function __construct() {
        echo "HomeController загружен.
";
    }
}

src/Models/User.php (использует трейт):

<?php
namespace App\Models;

use App\Models\Traits\Timestampable;

class User {
    use Timestampable;
    public $name = 'Test User';
}

src/Models/Traits/Timestampable.php:

<?php
namespace App\Models\Traits;

trait Timestampable {
    public $created_at = '2025-04-01';
}

public/index.php:

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

use App\Controllers\HomeController;
use App\Models\User;

$ctrl = new HomeController();
$user = new User();
echo "User name: " . $user->name . "
";
echo "Created at: " . $user->created_at . "
";

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

HomeController загружен.
User name: Test User
Created at: 2025-04-01

Пример 2. Автозагрузка с помощью classmap для legacy-кода

Допустим, есть каталог old/ с классами без namespace.

old/Customer.php:

<?php
class Customer {
    public function __construct() {
        echo "Customer (old style) loaded.
";
    }
}

composer.json:

{
    "autoload": {
        "classmap": ["old/"]
    }
}

После composer dump-autoload в vendor/composer/autoload_classmap.php появится массив:

'Customer' => __DIR__ . '/../../old/Customer.php'

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

<?php
require 'vendor/autoload.php';
$c = new Customer();

Результат:

Customer (old style) loaded.

Пример 3. Собственная функция автозагрузки с кешированием путей

<?php
// Функция автозагрузки с кешированием в файл
spl_autoload_register(function ($class) {
    $cacheFile = __DIR__ . '/cache/autoload_cache.php';
    if (file_exists($cacheFile)) {
        $map = include $cacheFile;
        if (isset($map[$class])) {
            require $map[$class];
            return;
        }
    } else {
        $map = [];
    }
    // Логика преобразования (например, PSR-0 или произвольная)
    $prefix = 'MyLib_';
    if (strpos($class, $prefix) === 0) {
        $relative = substr($class, strlen($prefix));
        $file = __DIR__ . '/lib/' . str_replace('_', '/', $relative) . '.php';
        if (file_exists($file)) {
            $map[$class] = $file;
            file_put_contents($cacheFile, '<?php return ' . var_export($map, true) . ';');
            require $file;
            return;
        }
    }
    throw new Exception("Class $class not found");
});

Этот код создаёт кеш найденных путей, ускоряя последующие запросы.

Пример 4. Множественные автозагрузчики с приоритетом

Можно зарегистрировать несколько автозагрузчиков. Они вызываются в порядке регистрации, пока один из них не загрузит файл.

<?php
// Первый автозагрузчик для моделей
spl_autoload_register(function ($class) {
    if (strpos($class, 'Model\\') === 0) {
        $file = __DIR__ . '/models/' . str_replace('\\', '/', $class) . '.php';
        if (file_exists($file)) {
            require $file;
        }
    }
});

// Второй автозагрузчик для контроллеров
spl_autoload_register(function ($class) {
    if (strpos($class, 'Controller\\') === 0) {
        $file = __DIR__ . '/controllers/' . str_replace('\\', '/', $class) . '.php';
        if (file_exists($file)) {
            require $file;
        }
    }
});

// Можно добавить третий - общий
spl_autoload_register(function ($class) {
    $file = __DIR__ . '/classes/' . str_replace('\\', '/', $class) . '.php';
    if (file_exists($file)) {
        require $file;
    }
});

Результат: класс Model\User будет загружен первым автозагрузчиком, Controller\Home - вторым, а класс без префикса (например, SomeClass) - третьим, если он есть в classes/.

Пример 5. Обработка исключений при неудачной загрузке класса

<?php
spl_autoload_register(function ($class) {
    $file = __DIR__ . '/src/' . str_replace('\\', '/', $class) . '.php';
    if (!file_exists($file)) {
        // Выбрасываем исключение с подробным сообщением
        throw new RuntimeException("Unable to load class: $class (file $file not found)");
    }
    require $file;
});

try {
    $obj = new NonExistent\Class();
} catch (RuntimeException $e) {
    echo "Ошибка автозагрузки: " . $e->getMessage();
}

Результат:

Ошибка автозагрузки: Unable to load class: NonExistent\Class (file /path/src/NonExistent/Class.php not found)