Kama и campusboy7 месяцев назад3 EN

wp_get_attachment_url() │ WP 2.1.0

Получает УРЛ вложения по переданному ID вложения. Получает ссылку на файл.

Под вложением подразумевается, любой файл добавленный в медиатеку: картинка, архив, видео и т.д. Не важно прикреплено вложение к посту или нет.

Функция не очищает получаемый URL. Если вложение имеет неправильные символы в имени или URL, то следует очистить URL через rawurlencode().

Например, получим относительный путь файла:

$url  = wp_get_attachment_url( $attachment->ID );
$path = parse_url( $url )['path'];
$relative = dirname( $path ) . '/' . rawurlencode( basename( $path ) );

Используйте get_attachment_link(), когда нужно получить ссылку на страницу вложения, а не на само вложение.

Работает на основе: get_post_meta(), wp_get_upload_dir()
Основа для: get_header_video_url(), image_downsize(), wp_get_attachment_link()
1 раз — 0.0009661 сек (медленно) | 50000 раз — 0.28 сек (очень быстро) | PHP 7.3.12, WP 5.3.2
Хуки из функции

Возвращает

Строку|false. УРЛ вложения или false, если УРЛ получить не удалось.

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

wp_get_attachment_url( $attachment_id );
$attachment_id(число)
ID вложения, УРЛ которого нужно получить.
По умолчанию: 0 (текущий пост)

Примеры

0

#1 Получим ссылку на вложение

Допустим мы добавили в медиатеку картинку и она получила ID 55, тогда ссылку на эту картинку мы может получить так:

$image_url = wp_get_attachment_url( 55 );
echo $image_url;

// Вернет: http://example.com/wp-content/uploads/image.png
0

#2 Выведем картинку прикрепленную к посту

Допустим мы хотим вывести картинку прикрепленную к посту 5. Тогда сначала мы должны узнать ID вложения (прикрепленной картинки), а затем вывести картинку:

// Получим ID вложения поста 5
$id = 5;
$attachment_image = get_children( array(
	'numberposts' => 1,
	'post_mime_type' => 'image',
	'post_parent' => $id,
	'post_type' => 'attachment'
) );

// вынимаем первую картинку из массива
$attachment_image = array_shift($attachment_image);

$img = '<img src="' . wp_get_attachment_url( $attachment_image->ID ) . '" alt="" />';

echo $img;

// вернет:
// <img src="http://example.com/wp-content/uploads/2011/07/robots.txt.jpg" alt="" />
0

#3 Вложение записи как фоновая картинка в цикле 

if( have_posts() ){
	while( have_posts() ){
		the_post();
		if( has_post_thumbnail() ){
			$feat_image_url = wp_get_attachment_url( get_post_thumbnail_id() );
			echo '<div style="background-image:url('. $feat_image_url .');"></div>';
		}
	}
}

Заметки

  • Global. Строка. $pagenow The filename of the current screen.

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

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

Код wp_get_attachment_url() WP 6.9.1

wp-includes/post.php 
function wp_get_attachment_url( $attachment_id = 0 ) {
	global $pagenow;

	$attachment_id = (int) $attachment_id;

	$post = get_post( $attachment_id );

	if ( ! $post ) {
		return false;
	}

	if ( 'attachment' !== $post->post_type ) {
		return false;
	}

	$url = '';
	// Get attached file.
	$file = get_post_meta( $post->ID, '_wp_attached_file', true );
	if ( $file ) {
		// Get upload directory.
		$uploads = wp_get_upload_dir();
		if ( $uploads && false === $uploads['error'] ) {
			// Check that the upload base exists in the file location.
			if ( str_starts_with( $file, $uploads['basedir'] ) ) {
				// Replace file location with url location.
				$url = str_replace( $uploads['basedir'], $uploads['baseurl'], $file );
			} elseif ( str_contains( $file, 'wp-content/uploads' ) ) {
				// Get the directory name relative to the basedir (back compat for pre-2.7 uploads).
				$url = trailingslashit( $uploads['baseurl'] . '/' . _wp_get_attachment_relative_path( $file ) ) . wp_basename( $file );
			} else {
				// It's a newly-uploaded file, therefore $file is relative to the basedir.
				$url = $uploads['baseurl'] . "/$file";
			}
		}
	}

	/*
	 * If any of the above options failed, Fallback on the GUID as used pre-2.7,
	 * not recommended to rely upon this.
	 */
	if ( ! $url ) {
		$url = get_the_guid( $post->ID );
	}

	// On SSL front end, URLs should be HTTPS.
	if ( is_ssl() && ! is_admin() && 'wp-login.php' !== $pagenow ) {
		$url = set_url_scheme( $url );
	}

	/**
	 * Filters the attachment URL.
	 *
	 * @since 2.1.0
	 *
	 * @param string $url           URL for the given attachment.
	 * @param int    $attachment_id Attachment post ID.
	 */
	$url = apply_filters( 'wp_get_attachment_url', $url, $post->ID );

	if ( ! $url ) {
		return false;
	}

	return $url;
}

image (не функции миниатюр)

wp_attachment image (картинки вложения)

Вложения (media файлы)

3 комментария