plugin_dir_path() WP 2.8

Получает системный путь до директории, где находится указанный файл (со слэшем на конце).

Функция создана для удобного использования конструкции:

trailingslashit( dirname( $file ) );

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

Хуков нет.

Возвращает

Строку. Полный путь в системе до директории в которой лежит указанный файл.

Использование

plugin_dir_path( $file );

$file(строка) (обязательный)

Полный путь до файла. Обычно используется волшебная константа __FILE__.

Примеры

#1. Получим директорию текущего файла

Предполагается, что функция вызывается из файла плагина, который называется my-plugin:

$dir = plugin_dir_path( __FILE__ );
echo $dir;

// Получим: 
// /home/user/var/www/wordpress/wp-content/plugins/my-plugin/

#2. Подключим все PHP файлы из поддиректории плагина

foreach ( glob( plugin_dir_path( __FILE__ )."subfolder/*.php" ) as $file ){
	include_once $file;
}

Заметка

С помощью этой функции можно надежно определить путь до каталога плагинов, удалив основную директорию плагина из строки (эквивалент не существующей функции plugins_dir_path()).

Список изменений

Код plugin dir path: wp-includes/plugin.php ^{WP 5.3}

<?php
function plugin_dir_path( $file ) {
	return trailingslashit( dirname( $file ) );
}

Cвязанные функции

Из метки: path directory (путь папка)

Еще из раздела: Плагины, хуки