From 8a1381dae546fff4bb2b930f0f1b91815b5e3c5f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adam=20Zieli=C5=84ski?= Date: Sun, 1 Dec 2024 21:32:11 +0100 Subject: [PATCH 01/15] Store and display attachments download errors --- .../playground/data-liberation/plugin.php | 65 +++++++--- .../src/import/WP_Attachment_Downloader.php | 81 +++++++----- .../src/import/WP_Import_Session.php | 108 +++++++++++++++- ...ing-attachments-post-contents-and-404s.xml | 116 ++++++++++++++++++ 4 files changed, 318 insertions(+), 52 deletions(-) create mode 100644 packages/playground/data-liberation/tests/wxr/frontloading-attachments-post-contents-and-404s.xml diff --git a/packages/playground/data-liberation/plugin.php b/packages/playground/data-liberation/plugin.php index 3c16f5f2e21..5061fced346 100644 --- a/packages/playground/data-liberation/plugin.php +++ b/packages/playground/data-liberation/plugin.php @@ -105,6 +105,10 @@ function data_liberation_admin_page() { // Populates the initial global state values. wp_interactivity_state( 'dataLiberation', array( + 'importedEntities' => $import_session ? $import_session->count_imported_entities() : [], + 'totalEntities' => $import_session ? $import_session->get_total_number_of_entities() : [], + 'frontloadingPlaceholders' => $import_session ? $import_session->get_frontloading_placeholders() : [], + 'selectedImportType' => 'wxr_file', 'isImportTypeSelected' => function() { // @TODO Figure out why this function is not hiding the form rows @@ -142,7 +146,7 @@ function data_liberation_admin_page() { } } -
+

Data Liberation

@@ -216,8 +220,8 @@ function data_liberation_admin_page() { get_frontloading_progress(); if (!empty($frontloading_progress)): ?> - - / Files Downloaded + + / Files Downloaded

Downloads in progress:

@@ -245,9 +249,34 @@ function data_liberation_admin_page() { + +

Downloaded Assets:

+
+ + / Files Downloaded +
+
+ + + + + + + + + + +
FileRetriesState
+ + is_stage_completed(WP_Stream_Importer::STAGE_IMPORT_ENTITIES) + $import_session->is_stage_completed(WP_Stream_Importer::STAGE_FRONTLOAD_ASSETS) ): ?> @@ -293,7 +322,6 @@ function data_liberation_admin_page() { method="post" enctype="multipart/form-data" action="" - data-wp-interactive="dataLiberation" > @@ -545,20 +573,11 @@ function data_liberation_import_step($session) { switch($importer->get_stage()) { case WP_Stream_Importer::STAGE_INDEX_ENTITIES: // Bump the total number of entities to import. - var_dump($importer->get_indexed_entities_counts()); + $session->store_indexed_assets_urls($importer->get_indexed_assets_urls()); $session->bump_total_number_of_entities([ ...$importer->get_indexed_entities_counts(), - 'file' => count($importer->get_indexed_assets_urls()) ]); break; - case WP_Stream_Importer::STAGE_FRONTLOAD_ASSETS: - var_dump($importer->get_frontloading_progress()); - var_dump($importer->get_frontloading_events()); - $session->bump_frontloading_progress( - $importer->get_frontloading_progress(), - $importer->get_frontloading_events() - ); - break; case WP_Stream_Importer::STAGE_IMPORT_ENTITIES: var_dump($importer->get_imported_entities_counts()); $session->bump_imported_entities_counts( @@ -572,20 +591,32 @@ function data_liberation_import_step($session) { if(WP_Stream_Importer::STAGE_FRONTLOAD_ASSETS === $importer->get_stage()) { // Define constraints for this run of the frontloading stage. // @TODO: Support these constraints at the importer level, not here. - $min_files_downloaded = 0; + $min_files_downloaded = 3; $soft_time_limit = 10; $start_time = time(); $files_downloaded = 0; while(true) { + var_dump('Checking for more steps'); if(!$importer->next_step()) { + var_dump('No more steps'); break; } $frontloading_events = $importer->get_frontloading_events(); foreach($frontloading_events as $event) { + var_dump($event); if($event->type === WP_Attachment_Downloader_Event::SUCCESS) { ++$files_downloaded; } } + + if(count($importer->get_frontloading_progress())) { + var_dump($importer->get_frontloading_progress()); + } + $session->bump_frontloading_progress( + $importer->get_frontloading_progress(), + $importer->get_frontloading_events() + ); + $time_taken = time() - $start_time; if($time_taken > $soft_time_limit) { if($files_downloaded >= $min_files_downloaded) { diff --git a/packages/playground/data-liberation/src/import/WP_Attachment_Downloader.php b/packages/playground/data-liberation/src/import/WP_Attachment_Downloader.php index 261b27c58b4..2a7a97552fe 100644 --- a/packages/playground/data-liberation/src/import/WP_Attachment_Downloader.php +++ b/packages/playground/data-liberation/src/import/WP_Attachment_Downloader.php @@ -147,46 +147,63 @@ public function poll() { $this->progress[ $original_url ]['received'] += strlen( $chunk ); break; case Client::EVENT_FAILED: - if ( isset( $this->fps[ $original_request_id ] ) ) { - fclose( $this->fps[ $original_request_id ] ); - } - if ( isset( $this->output_paths[ $original_request_id ] ) ) { - $partial_file = $this->output_paths[ $original_request_id ] . '.partial'; - if ( file_exists( $partial_file ) ) { - unlink( $partial_file ); - } - } - $this->pending_events[] = new WP_Attachment_Downloader_Event( - $original_url, - WP_Attachment_Downloader_Event::FAILURE - ); - unset( $this->progress[ $original_url ] ); - unset( $this->output_paths[ $original_request_id ] ); + $this->on_failure( $original_url, $original_request_id ); break; case Client::EVENT_FINISHED: if ( ! $request->is_redirected() ) { - // Only clean up if this was the last request in the chain. - if ( isset( $this->fps[ $original_request_id ] ) ) { - fclose( $this->fps[ $original_request_id ] ); - } - if ( isset( $this->output_paths[ $original_request_id ] ) ) { - if ( false === rename( - $this->output_paths[ $original_request_id ] . '.partial', - $this->output_paths[ $original_request_id ] - ) ) { - // @TODO: Log an error. - } - } - $this->pending_events[] = new WP_Attachment_Downloader_Event( - $original_url, - WP_Attachment_Downloader_Event::SUCCESS + // Only process if this was the last request in the chain. + $is_success = ( + $request->response->status_code >= 200 && + $request->response->status_code <= 299 ); - unset( $this->progress[ $original_url ] ); - unset( $this->output_paths[ $original_request_id ] ); + if ( $is_success ) { + $this->on_success( $original_url, $original_request_id ); + } else { + $this->on_failure( $original_url, $original_request_id ); + } } break; } return true; } + + private function on_failure( $original_url, $original_request_id ) { + if ( isset( $this->fps[ $original_request_id ] ) ) { + fclose( $this->fps[ $original_request_id ] ); + } + if ( isset( $this->output_paths[ $original_request_id ] ) ) { + $partial_file = $this->output_paths[ $original_request_id ] . '.partial'; + if ( file_exists( $partial_file ) ) { + unlink( $partial_file ); + } + } + $this->pending_events[] = new WP_Attachment_Downloader_Event( + $original_url, + WP_Attachment_Downloader_Event::FAILURE + ); + unset( $this->progress[ $original_url ] ); + unset( $this->output_paths[ $original_request_id ] ); + } + + private function on_success( $original_url, $original_request_id ) { + // Only clean up if this was the last request in the chain. + if ( isset( $this->fps[ $original_request_id ] ) ) { + fclose( $this->fps[ $original_request_id ] ); + } + if ( isset( $this->output_paths[ $original_request_id ] ) ) { + if ( false === rename( + $this->output_paths[ $original_request_id ] . '.partial', + $this->output_paths[ $original_request_id ] + ) ) { + // @TODO: Log an error. + } + } + $this->pending_events[] = new WP_Attachment_Downloader_Event( + $original_url, + WP_Attachment_Downloader_Event::SUCCESS + ); + unset( $this->progress[ $original_url ] ); + unset( $this->output_paths[ $original_request_id ] ); + } } diff --git a/packages/playground/data-liberation/src/import/WP_Import_Session.php b/packages/playground/data-liberation/src/import/WP_Import_Session.php index 13735f58a10..fd4ae127dd4 100644 --- a/packages/playground/data-liberation/src/import/WP_Import_Session.php +++ b/packages/playground/data-liberation/src/import/WP_Import_Session.php @@ -22,8 +22,11 @@ class WP_Import_Session { 'post_meta', 'comment', 'comment_meta', - 'file', + 'download', ); + const FRONTLOAD_STATUS_AWAITING_DOWNLOAD = 'awaiting_download'; + const FRONTLOAD_STATUS_ERROR = 'error'; + const FRONTLOAD_STATUS_SUCCEEDED = 'succeeded'; private $post_id; private $cached_stage; @@ -267,13 +270,111 @@ public function bump_imported_entities_counts( $newly_imported_entities ) { } } + public function set_frontloading_status( $url, $status, $error = null ) { + // @TODO: What if the placeholder is not found? + $placeholder = $this->get_frontloading_placeholder( $url ); + if ( ! $placeholder ) { + return false; + } + return wp_update_post(array( + 'ID' => $placeholder->ID, + 'post_status' => $status, + // Abuse the menu_order field to store the number of retries. + // This avoids additional database queries. + 'menu_order' => $placeholder->menu_order + 1, + 'post_content' => $error, + )); + } + + public function get_frontloading_placeholders( $options = array() ) { + $query = new WP_Query(array( + 'post_type' => 'frontloading_placeholder', + 'post_parent' => $this->post_id, + 'posts_per_page' => $options['per_page'] ?? 25, + 'paged' => $options['page'] ?? 1, + 'post_status' => self::FRONTLOAD_STATUS_ERROR, + 'orderby' => 'post_status', + 'order' => 'ASC', + )); + + if (!$query->have_posts()) { + return array(); + } + + return $query->posts; + } + public function get_total_number_of_entities() { $totals = array(); foreach ( static::PROGRESS_ENTITIES as $field ) { $totals[ $field ] = (int) get_post_meta( $this->post_id, 'total_' . $field, true ); } + $totals['download'] = $this->get_total_number_of_assets(); return $totals; } + + public function get_total_number_of_assets() { + global $wpdb; + return (int) $wpdb->get_var( $wpdb->prepare( + "SELECT COUNT(*) FROM $wpdb->posts + WHERE post_type = 'frontloading_placeholder' + AND post_parent = %d", + $this->post_id + ) ); + } + + public function get_frontloading_placeholder( $url ) { + global $wpdb; + return get_post( $wpdb->get_var( $wpdb->prepare( + "SELECT ID FROM $wpdb->posts WHERE post_type = 'frontloading_placeholder' AND post_parent = %d AND guid = %s LIMIT 1", + $this->post_id, $url + ) ) ); + } + + /** + * Creates placeholder attachments for the assets to be downloaded in the + * frontloading stage. + */ + public function store_indexed_assets_urls( $urls ) { + global $wpdb; + + foreach ( $urls as $url => $_ ) { + /** + * Check if placeholder with this URL already exists + * There's a race condition here – another insert may happen + * between the check and the insert. + * @TODO: Explore solutions. A custom table with a UNIQUE constraint + * may or may not be an option, depending on the performance impact + * on 100GB+ VIP databases. + */ + $exists = $wpdb->get_var( $wpdb->prepare( + "SELECT ID FROM $wpdb->posts + WHERE post_type = 'frontloading_placeholder' + AND post_parent = %d + AND guid = %s + LIMIT 1", + $this->post_id, + $url + )); + + if ( $exists ) { + continue; + } + + $post_data = array( + 'post_type' => 'frontloading_placeholder', + 'post_parent' => $this->post_id, + 'post_title' => basename( $url ), + 'post_status' => self::FRONTLOAD_STATUS_AWAITING_DOWNLOAD, + 'guid' => $url + ); + if ( is_wp_error( wp_insert_post( $post_data ) ) ) { + // @TODO: How to handle an insertion failure? + return false; + } + } + } + /** * Sets the total number of entities to import for each type. * @@ -318,15 +419,16 @@ public function bump_frontloading_progress( $frontloading_progress, $events = ar foreach ( $events as $event ) { if ( $event->type === WP_Attachment_Downloader_Event::SUCCESS ) { ++$successes; + $this->set_frontloading_status($event->resource_id, self::FRONTLOAD_STATUS_SUCCEEDED); } else { - // @TODO: Store error. + $this->set_frontloading_status($event->resource_id, self::FRONTLOAD_STATUS_ERROR, $event->error); } } if ( $successes > 0 ) { // @TODO: Consider not treating files as a special case. $this->bump_imported_entities_counts( array( - 'file' => $successes, + 'download' => $successes, ) ); } diff --git a/packages/playground/data-liberation/tests/wxr/frontloading-attachments-post-contents-and-404s.xml b/packages/playground/data-liberation/tests/wxr/frontloading-attachments-post-contents-and-404s.xml new file mode 100644 index 00000000000..a6d73f0e1c8 --- /dev/null +++ b/packages/playground/data-liberation/tests/wxr/frontloading-attachments-post-contents-and-404s.xml @@ -0,0 +1,116 @@ + + + + + +Theme Accessibility Unit Test Data +http://wpthemetestdata.wordpress.com +Just another WordPress website with a purposefully really long description +Tue, 02 Sep 2014 17:16:26 +0000 +en +1.2 +http://wordpress.com/ +http://wpthemetestdata.wordpress.com + + a11yteam + a11yteam@wordpress.org + + + + + + canola2 + http://wpthemetestdata.wordpress.com/2010/09/10/post-format-gallery/canola2/ + Mon, 10 Jan 2011 13:17:54 +0000 + a11yteam + http://wpthemetestdata.files.wordpress.com/2008/06/canola2.jpg + + + + 611 + 2011-01-10 06:17:54 + 2011-01-10 13:17:54 + open + closed + canola2 + inherit + 555 + 0 + attachment + + 0 + https://wpthemetestdata.files.wordpress.com/2008/06/canola2.jpg + + _wp_attachment_image_alt + + + + _wp_attachment_image_alt + + + + _attachment_original_parent_id + + + + + <![CDATA["The Road Not Taken" by Robert Frost]]> + https://playground.internal/path/?p=1 + Wed, 05 Jun 2024 16:04:48 +0000 + + https://playground.internal/path/?p=1 + + +

Two roads diverged in a yellow wood,
And sorry I could not travel both

+ + + +

+ + +

+]]>
+ + 17973 + + + + + + + + + 0 + 0 + + + 0 + + + + + + + + + +
+
+
\ No newline at end of file From ffad86aae5182b80a3f44afec08638d7d8e4d6d5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adam=20Zieli=C5=84ski?= Date: Sun, 1 Dec 2024 21:47:01 +0100 Subject: [PATCH 02/15] Add buttons to address frontloading errors --- .../data-liberation/import-screen.js | 5 ++++ .../playground/data-liberation/plugin.php | 23 +++++++++++++------ .../src/import/WP_Attachment_Downloader.php | 2 +- .../import/WP_Attachment_Downloader_Event.php | 1 + .../src/import/WP_Import_Session.php | 13 +++++++---- 5 files changed, 31 insertions(+), 13 deletions(-) diff --git a/packages/playground/data-liberation/import-screen.js b/packages/playground/data-liberation/import-screen.js index 808a0db6a83..83883c9a272 100644 --- a/packages/playground/data-liberation/import-screen.js +++ b/packages/playground/data-liberation/import-screen.js @@ -5,6 +5,11 @@ const { state } = store('dataLiberation', { get isImportTypeSelected() { return getContext().importType === state.selectedImportType; }, + get frontloadingFailed() { + return getContext().frontloadingPlaceholders.some( + (placeholder) => placeholder.post_status === 'error' + ); + }, }, actions: { setImportType: () => { diff --git a/packages/playground/data-liberation/plugin.php b/packages/playground/data-liberation/plugin.php index 5061fced346..d2cc604b9cb 100644 --- a/packages/playground/data-liberation/plugin.php +++ b/packages/playground/data-liberation/plugin.php @@ -261,6 +261,8 @@ function data_liberation_admin_page() { + + @@ -269,10 +271,24 @@ function data_liberation_admin_page() { + +
File Retries StateDetailsOptions
+
+ @TODO: So many buttons! Replace with a dropdown menu? + + + + + + + +
+
+ get_imported_entities_counts()); $session->bump_imported_entities_counts( $importer->get_imported_entities_counts() ); @@ -596,22 +611,16 @@ function data_liberation_import_step($session) { $start_time = time(); $files_downloaded = 0; while(true) { - var_dump('Checking for more steps'); if(!$importer->next_step()) { - var_dump('No more steps'); break; } $frontloading_events = $importer->get_frontloading_events(); foreach($frontloading_events as $event) { - var_dump($event); if($event->type === WP_Attachment_Downloader_Event::SUCCESS) { ++$files_downloaded; } } - if(count($importer->get_frontloading_progress())) { - var_dump($importer->get_frontloading_progress()); - } $session->bump_frontloading_progress( $importer->get_frontloading_progress(), $importer->get_frontloading_events() diff --git a/packages/playground/data-liberation/src/import/WP_Attachment_Downloader.php b/packages/playground/data-liberation/src/import/WP_Attachment_Downloader.php index 2a7a97552fe..df240c0054e 100644 --- a/packages/playground/data-liberation/src/import/WP_Attachment_Downloader.php +++ b/packages/playground/data-liberation/src/import/WP_Attachment_Downloader.php @@ -43,7 +43,7 @@ public function enqueue_if_not_exists( $url, $output_relative_path ) { if ( file_exists( $output_relative_path ) ) { $this->pending_events[] = new WP_Attachment_Downloader_Event( $this->enqueued_url, - WP_Attachment_Downloader_Event::SUCCESS + WP_Attachment_Downloader_Event::SKIPPED ); return true; } diff --git a/packages/playground/data-liberation/src/import/WP_Attachment_Downloader_Event.php b/packages/playground/data-liberation/src/import/WP_Attachment_Downloader_Event.php index b759ebb8fb5..83213d74510 100644 --- a/packages/playground/data-liberation/src/import/WP_Attachment_Downloader_Event.php +++ b/packages/playground/data-liberation/src/import/WP_Attachment_Downloader_Event.php @@ -4,6 +4,7 @@ class WP_Attachment_Downloader_Event { const SUCCESS = '#success'; const FAILURE = '#failure'; + const SKIPPED = '#skipped'; public $type; public $resource_id; diff --git a/packages/playground/data-liberation/src/import/WP_Import_Session.php b/packages/playground/data-liberation/src/import/WP_Import_Session.php index fd4ae127dd4..50d1e753330 100644 --- a/packages/playground/data-liberation/src/import/WP_Import_Session.php +++ b/packages/playground/data-liberation/src/import/WP_Import_Session.php @@ -417,11 +417,14 @@ public function bump_frontloading_progress( $frontloading_progress, $events = ar $successes = 0; foreach ( $events as $event ) { - if ( $event->type === WP_Attachment_Downloader_Event::SUCCESS ) { - ++$successes; - $this->set_frontloading_status($event->resource_id, self::FRONTLOAD_STATUS_SUCCEEDED); - } else { - $this->set_frontloading_status($event->resource_id, self::FRONTLOAD_STATUS_ERROR, $event->error); + switch ( $event->type ) { + case WP_Attachment_Downloader_Event::SUCCESS: + ++$successes; + $this->set_frontloading_status($event->resource_id, self::FRONTLOAD_STATUS_SUCCEEDED); + break; + case WP_Attachment_Downloader_Event::FAILURE: + $this->set_frontloading_status($event->resource_id, self::FRONTLOAD_STATUS_ERROR, $event->error); + break; } } if ( $successes > 0 ) { From 1087f14bd8fd7a7c9ba2af12986471e82f4e2934 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adam=20Zieli=C5=84ski?= Date: Mon, 2 Dec 2024 20:50:16 +0100 Subject: [PATCH 03/15] Start each frontloading round with re-requesting the failed downloads --- packages/php-wasm/compile/php/Dockerfile | 1 + .../php-wasm/node/asyncify/8_3_0/php_8_3.wasm | Bin 15083501 -> 15085661 bytes packages/php-wasm/node/asyncify/php_8_3.js | 2 +- .../playground/data-liberation/bootstrap.php | 2 + .../playground/data-liberation/plugin.php | 41 ++++++-- .../data-liberation/src/functions.php | 6 ++ .../src/import/WP_Attachment_Downloader.php | 23 +++-- .../import/WP_Attachment_Downloader_Event.php | 4 +- .../src/import/WP_Entity_Iterator_Chain.php | 16 ++++ .../src/import/WP_Import_Session.php | 31 ++++-- .../src/import/WP_Markdown_Importer.php | 2 +- .../import/WP_Retry_Frontloading_Iterator.php | 89 ++++++++++++++++++ .../src/import/WP_Stream_Importer.php | 12 ++- .../data-liberation/src/wxr/WP_WXR_Reader.php | 4 + 14 files changed, 205 insertions(+), 28 deletions(-) create mode 100644 packages/playground/data-liberation/src/import/WP_Entity_Iterator_Chain.php create mode 100644 packages/playground/data-liberation/src/import/WP_Retry_Frontloading_Iterator.php diff --git a/packages/php-wasm/compile/php/Dockerfile b/packages/php-wasm/compile/php/Dockerfile index 1c4c9f94dcf..0c5bef72150 100644 --- a/packages/php-wasm/compile/php/Dockerfile +++ b/packages/php-wasm/compile/php/Dockerfile @@ -569,6 +569,7 @@ export ASYNCIFY_ONLY=$'"rc_dtor_func",\ "_php_stream_fill_read_buffer",\ "_php_stream_read",\ "php_stream_read_to_str",\ +"php_userstreamop_read",\ "zif_fread",\ "wasm_read",\ "php_stdiop_read",\ diff --git a/packages/php-wasm/node/asyncify/8_3_0/php_8_3.wasm b/packages/php-wasm/node/asyncify/8_3_0/php_8_3.wasm index 8b8b0c94d691b08e11672ca887923df3c82af5db..5c35cb2d32f414b8d463e7fdc47fac33a9119b9e 100755 GIT binary patch delta 1861302 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