Управление исходным кодом PHP: от включения до автозагрузки

Расширенные примеры работы с исходным кодом PHP

1. Кастомный автозагрузчик с несколькими пространствами имён

Создадим функцию, которая обрабатывает префиксы и пути. Это полезно для сложных проектов без Composer.

<?php
spl_autoload_register(function ($class) {
    // Префиксы и соответствующие базовые директории
    $prefixes = [
        'MyApp\\' => __DIR__ . '/src/',
        'Utils\\' => __DIR__ . '/lib/',
    ];

    foreach ($prefixes as $prefix => $baseDir) {
        $len = strlen($prefix);
        if (strncmp($prefix, $class, $len) !== 0) {
            continue;
        }
        $relativeClass = substr($class, $len);
        $file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
        if (file_exists($file)) {
            require $file;
            return;
        }
    }
});

// Использование
$obj = new MyApp\Services\Mailer();
$util = new Utils\StringHelper();

// Результат: файлы загружены корректно, объекты созданы.

2. Использование Composer с classmap для оптимизации

Если в проекте много классов без namespace, можно добавить classmap в composer.json.

{
    "autoload": {
        "classmap": [
            "legacy/",
            "OldLib.php"
        ]
    }
}

После composer dump-autoload -o все классы из этих папок будут включены в карту. Это ускоряет загрузку, но требует повторной генерации при добавлении новых файлов.

// vendor/composer/autoload_classmap.php содержит массив вида
// 'OldLib' => '/var/www/OldLib.php'

3. Динамическое включение файлов на основе конфигурации

Иногда требуется подключать модули или плагины, имена которых хранятся в массиве.

<?php
$modules = ['auth', 'cache', 'logging'];

foreach ($modules as $module) {
    $file = __DIR__ . "/modules/$module.php";
    if (file_exists($file)) {
        require_once $file;
        echo "Подключён модуль $module\n";
    } else {
        echo "Предупреждение: модуль $module не найден\n";
    }
}

Подключён модуль auth
Подключён модуль cache
Предупреждение: модуль logging не найден

4. Генерация и запись PHP файла из кода

Можно создавать классы на лету, например, для кэширования конфигурации.

<?php
$classContent = <<<PHP
<?php
namespace App\Generated;

class Config
{
    public static function get()
    {
        return [
            'db' => [
                'host' => 'localhost',
            ]
        ];
    }
}
PHP;

file_put_contents(__DIR__ . '/generated/Config.php', $classContent);
require __DIR__ . '/generated/Config.php';

print_r(\App\Generated\Config::get());

Array
(
    [db] => Array
        (
            [host] => localhost
        )
)

Важно: экранируйте строки, следите за синтаксисом. Такой подход используют некоторые инструменты (Laravel Optimize).

5. Парсинг PHP кода с помощью token_get_all

Функция token_get_all разбивает исходный код на токены. Применяется для анализаторов или инструментов рефакторинга.

<?php
$code = <<<PHP
<?php
function hello() {
    echo "Hi";
}
PHP;

$tokens = token_get_all($code);
foreach ($tokens as $token) {
    if (is_array($token)) {
        echo token_name($token[0]) . ": " . htmlspecialchars($token[1]) . "\n";
    } else {
        echo "Символ: $token\n";
    }
}

T_OPEN_TAG: <?php
T_FUNCTION: function
T_WHITESPACE: 

T_STRING: hello
(
)
T_WHITESPACE: 

{
T_WHITESPACE: 
    
T_ECHO: echo
T_WHITESPACE: 
 
T_CONSTANT_ENCAPSED_STRING: "Hi"
;
T_WHITESPACE: 

}

6. Рефлексия для изучения исходного кода класса

Классы ReflectionClass и ReflectionMethod позволяют получить информацию о методах, свойствах, комментариях.

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

$ref = new ReflectionClass('App\Core\Router');
echo "Имя файла: " . $ref->getFileName() . "\n";
echo "Методы:\n";
foreach ($ref->getMethods() as $method) {
    echo " - " . $method->getName() . "\n";
}

Имя файла: /var/www/project/src/Core/Router.php
Методы:
 - __construct
 - dispatch

7. Использование debug_backtrace для отслеживания включённых файлов

Функция возвращает стек вызовов, включая файлы и строки.

<?php
function showTrace() {
    $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
    foreach ($trace as $entry) {
        echo $entry['file'] . ':' . $entry['line'] . "\n";
    }
}

// Где-то в коде
showTrace();

/var/www/index.php:12
/var/www/vendor/composer/ClassLoader.php:444