Question

wp_mkdir_p( string $target )

Recursive directory creation based on full path.

---

description

Will attempt to set permissions on folders.

---

参数

$target

(string) (Required) Full path to attempt to create.

---

返回值

(bool) Whether the path was created. True if path already exists.

---

源代码

File: wp-includes/functions.php

function wp_mkdir_p( $target ) {
	$wrapper = null;

	// Strip the protocol.
	if ( wp_is_stream( $target ) ) {
		list( $wrapper, $target ) = explode( '://', $target, 2 );
	}

	// From php.net/mkdir user contributed notes.
	$target = str_replace( '//', '/', $target );

	// Put the wrapper back on the target.
	if ( $wrapper !== null ) {
		$target = $wrapper . '://' . $target;
	}

	/*
	 * Safe mode fails with a trailing slash under certain PHP versions.
	 * Use rtrim() instead of untrailingslashit to avoid formatting.php dependency.
	 */
	$target = rtrim($target, '/');
	if ( empty($target) )
		$target = '/';

	if ( file_exists( $target ) )
		return @is_dir( $target );

	// We need to find the permissions of the parent folder that exists and inherit that.
	$target_parent = dirname( $target );
	while ( '.' != $target_parent && ! is_dir( $target_parent ) ) {
		$target_parent = dirname( $target_parent );
	}

	// Get the permission bits.
	if ( $stat = @stat( $target_parent ) ) {
		$dir_perms = $stat['mode'] & 0007777;
	} else {
		$dir_perms = 0777;
	}

	if ( @mkdir( $target, $dir_perms, true ) ) {

		/*
		 * If a umask is set that modifies $dir_perms, we'll have to re-set
		 * the $dir_perms correctly with chmod()
		 */
		if ( $dir_perms != ( $dir_perms & ~umask() ) ) {
			$folder_parts = explode( '/', substr( $target, strlen( $target_parent ) + 1 ) );
			for ( $i = 1, $c = count( $folder_parts ); $i <= $c; $i++ ) {
				@chmod( $target_parent . '/' . implode( '/', array_slice( $folder_parts, 0, $i ) ), $dir_perms );
			}
		}

		return true;
	}

	return false;
}

---

更新日志

Version	description
2.0.1	Introduced.

---

相关函数

Uses

• wp-includes/functions.php: wp_is_stream()

---

Used By

• wp-admin/includes/image.php: _copy_image_file()
• wp-admin/includes/image.php: wp_crop_image()
• wp-includes/functions.php: wp_upload_bits()
• wp-includes/functions.php: wp_upload_dir()
• wp-includes/class-wp-image-editor.php: WP_Image_Editor::make_image()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note Contributed by Codex

   Basic Example

   
   if ( wp_mkdir_p( '/a/really/deep/sub/directory' ) ) {
     echo __( 'It worked! Now look for a directory named "a".', 'textdomain' );
   }