概述

wp_ajax_delete_plugin() 是一个 WordPress AJAX 处理函数，用于通过 AJAX 请求删除插件。它执行安全检查、权限验证、文件系统连接检查，并调用 delete_plugins() 函数完成删除操作。

关键要点

• 函数通过 check_ajax_referer() 验证 AJAX 请求的 nonce，确保安全性。
• 需要 POST 参数 'slug' 和 'plugin'，否则返回错误信息。
• 使用 current_user_can('delete_plugins') 检查用户权限，validate_file() 验证插件路径。
• 如果插件处于激活状态，则不允许删除。
• 通过 request_filesystem_credentials() 和 WP_Filesystem() 检查文件系统连接。
• 调用 delete_plugins() 执行删除，并根据结果返回 JSON 成功或错误响应。

代码示例

function wp_ajax_delete_plugin() {
	check_ajax_referer( 'updates' );

	if ( empty( $_POST['slug'] ) || empty( $_POST['plugin'] ) ) {
		wp_send_json_error(
			array(
				'slug'         => '',
				'errorCode'    => 'no_plugin_specified',
				'errorMessage' => __( 'No plugin specified.' ),
			)
		);
	}

	$plugin = plugin_basename( sanitize_text_field( wp_unslash( $_POST['plugin'] ) ) );

	$status = array(
		'delete' => 'plugin',
		'slug'   => sanitize_key( wp_unslash( $_POST['slug'] ) ),
	);

	if ( ! current_user_can( 'delete_plugins' ) || 0 !== validate_file( $plugin ) ) {
		$status['errorMessage'] = __( 'Sorry, you are not allowed to delete plugins for this site.' );
		wp_send_json_error( $status );
	}

	$plugin_data          = get_plugin_data( WP_PLUGIN_DIR . '/' . $plugin );
	$status['plugin']     = $plugin;
	$status['pluginName'] = $plugin_data['Name'];

	if ( is_plugin_active( $plugin ) ) {
		$status['errorMessage'] = __( 'You cannot delete a plugin while it is active on the main site.' );
		wp_send_json_error( $status );
	}

	// Check filesystem credentials. `delete_plugins()` will bail otherwise.
	$url = wp_nonce_url( 'plugins.php?action=delete-selected&verify-delete;=1&checked;[]=' . $plugin, 'bulk-plugins' );

	ob_start();
	$credentials = request_filesystem_credentials( $url );
	ob_end_clean();

	if ( false === $credentials || ! WP_Filesystem( $credentials ) ) {
		global $wp_filesystem;

		$status['errorCode']    = 'unable_to_connect_to_filesystem';
		$status['errorMessage'] = __( 'Unable to connect to the filesystem. Please confirm your credentials.' );

		// Pass through the error from WP_Filesystem if one was raised.
		if ( $wp_filesystem instanceof WP_Filesystem_Base && is_wp_error( $wp_filesystem->errors ) && $wp_filesystem->errors->has_errors() ) {
			$status['errorMessage'] = esc_html( $wp_filesystem->errors->get_error_message() );
		}

		wp_send_json_error( $status );
	}

	$result = delete_plugins( array( $plugin ) );

	if ( is_wp_error( $result ) ) {
		$status['errorMessage'] = $result->get_error_message();
		wp_send_json_error( $status );
	} elseif ( false === $result ) {
		$status['errorMessage'] = __( 'Plugin could not be deleted.' );
		wp_send_json_error( $status );
	}

	wp_send_json_success( $status );
}

注意事项

• 此函数仅处理 AJAX 请求，通常通过 admin-ajax.php 调用。
• 删除插件前必须确保插件已停用，否则会返回错误。
• 文件系统连接失败时，会返回详细的错误信息，包括 WP_Filesystem 的错误。
• 函数返回 JSON 格式的响应，开发者需在前端处理这些响应。