get_attached_file() │ WP 2.0.0

Retrieve attached file path based on attachment ID.

By default the path will go through the get_attached_file but passing a true to the $unfiltered argument of get_attached_file() will return the file path unfiltered.

The function works by getting the single post meta name, named '_wp_attached_file' and returning it. This is a convenience function to prevent looking up the meta name and provide a mechanism for sending the attached filename through a filter.

Uses: get_post_meta()
Used By: wp_maybe_generate_attachment_metadata(), wp_get_original_image_path()
1 time — 0.000594 sec (slow) | 50000 times — 0.41 sec (very fast) | PHP 7.0.8, WP 4.6
Hooks from the function

Return

String|false. The file path to where the attached file should be, false otherwise.

Usage

get_attached_file( $attachment_id, $unfiltered );
$attachment_id(int) (required)
Attachment ID.
$unfiltered(true|false)
Whether to apply filters.
Default: false

Examples

0

#1 Get the full path to the attachment file 

$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

Changelog

Since 2.0.0 Introduced.

get_attached_file() code WP 6.1.1

wp-includes/post.php 
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 && 0 !== strpos( $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 );
}

path (directory folder)

Attachments (Media files)