复制现有图像文件。

原型

_copy_image_file( string $attachment_id )

参数

$attachment_id (string) (Required) 附件ID。

返回值

(string|false)  成功时的新文件路径,失败时为false。

源文件

路径:wp-admin/includes/image.php

<?php
...
function _copy_image_file( $attachment_id ) {
	$dst_file = $src_file = get_attached_file( $attachment_id );
	if ( ! file_exists( $src_file ) )
		$src_file = _load_image_to_edit_path( $attachment_id );
	if ( $src_file ) {
		$dst_file = str_replace( basename( $dst_file ), 'copy-' . basename( $dst_file ), $dst_file );
		$dst_file = dirname( $dst_file ) . '/' . wp_unique_filename( dirname( $dst_file ), basename( $dst_file ) );
		/*
		 * The directory containing the original file may no longer
		 * exist when using a replication plugin.
		 */
		wp_mkdir_p( dirname( $dst_file ) );
		if ( ! @copy( $src_file, $dst_file ) )
			$dst_file = false;
	} else {
		$dst_file = false;
	}
	return $dst_file;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/_copy_image_file/