WordPress как на ладони

get_attached_file()WP 2.0.0

Получает абсолютный (серверный) путь вложения (прикрепленного файла) по переданному ID вложения.

Путь находится в произвольном поле вложения: _wp_attached_file. Функция просто получает значение этого поля и объединяет его с wp_upload_dir().

Используйте wp_get_attachment_url(), чтобы получить URL, к файлу вложения, а не его путь.

Работает на основе: get_post_meta()
1 раз — 0.000594 сек (медленно) | 50000 раз — 0.41 сек (очень быстро) | PHP 7.0.8, WP 4.6
Хуки из функции

Возвращает

Строку|false. Путь до прикрепленного файла или false, если не удалось получить путь.

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

get_attached_file( $attachment_id, $unfiltered );
$attachment_id(число) (обязательный)
ID вложения, путь до которого нужно получить.
$unfiltered(логический)
По умолчанию полученный путь обрабатывается фильтром get_attached_file, но если указать в этом параметре true, то путь не будет фильтроваться.
По умолчанию: false

Примеры

1

#1 Получим полный путь до файла вложения

$attach_id = 5;

$attached_path = get_attached_file( $attach_id );
//> /home/www/example.com/wp-content/uploads/2014/11/file_name.png

$filename = basename( $attached_path ); 
//> file_name.png

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

С версии 2.0.0 Введена.

Код get_attached_file() WP 6.5.2

function get_attached_file( $attachment_id, $unfiltered = false ) {
	$file = get_post_meta( $attachment_id, '_wp_attached_file', true );

	// If the file is relative, prepend upload dir.
	if ( $file && ! str_starts_with( $file, '/' ) && ! preg_match( '|^.:\\\|', $file ) ) {
		$uploads = wp_get_upload_dir();
		if ( false === $uploads['error'] ) {
			$file = $uploads['basedir'] . "/$file";
		}
	}

	if ( $unfiltered ) {
		return $file;
	}

	/**
	 * Filters the attached file based on the given ID.
	 *
	 * @since 2.1.0
	 *
	 * @param string|false $file          The file path to where the attached file should be, false otherwise.
	 * @param int          $attachment_id Attachment ID.
	 */
	return apply_filters( 'get_attached_file', $file, $attachment_id );
}
5 комментариев
    Войти