/**

const WP_CLEAR_OBJECT_CACHE_INTERVAL = 500;

/**

private $destination_dir;

/**

public function regenerate( $args, $assoc_args = array() ) {

$assoc_args = wp_parse_args(

$assoc_args,

[ 'image_size' => '' ]

);

$image_size = $assoc_args['image_size'];

if ( $image_size && ! in_array( $image_size, get_intermediate_image_sizes(), true ) ) {

WP_CLI::error( sprintf( 'Unknown image size "%s".', $image_size ) );

}

if ( empty( $args ) ) {

if ( $image_size ) {

WP_CLI::confirm( sprintf( 'Do you really want to regenerate the "%s" image size for all images?', $image_size ), $assoc_args );

} else {

WP_CLI::confirm( 'Do you really want to regenerate all images?', $assoc_args );

}

}

$skip_delete = Utils\get_flag_value( $assoc_args, 'skip-delete' );

$only_missing = Utils\get_flag_value( $assoc_args, 'only-missing' );

if ( $only_missing ) {

$skip_delete = true;

}

$delete_unknown = Utils\get_flag_value( $assoc_args, 'delete-unknown' );

if ( $delete_unknown ) {

$skip_delete = false;

}

$additional_mime_types = array();

if ( Utils\wp_version_compare( '4.7', '>=' ) ) {

$additional_mime_types[] = 'application/pdf';

}

$images = $this->get_images( $args, $additional_mime_types );

$count = $images->post_count;

if ( ! $count ) {

WP_CLI::warning( 'No images found.' );

return;

}

WP_CLI::log(

sprintf(

'Found %1$d %2$s to regenerate.',

$count,

_n( 'image', 'images', $count )

)

);

if ( $image_size ) {

$image_size_filters = $this->add_image_size_filters( $image_size );

}

$number = 0;

$successes = 0;

$errors = 0;

$skips = 0;

/**

foreach ( $images->posts as $post_id ) {

++$number;

if ( 0 === $number % self::WP_CLEAR_OBJECT_CACHE_INTERVAL ) {

// @phpstan-ignore function.deprecated

Utils\wp_clear_object_cache();

}

$this->process_regeneration( $post_id, $skip_delete, $only_missing, $delete_unknown, $image_size, $number . '/' . $count, $successes, $errors, $skips );

}

if ( isset( $image_size_filters ) ) {

$this->remove_image_size_filters( $image_size_filters );

}

Utils\report_batch_operation_results( 'image', 'regenerate', $count, $successes, $errors, $skips );

}

/**

public function import( $args, $assoc_args = array() ) {

$assoc_args = wp_parse_args(

$assoc_args,

array(

'file_name' => '',

'title' => '',

'caption' => '',

'alt' => '',

'desc' => '',

'post_name' => '',

'destination-dir' => '',

)

);

// Assume the most generic term

$noun = 'item';

// Current site's timezone offset.

// @phpstan-ignore cast.double

$gmt_offset = (float) get_option( 'gmt_offset' );

// Use the noun `image` when sure the media file is an image

if ( Utils\get_flag_value( $assoc_args, 'featured_image' ) || $assoc_args['alt'] ) {

$noun = 'image';

}

$porcelain = Utils\get_flag_value( $assoc_args, 'porcelain' );

if ( is_string( $porcelain ) && ! in_array( $porcelain, array( 'url' ), true ) ) {

WP_CLI::error( sprintf( 'Invalid value for <porcelain>: %s. Expected flag or \'url\'.', $porcelain ) );

}

if ( isset( $assoc_args['post_id'] ) ) {

if ( ! get_post( $assoc_args['post_id'] ) ) {

WP_CLI::warning( 'Invalid --post_id' );

$assoc_args['post_id'] = false;

}

} else {

$assoc_args['post_id'] = false;

}

$destdir = Utils\get_flag_value( $assoc_args, 'destination-dir' );

$this->destination_dir = $destdir;

$filter_upload_dir = function ( $uploads ) {

return $this->filter_upload_dir( $uploads );

};

$number = 0;

$successes = 0;

$errors = 0;

foreach ( $args as $file ) {

++$number;

if ( 0 === $number % self::WP_CLEAR_OBJECT_CACHE_INTERVAL ) {

// @phpstan-ignore function.deprecated

Utils\wp_clear_object_cache();

}

// phpcs:ignore WordPress.WP.AlternativeFunctions.parse_url_parse_url -- parse_url will only be used in absence of wp_parse_url.

$is_file_remote = function_exists( 'wp_parse_url' ) ? wp_parse_url( $file, PHP_URL_HOST ) : parse_url( $file, PHP_URL_HOST );

$orig_filename = $file;

$file_time = '';

if ( empty( $is_file_remote ) ) {

if ( ! file_exists( $file ) ) {

WP_CLI::warning( "Unable to import file '$file'. Reason: File doesn't exist." );

++$errors;

continue;

}

if ( Utils\get_flag_value( $assoc_args, 'skip-copy' ) ) {

$tempfile = $file;

} else {

$tempfile = $this->make_copy( $file );

}

$name = Utils\basename( $file );

if ( Utils\get_flag_value( $assoc_args, 'preserve-filetime' ) ) {

$file_time = @filemtime( $file );

}

} else {

$tempfile = download_url( $file );

if ( is_wp_error( $tempfile ) ) {

WP_CLI::warning(

sprintf(

"Unable to import file '%s'. Reason: %s",

$file,

implode( ', ', $tempfile->get_error_messages() )

)

);

++$errors;

continue;

}

$name = (string) strtok( Utils\basename( $file ), '?' );

}

if ( ! empty( $assoc_args['file_name'] ) ) {

$image_name = $this->get_image_name( $name, $assoc_args['file_name'] );

$name = ! empty( $image_name ) ? $image_name : $name;

}

$file_array = array(

'tmp_name' => $tempfile,

'name' => $name,

);

$post_array = array(

'post_title' => $assoc_args['title'],

'post_excerpt' => $assoc_args['caption'],

'post_content' => $assoc_args['desc'],

'post_name' => $assoc_args['post_name'],

);

if ( ! empty( $file_time ) ) {

$post_array['post_date'] = gmdate( 'Y-m-d H:i:s', (int) ( $file_time + ( $gmt_offset * HOUR_IN_SECONDS ) ) );

$post_array['post_date_gmt'] = gmdate( 'Y-m-d H:i:s', $file_time );

$post_array['post_modified'] = gmdate( 'Y-m-d H:i:s', (int) ( $file_time + ( $gmt_offset * HOUR_IN_SECONDS ) ) );

$post_array['post_modified_gmt'] = gmdate( 'Y-m-d H:i:s', $file_time );

}

$post_array = wp_slash( $post_array );

// use image exif/iptc data for title and caption defaults if possible

if ( empty( $post_array['post_title'] ) || empty( $post_array['post_excerpt'] ) ) {

// @codingStandardsIgnoreStart

$image_meta = @wp_read_image_metadata( $tempfile );

// @codingStandardsIgnoreEnd

if ( ! empty( $image_meta ) ) {

if ( empty( $post_array['post_title'] ) && trim( $image_meta['title'] ) && ! is_numeric( sanitize_title( $image_meta['title'] ) ) ) {

$post_array['post_title'] = $image_meta['title'];

}

if ( empty( $post_array['post_excerpt'] ) && trim( $image_meta['caption'] ) ) {

$post_array['post_excerpt'] = $image_meta['caption'];

}

}

}

if ( empty( $post_array['post_title'] ) ) {

$post_array['post_title'] = preg_replace( '/\.[^.]+$/', '', Utils\basename( $file ) );

}

if ( Utils\get_flag_value( $assoc_args, 'skip-copy' ) ) {

$wp_filetype = wp_check_filetype( $file, null );

$post_array['post_mime_type'] = $wp_filetype['type'];

$post_array['post_status'] = 'inherit';

$success = wp_insert_attachment( $post_array, $file, $assoc_args['post_id'] );

if ( is_wp_error( $success ) ) {

WP_CLI::warning(

sprintf(

"Unable to insert file '%s'. Reason: %s",

$orig_filename,

implode( ', ', $success->get_error_messages() )

)

);

++$errors;

continue;

}

wp_update_attachment_metadata( $success, wp_generate_attachment_metadata( $success, $file ) );

} else {

if ( ! empty( $destdir ) ) {

add_filter( 'upload_dir', $filter_upload_dir, PHP_INT_MAX );

}

// Deletes the temporary file.

$success = media_handle_sideload( $file_array, $assoc_args['post_id'], $assoc_args['title'], $post_array );

if ( is_wp_error( $success ) ) {

WP_CLI::warning(

sprintf(

"Unable to import file '%s'. Reason: %s",

$orig_filename,

implode( ', ', $success->get_error_messages() )

)

);

++$errors;

continue;

}

}

// Set alt text

if ( $assoc_args['alt'] ) {

update_post_meta( $success, '_wp_attachment_image_alt', wp_slash( $assoc_args['alt'] ) );

}

// Set as featured image, if --post_id and --featured_image are set

if ( $assoc_args['post_id'] && Utils\get_flag_value( $assoc_args, 'featured_image' ) ) {

update_post_meta( $assoc_args['post_id'], '_thumbnail_id', $success );

}

$attachment_success_text = '';

if ( $assoc_args['file_name'] ) {

$attachment_success_text .= " with file name {$name}";

}

if ( $assoc_args['post_id'] ) {

$attachment_success_text = " and attached to post {$assoc_args['post_id']}";

if ( Utils\get_flag_value( $assoc_args, 'featured_image' ) ) {

$attachment_success_text .= ' as featured image';

}

}

if ( $porcelain ) {

if ( 'url' === strtolower( $porcelain ) ) {

$file_location = $this->get_real_attachment_url( $success );

if ( $file_location ) {

WP_CLI::line( $file_location );

} else {

// This should never happen.

WP_CLI::error( 'Attachment URL not found' );

}

} else {

WP_CLI::line( (string) $success );

}

} else {

WP_CLI::log(

sprintf(

"Imported file '%s' as attachment ID %d%s.",

$orig_filename,

$success,

$attachment_success_text

)

);

}

++$successes;

}

remove_filter( 'upload_dir', $filter_upload_dir, PHP_INT_MAX );

// Report the result of the operation

if ( ! Utils\get_flag_value( $assoc_args, 'porcelain' ) ) {

Utils\report_batch_operation_results( $noun, 'import', count( $args ), $successes, $errors );

} elseif ( $errors ) {

WP_CLI::halt( 1 );

}

}

/**

public function image_size( $args, $assoc_args ) {

$assoc_args = array_merge(

array(

'fields' => 'name,width,height,crop,ratio',

),

$assoc_args

);

$sizes = $this->get_registered_image_sizes();

usort(

$sizes,

function ( $a, $b ) {

if ( $a['width'] === $b['width'] ) {

return 0;

}

return ( $a['width'] < $b['width'] ) ? 1 : -1;

}

);

array_unshift(

$sizes,

array(

'name' => 'full',

'width' => '',

'height' => '',

'crop' => 'N/A',

'ratio' => 'N/A',

)

);

WP_CLI\Utils\format_items( $assoc_args['format'], $sizes, explode( ',', $assoc_args['fields'] ) );

}

/**

private function get_ratio( $width, $height ) {

if ( 0 === $height ) {

return "0:{$width}";

}

if ( 0 === $width ) {

return "{$height}:0";

}

$gcd = $this->gcd( $width, $height );

$width_ratio = $width / $gcd;

$height_ratio = $height / $gcd;

return "{$width_ratio}:{$height_ratio}";

}

/**

private function gcd( $num1, $num2 ) {

while ( 0 !== $num2 ) {

$t = $num1 % $num2;

$num1 = $num2;

$num2 = $t;

}

return $num1;

}

/**

private function make_copy( $path ) {

$dir = get_temp_dir();

$filename = Utils\basename( $path );

if ( empty( $filename ) ) {

$filename = (string) time();

}

$filename = $dir . wp_unique_filename( $dir, $filename );

if ( ! copy( $path, $filename ) ) {

WP_CLI::error( "Could not create temporary file for $path." );

}

return $filename;

}

/**

private function process_regeneration( $id, $skip_delete, $only_missing, $delete_unknown, $image_size, $progress, &$successes, &$errors, &$skips ) {

$title = get_the_title( $id );

if ( '' === $title ) {

// If audio or video cover art then the id is the sub attachment id, which has no title.

if ( metadata_exists( 'post', $id, '_cover_hash' ) ) {

// Unfortunately the only way to get the attachment title would be to do a non-indexed query against the meta value of `_thumbnail_id`. So don't.

$att_desc = sprintf( 'cover attachment (ID %d)', $id );

} else {

$att_desc = sprintf( '"(no title)" (ID %d)', $id );

}

} else {

$att_desc = sprintf( '"%1$s" (ID %2$d)', $title, $id );

}

$thumbnail_desc = $image_size ? sprintf( '"%s" thumbnail', $image_size ) : 'thumbnail';

$fullsizepath = $this->get_attached_file( $id );

if ( false === $fullsizepath || ! file_exists( $fullsizepath ) ) {

WP_CLI::warning( "Can't find $att_desc." );

++$errors;

return;

}

$is_pdf = 'application/pdf' === get_post_mime_type( $id );

$original_meta = wp_get_attachment_metadata( $id );

if ( $delete_unknown ) {

$this->delete_unknown_image_sizes( $id, $fullsizepath );

WP_CLI::log( "$progress Deleted unknown image sizes for $att_desc." );

++$successes;

return;

}

$needs_regeneration = $this->needs_regeneration( $id, $fullsizepath, $is_pdf, $image_size, $skip_delete, $skip_it );

if ( $skip_it ) {

WP_CLI::log( "$progress Skipped $thumbnail_desc regeneration for $att_desc." );

++$skips;

return;

}

if ( $only_missing && ! $needs_regeneration ) {

WP_CLI::log( "$progress No $thumbnail_desc regeneration needed for $att_desc." );

++$successes;

return;

}

$site_icon_filter = $this->add_site_icon_filter( $id );

// When regenerating a specific image size, use the file that WordPress normally

// serves (the scaled version for big images), not the original pre-scaled file.

// This prevents wp_generate_attachment_metadata() from re-creating the scaled

// version or auto-rotating the original during specific-size regeneration.

$generate_file = $fullsizepath;

if ( $image_size && ! $is_pdf ) {

$wp_attached_file = \get_attached_file( $id );

if ( $wp_attached_file && file_exists( $wp_attached_file ) ) {

$generate_file = $wp_attached_file;

}

}

$metadata = wp_generate_attachment_metadata( $id, $generate_file );

if ( $site_icon_filter ) {

remove_filter( 'intermediate_image_sizes_advanced', $site_icon_filter );

}

// Note it's possible for no metadata to be generated for PDFs if restricted to a specific image size.

if ( empty( $metadata ) && ! ( $is_pdf && $image_size ) ) {

WP_CLI::warning( sprintf( 'No metadata. (ID %d)', $id ) );

WP_CLI::log( "$progress Couldn't regenerate thumbnails for $att_desc." );

++$errors;

return;

}

// On read error, we might only get the filesize returned and nothing else.

if ( 1 === count( $metadata ) && array_key_exists( 'filesize', $metadata ) && ! ( $is_pdf && $image_size ) ) {

WP_CLI::warning( sprintf( 'Read error while retrieving metadata. (ID %d)', $id ) );

WP_CLI::log( "$progress Couldn't regenerate thumbnails for $att_desc." );

++$errors;

return;

}

if ( $image_size ) {

if ( $this->update_attachment_metadata_for_image_size( $id, $metadata, $image_size, $original_meta ) ) {

WP_CLI::log( "$progress Regenerated $thumbnail_desc for $att_desc." );

} else {

WP_CLI::log( "$progress No $thumbnail_desc regeneration needed for $att_desc." );

}

} else {

wp_update_attachment_metadata( $id, $metadata );

WP_CLI::log( "$progress Regenerated thumbnails for $att_desc." );

}

++$successes;

}

/**

private function remove_old_images( $metadata, $fullsizepath, $image_size ) {

if ( empty( $metadata['sizes'] ) ) {

return;

}

if ( $image_size ) {

if ( empty( $metadata['sizes'][ $image_size ] ) ) {

return;

}

$metadata['sizes'] = array( $image_size => $metadata['sizes'][ $image_size ] );

}

$dir_path = dirname( $fullsizepath ) . '/';

foreach ( $metadata['sizes'] as $size_info ) {

$intermediate_path = $dir_path . $size_info['file'];

if ( $intermediate_path === $fullsizepath ) {

continue;

}

if ( file_exists( $intermediate_path ) ) {

unlink( $intermediate_path );

}

}

}

/**

private function needs_regeneration( $att_id, $fullsizepath, $is_pdf, $image_size, $skip_delete, &$skip_it ) {

// Assume not skipping.

$skip_it = false;

// Note: zero-length string returned if no metadata, for instance if PDF or non-standard image (eg an SVG).

$metadata = wp_get_attachment_metadata( $att_id );

$image_sizes = $this->get_intermediate_image_sizes_for_attachment( $fullsizepath, $is_pdf, $metadata, $att_id );

// First check if no applicable editor currently available (non-destructive - ie old thumbnails not removed).

if ( is_wp_error( $image_sizes ) && 'image_no_editor' === $image_sizes->get_error_code() ) {

// Warn unless PDF or non-standard image.

if ( ! $is_pdf && is_array( $metadata ) && ! empty( $metadata['sizes'] ) ) {

WP_CLI::warning( sprintf( '%s (ID %d)', $image_sizes->get_error_message(), $att_id ) );

}

$skip_it = true;

return false;

}

// If uploaded when applicable image editor such as Imagick unavailable, the metadata or sizes metadata may not exist.

if ( ! is_array( $metadata ) ) {

$metadata = array();

}

// If set `$metadata['sizes']` should be array but explicitly check as following code depends on it.

if ( ! isset( $metadata['sizes'] ) || ! is_array( $metadata['sizes'] ) ) {

$metadata['sizes'] = array();

}

// Remove any old thumbnails (so now destructive).

if ( ! $skip_delete ) {

$this->remove_old_images( $metadata, $fullsizepath, $image_size );

}

// Check for any other error (such as load error) apart from no editor available.

if ( is_wp_error( $image_sizes ) ) {

// Warn but assume it may be possible to regenerate and allow processing to continue and possibly fail.

WP_CLI::warning( sprintf( '%s (ID %d)', $image_sizes->get_error_message(), $att_id ) );

return true;

}

// Have sizes - check whether they're new ones or they've changed. Note that an attachment can have no sizes if it's on or below the thumbnail threshold.

if ( $image_size ) {

if ( empty( $image_sizes[ $image_size ] ) ) {

return false;

}

if ( empty( $metadata['sizes'][ $image_size ] ) ) {

return true;

}

/**

$metadata['sizes'] = array( $image_size => $metadata['sizes'][ $image_size ] );

}

if ( $this->image_sizes_differ( $image_sizes, $metadata['sizes'] ) ) {

return true;

}

$dir_path = dirname( $fullsizepath ) . '/';

// Check that the thumbnail files exist.

/**

foreach ( $metadata['sizes'] as $size_info ) {

$intermediate_path = $dir_path . $size_info['file'];

if ( $intermediate_path === $fullsizepath ) {

continue;

}

if ( ! file_exists( $intermediate_path ) ) {

return true;

}

}

return false;

}

/**

private function image_sizes_differ( $image_sizes, $meta_sizes ) {

// Check if have new image size(s).

if ( array_diff( array_keys( $image_sizes ), array_keys( $meta_sizes ) ) ) {

return true;

}

// Check if image sizes have changed.

foreach ( $image_sizes as $name => $image_size ) {

if ( $image_size['width'] !== $meta_sizes[ $name ]['width'] || $image_size['height'] !== $meta_sizes[ $name ]['height'] ) {

return true;

}

}

return false;

}

/**

private function get_intermediate_image_sizes_for_attachment( $fullsizepath, $is_pdf, $metadata, $att_id ) {

// Need to get width, height of attachment for image_resize_dimensions().

$editor = wp_get_image_editor( $fullsizepath );

if ( is_wp_error( $editor ) ) {

return $editor;

}

$result = $editor->load();

if ( is_wp_error( $result ) ) {

unset( $editor );

return $result;

}

list( $width, $height ) = array_values( $editor->get_size() );

unset( $editor );

$sizes = array();

foreach ( $this->get_intermediate_sizes( $is_pdf, $metadata, $att_id ) as $name => $size ) {

// Need to check destination and original width or height differ before calling image_resize_dimensions(), otherwise it will return non-false.

$dims = image_resize_dimensions( $width, $height, $size['width'], $size['height'], $size['crop'] );

if ( ( $width !== $size['width'] || $height !== $size['height'] ) && $dims ) {

list( $dst_x, $dst_y, $src_x, $src_y, $dst_w, $dst_h, $src_w, $src_h ) = $dims;

$sizes[ $name ] = array(

'width' => $dst_w,

'height' => $dst_h,

);

}

}

return $sizes;

}

/**

private function get_intermediate_sizes( $is_pdf, $metadata, $att_id ) {

if ( $is_pdf ) {

// Copied from wp_generate_attachment_metadata() in "wp-admin/includes/image.php".

$fallback_sizes = array(

'thumbnail',

'medium',

'large',

);

// phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Calling native WordPress hook.

$intermediate_image_sizes = apply_filters( 'fallback_intermediate_image_sizes', $fallback_sizes, $metadata );

} else {

$intermediate_image_sizes = get_intermediate_image_sizes();