WordPress как на ладони
Новые WordPress шаблоны Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

get_file_data() WP 2.9.0

Получает данные файла указанные в PHP комментариях файла.

Ищет метаданные в первых 8kiB (6000-8000 знаков) информации файла. Данные должны быть указаны в многострочном PHP комментарии (/*данные*/), как это делается в файлах плагина или темы. Каждая часть данных должна быть на отдельной строке. В значении не должно быть переносов строк, потому что значение берется до первого переноса. См. пример 1.

Работает на раннем этапе загрузки WordPress, еще до константы SHORTINIT.

Является основой для: get_plugin_data()
✈ 1 раз = 0.000433с = быстро | 50000 раз = 0.66с = очень быстро PHP 7.0.8, WP 4.6.1
Хуки из функции:
Возвращает

Массив полученных данных из заголовка файла в формате: Ключ => Значение.

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

get_file_data( $file, $default_headers, $context );
$file(строка) (обязательный)
Полный путь до файла.
$default_headers(массив) (обязательный)

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

В формате: array( $field => $regex ), где:

  • $field - индекс возвращаемого массива, в котором будет найденное значение $regex.
  • $regex - часть регулярного выражения отвечающая за название переменной. Например, если тут указать Description, то регулярка для поиска примет такой вид: '/^[ \t\/*#@]*Description:(.*)$/mi'.

Обычно в этом параметре указывается такой формат: array('возвращаемый ключ' => 'искомый ключ в файле').

$context(строка)
Если указать любое значение, то будет срабатывать хук 'extra_{$context}_headers', через который можно дополнить параметр $default_headers.
По умолчанию: ''

Примеры

#1 Получим данные плагина

Допустим мы создали плагин и в основном файле он имеет такие комментарии:

/*
Plugin Name: Название
Description: Описание
Author: Kama
Version: 1.0
*/

Тогда, смотрите как сработает код:

// путь до основного файла плагина. В самом файле его можно получить так __FILE__
$file = '/home/site.ru/wp-content/plugins/myplugin/index.php';
$data = get_file_data( $file, array('ver'=>'Version', 'author'=>'Author', 'name'=>'Plugin Name' ) );

/* $data будет содержать:
Array
(
	[ver] => 1.0
	[author] => Kama
	[name] => Название
)
*/

#2 Динамическая версия плагина

Допустим мы пишем плагин и у нас есть Константа PLUGIN_VERSION. Каждый раз, при смене версии плагина в комментариях, нам нужно не забыть поменять её в константе. Это неудобство можно обойти использовав get_file_data(). Для этого в самом начале плагина под комментариями используем функцию:

/*
Plugin Name: Название плагина
Plugin URI: http://wp-kama.ru
Description:  Описание плагина
Author: Kama
Version: 1.0
*/
$data = get_file_data( __FILE__, array('ver'=>'Version') );
define('PLUGIN_VERSION', $data['ver'] );

Код get_file_data: wp-includes/functions.php VER 4.9.8

<?php
function get_file_data( $file, $default_headers, $context = '' ) {
	// We don't need to write to the file, so just open for reading.
	$fp = fopen( $file, 'r' );

	// Pull only the first 8kiB of the file in.
	$file_data = fread( $fp, 8192 );

	// PHP will close file handle, but we are good citizens.
	fclose( $fp );

	// Make sure we catch CR-only line endings.
	$file_data = str_replace( "\r", "\n", $file_data );

	/**
	 * Filters extra file headers by context.
	 *
	 * The dynamic portion of the hook name, `$context`, refers to
	 * the context where extra headers might be loaded.
	 *
	 * @since 2.9.0
	 *
	 * @param array $extra_context_headers Empty array by default.
	 */
	if ( $context && $extra_headers = apply_filters( "extra_{$context}_headers", array() ) ) {
		$extra_headers = array_combine( $extra_headers, $extra_headers ); // keys equal values
		$all_headers = array_merge( $extra_headers, (array) $default_headers );
	} else {
		$all_headers = $default_headers;
	}

	foreach ( $all_headers as $field => $regex ) {
		if ( preg_match( '/^[ \t\/*#@]*' . preg_quote( $regex, '/' ) . ':(.*)$/mi', $file_data, $match ) && $match[1] )
			$all_headers[ $field ] = _cleanup_header_comment( $match[1] );
		else
			$all_headers[ $field ] = '';
	}

	return $all_headers;
}

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

Из метки: Данные файлов (files data get info)

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

Комментариев нет
    Здравствуйте, !     Войти . Зарегистрироваться