Add opt-in site delete table-prefix cleanup flag

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>

Author: Copilot

features/site.feature

@@ -78,6 +78,41 @@ Feature: Manage sites in a multisite installation
     When I try the previous command again
     Then the return code should be 1
 
+  @skip-windows
+  Scenario: Delete a site by id and remove all prefixed tables
+    Given a WP multisite subdirectory install
+
+    When I run `wp site create --slug=first --porcelain`
+    Then STDOUT should be a number
+    And save STDOUT as {SITE_ID}
+    And I run `wp db query "CREATE TABLE wp_{SITE_ID}_custom_data (id INTEGER PRIMARY KEY);"`
+    And I run `wp site delete {SITE_ID} --yes --delete-tables-with-prefix`
+    Then STDOUT should contain:
+      """
+      Success: The site at '
+      """
+
+    When I run `wp db query "CREATE TABLE wp_{SITE_ID}_custom_data (id INTEGER PRIMARY KEY);"`
+    Then STDOUT should be empty
+    And the return code should be 0
+    And I run `wp db query "DROP TABLE wp_{SITE_ID}_custom_data;"`
+
+  @skip-windows
+  Scenario: Deleting a site cannot combine keep-tables with delete-tables-with-prefix
+    Given a WP multisite subdirectory install
+
+    When I run `wp site create --slug=first --porcelain`
+    Then STDOUT should be a number
+    And save STDOUT as {SITE_ID}
+
+    When I try `wp site delete {SITE_ID} --yes --keep-tables --delete-tables-with-prefix`
+    Then STDERR should be:
+      """
+      Error: The '--keep-tables' and '--delete-tables-with-prefix' flags cannot be used together.
+      """
+    And STDOUT should be empty
+    And the return code should be 1
+
   @skip-windows
   Scenario: Filter site list
     Given a WP multisite install

src/Site_Command.php

@@ -288,6 +288,9 @@ public function empty_( $args, $assoc_args ) {
 	 * [--keep-tables]
 	 * : Delete the blog from the list, but don't drop its tables.
 	 *
+	 * [--delete-tables-with-prefix]
+	 * : Delete all tables with the site's database table prefix after deleting the site.
+	 *
 	 * ## EXAMPLES
 	 *
 	 *     $ wp site delete 123
@@ -299,6 +302,10 @@ public function delete( $args, $assoc_args ) {
 			WP_CLI::error( 'This is not a multisite installation.' );
 		}
 
+		if ( Utils\get_flag_value( $assoc_args, 'keep-tables' ) && Utils\get_flag_value( $assoc_args, 'delete-tables-with-prefix' ) ) {
+			WP_CLI::error( "The '--keep-tables' and '--delete-tables-with-prefix' flags cannot be used together." );
+		}
+
 		if ( isset( $assoc_args['slug'] ) ) {
 			$blog_id = get_id_from_blogname( $assoc_args['slug'] );
 			if ( null === $blog_id ) {
@@ -329,9 +336,39 @@ public function delete( $args, $assoc_args ) {
 
 		wpmu_delete_blog( (int) $blog->blog_id, ! Utils\get_flag_value( $assoc_args, 'keep-tables' ) );
 
+		if ( Utils\get_flag_value( $assoc_args, 'delete-tables-with-prefix' ) ) {
+			$this->drop_tables_with_prefix( (int) $blog->blog_id );
+		}
+
 		WP_CLI::success( "The site at '{$site_url}' was deleted." );
 	}
 
+	/**
+	 * Drops all database tables for a site prefix.
+	 *
+	 * @param int $blog_id Site ID.
+	 */
+	private function drop_tables_with_prefix( $blog_id ) {
+		global $wpdb;
+
+		$prefix_like = $wpdb->esc_like( $wpdb->get_blog_prefix( $blog_id ) ) . '%';
+		$tables      = $wpdb->get_col( $wpdb->prepare( 'SHOW TABLES LIKE %s', $prefix_like ) );
+
+		if ( empty( $tables ) ) {
+			return;
+		}
+
+		$tables = array_map(
+			static function ( $table ) {
+				return '`' . str_replace( '`', '``', $table ) . '`';
+			},
+			$tables
+		);
+
+		// phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- Table identifiers are escaped and cannot be passed as placeholders.
+		$wpdb->query( 'DROP TABLE IF EXISTS ' . implode( ', ', $tables ) );
+	}
+
 	/**
 	 * Gets details about a site in a multisite installation.
 	 *