path_join( string $base, string $path )

Join two filesystem paths together.

Description

For example, ‘give me $path relative to $base’. If the $path is absolute, then it the full path is returned.

Parameters

$base

(string) (Required) Base path.

$path

(string) (Required) Path relative to $base.

Return

(string) The path with the base or absolute path.

Source

File: wp-includes/functions.php 

function path_join( $base, $path ) {
	if ( path_is_absolute( $path ) ) {
		return $path;
	}

	return rtrim( $base, '/' ) . '/' . ltrim( $path, '/' );
}

Uses

Uses Description
wp-includes/functions.php: path_is_absolute()

Test if a given filesystem path is absolute.

Used By

Used By Description
wp-includes/post.php: wp_get_original_image_path()

Retrieves the path to an uploaded image file.
wp-includes/post.php: wp_get_original_image_url()

Retrieve the URL to an original attachment image.
wp-includes/post.php: wp_delete_attachment_files()

Deletes all files that belong to the given attachment.
wp-includes/functions.php: _wp_upload_dir()

A non-filtered, non-cached version of wp_upload_dir() that doesn’t check the path.
wp-admin/includes/image-edit.php: wp_restore_image()

Restores the metadata for a given attachment.
wp-admin/includes/image-edit.php: wp_save_image()

Saves image to post, along with enqueued changes in $_REQUEST['history'].
wp-admin/includes/class-wp-filesystem-base.php: WP_Filesystem_Base::search_for_folder()

Locates a folder on the remote filesystem.
wp-admin/includes/image.php: _load_image_to_edit_path()

Retrieve the path or URL of an attachment’s attached file.
wp-includes/media.php: image_get_intermediate_size()

Retrieves the image’s intermediate size (resized) path, width, and height.

Changelog

Version Description
2.5.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/path_join