$payload Job payload. * @return array{payload: array, progress: int, done: bool} */ public function step( array $payload ): array { $this->assert_available(); $args = is_array( $payload['args'] ?? null ) ? $payload['args'] : array(); $user_id = (int) ( $payload['user_id'] ?? $payload['requested_by'] ?? 0 ); if ( $user_id < 1 ) { throw new LibraryZipException( 'download_forbidden', __( 'The archive owner is not valid.', 'foldrocket' ), 403 ); } if ( empty( $payload['attachment_ids'] ) ) { $this->cleanup_stale(); $selected = is_array( $payload['selected_attachment_ids'] ?? null ) ? array_values( array_unique( array_filter( array_map( 'intval', $payload['selected_attachment_ids'] ) ) ) ) : array(); if ( $selected ) { if ( count( $selected ) > self::MAX_FILES ) { throw new LibraryZipException( 'download_too_many', __( 'Too many files selected for one zip.', 'foldrocket' ), 400 ); } $ids = $selected; } else { $this->assert_scope( $args ); $match = ( new AssetRepository() )->list_attachment_ids( $args, self::MAX_FILES ); if ( (int) $match['total'] > self::MAX_FILES ) { throw new LibraryZipException( 'download_too_many', sprintf( /* translators: %d: maximum number of files in one zip. */ __( 'This view has more than %d files. Narrow the filters and try again.', 'foldrocket' ), self::MAX_FILES ), 400 ); } $ids = array_values( array_map( 'intval', $match['ids'] ) ); } $ids = array_values( array_filter( $ids, static fn( int $attachment_id ): bool => $attachment_id > 0 && 'attachment' === get_post_type( $attachment_id ) && user_can( $user_id, 'read_post', $attachment_id ) ) ); if ( ! $ids ) { throw new LibraryZipException( 'download_empty', __( 'Nothing to download in this view.', 'foldrocket' ), 400 ); } $token = bin2hex( random_bytes( 16 ) ); $payload['attachment_ids'] = $ids; $payload['next_index'] = 0; $payload['added_count'] = 0; $payload['used_names'] = array(); $payload['token'] = $token; $payload['zip_file'] = $this->temp_dir() . 'frkt-lib-' . $token . '.zip'; $payload['phase'] = 'archive'; return array( 'payload' => $payload, 'progress' => 5, 'done' => false ); } $ids = array_values( array_map( 'intval', (array) $payload['attachment_ids'] ) ); $next = max( 0, (int) ( $payload['next_index'] ?? 0 ) ); $zip = (string) ( $payload['zip_file'] ?? '' ); $token = (string) ( $payload['token'] ?? '' ); $used = is_array( $payload['used_names'] ?? null ) ? $payload['used_names'] : array(); $added = max( 0, (int) ( $payload['added_count'] ?? 0 ) ); $batch_ids = array_slice( $ids, $next, self::BATCH_SIZE ); $uploads = wp_upload_dir(); $base = isset( $uploads['basedir'] ) ? (string) $uploads['basedir'] : ''; $base = $base !== '' ? (string) realpath( $base ) : ''; if ( $base === '' || ! preg_match( '/^[a-f0-9]{32}$/', $token ) || $zip !== $this->temp_dir() . 'frkt-lib-' . $token . '.zip' ) { throw new LibraryZipException( 'download_unavailable', __( 'Temporary archive data is not valid.', 'foldrocket' ), 500 ); } $archive = new \ZipArchive(); if ( true !== $archive->open( $zip, \ZipArchive::CREATE ) ) { throw new LibraryZipException( 'download_failed', __( 'Could not create the zip.', 'foldrocket' ), 500 ); } foreach ( $batch_ids as $attachment_id ) { if ( ! user_can( $user_id, 'read_post', $attachment_id ) ) { continue; } $path = get_attached_file( $attachment_id ); $real = is_string( $path ) && $path !== '' ? realpath( $path ) : false; if ( ! is_string( $real ) || ! is_readable( $real ) || ! $this->path_is_inside( $real, $base ) ) { continue; } $name = $this->entry_name( basename( $real ), $attachment_id, $used ); if ( false !== $archive->locateName( $name ) || $archive->addFile( $real, $name ) ) { ++$added; } } if ( ! $archive->close() ) { throw new LibraryZipException( 'download_failed', __( 'Could not create the zip.', 'foldrocket' ), 500 ); } $next += count( $batch_ids ); $payload['next_index'] = $next; $payload['added_count'] = $added; $payload['used_names'] = $used; if ( $next < count( $ids ) ) { $progress = 5 + (int) floor( 90 * ( $next / max( 1, count( $ids ) ) ) ); return array( 'payload' => $payload, 'progress' => min( 95, $progress ), 'done' => false ); } if ( $added < 1 ) { $this->cleanup_job( $payload ); throw new LibraryZipException( 'download_empty', __( 'Nothing to download in this view.', 'foldrocket' ), 400 ); } $name = $this->archive_name( (string) ( $payload['label'] ?? '' ) ); set_transient( self::TRANSIENT_PREFIX . $token, array( 'file' => $zip, 'name' => $name, 'user' => $user_id ), 10 * MINUTE_IN_SECONDS ); $payload['phase'] = 'ready'; $payload['result'] = array( 'url' => admin_url( 'admin-post.php?action=frkt_download_zip&token=' . rawurlencode( $token ) ), 'count' => $added, ); unset( $payload['attachment_ids'], $payload['selected_attachment_ids'], $payload['used_names'], $payload['zip_file'] ); return array( 'payload' => $payload, 'progress' => 100, 'done' => true ); } /** * @param array $args Same filters as AssetRepository::list(). * @return array{url: string, count: int} */ public function prepare( array $args, string $label, int $user_id ): array { $payload = array( 'args' => $args, 'label' => $label, 'user_id' => $user_id, 'requested_by' => $user_id ); do { $step = $this->step( $payload ); $payload = $step['payload']; } while ( ! $step['done'] ); return (array) $payload['result']; } private function assert_available(): void { if ( ! FeatureRegistry::is_available( 'download_zip' ) ) { throw new LibraryZipException( 'feature_disabled', __( 'Download zip is turned off.', 'foldrocket' ), 403 ); } if ( ! class_exists( \ZipArchive::class ) ) { throw new LibraryZipException( 'download_unavailable', __( 'Zip is not available on this server.', 'foldrocket' ), 500 ); } } /** @param array $args */ private function assert_scope( array $args ): void { if ( ! $this->has_scope( $args ) ) { throw new LibraryZipException( 'download_needs_view', __( 'Open a folder or a smart view before downloading.', 'foldrocket' ), 400 ); } } private function archive_name( string $label ): string { $name = sanitize_file_name( $label ); if ( $name === '' ) { $name = 'media'; } return str_ends_with( strtolower( $name ), '.zip' ) ? $name : $name . '.zip'; } /** @param array $payload */ public function cleanup_job( array $payload ): void { $file = (string) ( $payload['zip_file'] ?? '' ); $real = $file !== '' ? realpath( $file ) : false; $temp = realpath( get_temp_dir() ); if ( is_string( $real ) && is_string( $temp ) && is_file( $real ) && str_starts_with( $real, $temp . DIRECTORY_SEPARATOR ) && str_starts_with( basename( $real ), 'frkt-lib-' ) ) { wp_delete_file( $real ); } } /** * @param array $args */ private function has_scope( array $args ): bool { if ( ! empty( $args['folder_id'] ) ) { return true; } foreach ( array( 'search', 'mime', 'ai_status', 'orientation', 'author_id', 'date_from', 'date_to' ) as $key ) { if ( ! empty( $args[ $key ] ) ) { return true; } } if ( isset( $args['usage_min'] ) && '' !== $args['usage_min'] ) { return true; } if ( array_key_exists( 'usage_max', $args ) && $args['usage_max'] !== null && $args['usage_max'] !== '' ) { return true; } return ! empty( $args['min_size'] ) || ! empty( $args['missing_alt'] ) || ! empty( $args['indexed_only'] ); } /** * @param array $used */ private function entry_name( string $basename, int $attachment_id, array &$used ): string { $name = sanitize_file_name( $basename ); if ( $name === '' ) { $name = 'file-' . $attachment_id; } if ( isset( $used[ $name ] ) ) { $extension = pathinfo( $name, PATHINFO_EXTENSION ); $stem = pathinfo( $name, PATHINFO_FILENAME ); $name = $stem . '-' . $attachment_id . ( $extension !== '' ? '.' . $extension : '' ); } $used[ $name ] = true; return $name; } private function path_is_inside( string $path, string $base ): bool { $base = rtrim( $base, '/\\' ); return $path === $base || str_starts_with( $path, $base . DIRECTORY_SEPARATOR ) || str_starts_with( $path, $base . '/' ); } private function temp_dir(): string { $dir = trailingslashit( get_temp_dir() ); if ( ! is_dir( $dir ) || ! wp_is_writable( $dir ) ) { throw new LibraryZipException( 'download_unavailable', __( 'Temporary directory is not writable.', 'foldrocket' ), 500 ); } return $dir; } public function cleanup_stale(): void { $dir = trailingslashit( get_temp_dir() ); $files = glob( $dir . 'frkt-lib-*.zip' ); if ( ! is_array( $files ) ) { return; } $cutoff = time() - ( 10 * MINUTE_IN_SECONDS ); foreach ( $files as $file ) { if ( is_file( $file ) && filemtime( $file ) !== false && filemtime( $file ) < $cutoff ) { wp_delete_file( $file ); } } } } final class LibraryZipException extends \RuntimeException { public function __construct( public readonly string $error_code, string $message, public readonly int $status = 400 ) { parent::__construct( $message ); } }