# _copy_image_file()

URL: https://chugunov.pro/api-wordpress/functions/_copy_image_file/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.4.0.

## Сигнатура

```php
_copy_image_file( int $attachment_id ): string|false
```

## Описание

Копирует существующий файл изображения.

## Параметры

- `$attachment_id` `int` — обязательный. Идентификатор вложения.

## Возвращаемое значение

`string|false`

## Исходный код

Файл: `wp-admin/includes/image.php:1333`

```php
function _copy_image_file( $attachment_id ) {
	$dst_file = get_attached_file( $attachment_id );
	$src_file = $dst_file;

	if ( ! file_exists( $src_file ) ) {
		$src_file = _load_image_to_edit_path( $attachment_id );
	}

	if ( $src_file ) {
		$dst_file = str_replace( wp_basename( $dst_file ), 'copy-' . wp_basename( $dst_file ), $dst_file );
		$dst_file = dirname( $dst_file ) . '/' . wp_unique_filename( dirname( $dst_file ), wp_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;
}
```

## История изменений

- 3.4.0 — Introduced.

## Связанные

Использует: [`_load_image_to_edit_path`](https://chugunov.pro/api-wordpress/functions/_load_image_to_edit_path/), [`wp_unique_filename`](https://chugunov.pro/api-wordpress/functions/wp_unique_filename/), [`wp_mkdir_p`](https://chugunov.pro/api-wordpress/functions/wp_mkdir_p/), [`get_attached_file`](https://chugunov.pro/api-wordpress/functions/get_attached_file/), [`wp_basename`](https://chugunov.pro/api-wordpress/functions/wp_basename/).
Используется в: `Custom_Image_Header::step_3`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/_copy_image_file/