функция
since 3.5.0
wp_get_image_editor()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
wp_get_image_editor( string $path, array $args = array() ): WP_Image_Editor|WP_Error
Описание
Возвращает экземпляр WP_Image_Editor и загружает в него файл.
Параметры
$path
string
обязательный
Путь к загружаемому файлу.
$args
array
необязательный
= array()
Дополнительные аргументы для получения редактора изображений.
Возвращаемое значение
WP_Image_Editor|WP_Error
WP_Image_Editor WP_Error
Исходный код
wp-includes/media.php:4214
function wp_get_image_editor( $path, $args = array() ) {
$args['path'] = $path;
// If the mime type is not set in args, try to extract and set it from the file.
if ( ! isset( $args['mime_type'] ) ) {
$file_info = wp_check_filetype( $args['path'] );
/*
* If $file_info['type'] is false, then we let the editor attempt to
* figure out the file type, rather than forcing a failure based on extension.
*/
if ( isset( $file_info ) && $file_info['type'] ) {
$args['mime_type'] = $file_info['type'];
}
}
// Check and set the output mime type mapped to the input type.
if ( isset( $args['mime_type'] ) ) {
$output_format = wp_get_image_editor_output_format( $path, $args['mime_type'] );
if ( isset( $output_format[ $args['mime_type'] ] ) ) {
$args['output_mime_type'] = $output_format[ $args['mime_type'] ];
}
}
$implementation = _wp_image_editor_choose( $args );
if ( $implementation ) {
$editor = new $implementation( $path );
$loaded = $editor->load();
if ( is_wp_error( $loaded ) ) {
return $loaded;
}
return $editor;
}
return new WP_Error( 'image_no_editor', __( 'No editor could be selected.' ) );
}
История изменений
| Версия | Описание |
|---|---|
| 3.5.0 | Introduced. |

