' gradientUnits='userSpaceOnUse'%3E%3Cstop offset='0' stop-color='%232aabee'/%3E%3Cstop offset='1' stop-color='%23229ed9'/%3E%3C/linearGradient%3E%3Ccircle cx='120.1' cy='120.1' r='120.1' fill='url(%23a)' fill-rule='evenodd' clip-rule='evenodd'/%3E%3Cpath fill='%23FFF' fill-rule='evenodd' d='M54.3 118.8c35-15.2 58.3-25.3 70-30.2 33.3-13.9 40.3-16.3 44.8-16.4 1 0 3.2.2 4.7 1.4 1.2 1 1.5 2.3 1.7 3.3s.4 3.1.2 4.7c-1.8 19-9.6 65.1-13.6 86.3-1.7 9-5 12-8.2 12.3-7 .6-12.3-4.6-19-9-10.6-6.9-16.5-11.2-26.8-18-11.9-7.8-4.2-12.1 2.6-19.1 1.8-1.8 32.5-29.8 33.1-32.3.1-.3.1-1.5-.6-2.1-.7-.6-1.7-.4-2.5-.2-1.1.2-17.9 11.4-50.6 33.5-4.8 3.3-9.1 4.9-13 4.8-4.3-.1-12.5-2.4-18.7-4.4-7.5-2.4-13.5-3.7-13-7.9.3-2.2 3.3-4.4 8.9-6.7z' clip-rule='evenodd'/%3E%3C/svg%3E)
Автозагрузка классов для WordPress
Если вы используете у себя в проектах сотни require или include, то вам точно стоит прочесть эту статью.
Зачем нужна автозагрузка?
Автозагрузка (autoload) нужна для того, чтобы навсегда избавится от require, include и постоянного изменения порядка их подключения.
Рассмотрим два вариант autoload:
- composer
- spl_autoload
Autoload своих классов через composer
В файл composer.json нужно добавить директиву autoload и в нее classmap с перечнем папок, в которых нужно искать классы, интерфейсы и прочее.
{
...
"autoload": {
"classmap": [
"folder1",
"folder2"
]
}
...
}
После этого нужно обязательно обновить autoload composer’а с помощью следующей команды:
composer dump-autoload
Или
composer dumpautoload
После этого в /vendor/composer/autoload_classmap.php появляется массив ключ=значение, где ключ — это полное название класса, а значение — это путь к данному классу. Сам файл выглядит примерно так:
// autoload_classmap.php @generated by Composer
$vendorDir = dirname(dirname(__FILE__));
$baseDir = dirname($vendorDir);
return array(
'My_Namespace\\Example1' => $baseDir . '/folder1/class-example1.php',
'My_Namespace\\Example2' => $baseDir . '/folder2/class-example2.php',
);
Свой автозагрузчик с помощью spl_autoload
Иногда проект может быть достаточно большой включать в себя плагины, mu-плагины и темы. При работе с мультисайтом/ами вполне возможна такая ситуация.
Столкнувшись с такой проблемой, решил сделать небольшой mu-плагин, который будет подгружать все нужные мне файлы сам. Решил отойти от composer’а, чтобы не тянуть его везде, где он мне нужен.
Меняем namespace на путь к файлу
Следующий пример написан с соблюдением WPCS:
class Autoload {
private $prefix = 'My_Namespace';
public function __construct() {
spl_autoload_register( [ $this, 'autoload' ] );
}
private function autoload( string $class ): void {
if ( 0 === strpos( $class, $this->prefix ) ) {
$plugin_parts = explode( '\\', $class );
$name = array_pop( $plugin_parts );
$name = preg_match( '/^(Interface|Trait)/', $name )
? $name . '.php'
: 'class-' . $name . '.php';
$path = implode( '/', $plugin_parts ) . '/' . $name;
$path = strtolower( str_replace( [ '\\', '_' ], [ '/', '-' ], $path ) );
$path = WP_CONTENT_DIR . '/plugins/' . $path;
require_once $path;
}
}
}
new Autoload();
С помощью ф-ции spl_autoload_register мы добавляем autoload, который будет срабатывать каждый раз, когда вызывается неизвестная ф-ция, класс или интерфейс.
Обязательно проверяем на то, чтобы все классы начинались с $this->prefix, который в примере My_Namespace. Затем формируем нужный путь к файлу и подключаем его. Все вроде бы хорошо, но есть одна проблема с тем, что при большом кол-ве классов слишком много действий вместо просто подключения файлов. Для этого нужно сделать механизм кеширования. Попробуем сделать что-то, вроде classmap от composer’а.
Classmap для spl_autoload
class Autoload {
private $map_file;
private $map;
private $prefix = 'My_Namespace';
private $has_been_update = false;
public function __construct() {
$this->map_file = __DIR__ . '/classmap.php';
$this->map = @include $this->map_file;
$this->map = is_array( $this->map ) ? $this->map : [];
spl_autoload_register( [ $this, 'autoload' ] );
add_action( 'shutdown', [ $this, 'update_cache' ] );
}
private function autoload( string $class ): void {
if ( 0 === strpos( $class, $this->prefix ) ) {
if ( $this->map[ $class ] && file_exists( $this->map[ $class ] ) ) {
require_once $this->map[ $class ];
} else {
$this->has_been_update = true;
$plugin_parts = explode( '\\', $class );
$name = array_pop( $plugin_parts );
$name = preg_match( '/^(Interface|Trait)/', $name )
? $name . '.php'
: 'class-' . $name . '.php';
$path = implode( '/', $plugin_parts ) . '/' . $name;
$path = strtolower( str_replace( [ '\\', '_' ], [ '/', '-' ], $path ) );
$path = WP_CONTENT_DIR . '/plugins/' . $path;
$this->map[ $class ] = $path;
require_once $path;
}
}
}
public function update_cache(): void {
if ( ! $this->has_been_update ) {
return;
}
$map = implode(
"\n",
array_map(
function ( $k, $v ) {
return "'$k' => '$v',";
},
array_keys( $this->map ),
array_values( $this->map )
)
);
file_put_contents( $this->map_file, '<?php return [' . $map . '];' );
}
}
Добавляем 3 свойства:
- $map_file — путь к файлу classmap
- $map — classmap
- $has_been_update — свойство, которое проверяет обновился ли classmap с последней загрузки страницы.
Метод autoload немного поменялся. Вот основные отличия:
if ( $this->map[ $class ] && file_exists( $this->map[ $class ] ) ) {
// Подключаем файл, который мы нашли в classmap. Проверка file_exists нужна на случай, если мы захотим удалить, переместить или переименовать файл.
} else {
$this->has_been_update = true; // classmap нужно обновить
...
$this->map[ $class ] = $path; // Обновляем classmap
...
}
В метод update_cache, который срабатывает на событие shutdown обновляем сам файл classmap’а, если он был изменен с последней загрузки.
Полный пример кода с поддержкой WPCS можно посмотреть на github’e: https://github.com/mdenisenko/WP-Autoload
Источник: WP Punk.
