# wp_delete_post()

URL: https://chugunov.pro/api-wordpress/functions/wp_delete_post/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 1.0.0.

## Сигнатура

```php
wp_delete_post( int $post_id, bool $force_delete = false ): WP_Post|false|null
```

## Описание

При окончательном удалении записи или страницы удаляется и всё, что с ней связано. Сюда входят комментарии, метаполя записи и термины, связанные с записью.
Запись или страница перемещается в Корзину, а не удаляется окончательно, если только Корзина не отключена, элемент уже не находится в Корзине или $force_delete не равно true.
См. alsowp_delete_attachment()

wp_trash_post()

## Параметры

- `$post_id` `int` — обязательный. ID записи. (Значение по умолчанию 0 оставлено по историческим причинам; передавать его неправильно.)
- `$force_delete` `bool` — необязательный, по умолчанию `false`. Обходить ли корзину и принудительно удалять.

## Возвращаемое значение

`WP_Post|false|null`

## Исходный код

Файл: `wp-includes/post.php:3772`

```php
function wp_delete_post( $post_id = 0, $force_delete = false ) {
	global $wpdb;

	$post_id = (int) $post_id;
	if ( $post_id <= 0 ) {
		_doing_it_wrong( __FUNCTION__, __( 'The post ID must be greater than 0.' ), '6.9.0' );
		return false;
	}

	$post = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM $wpdb->posts WHERE ID = %d", $post_id ) );

	if ( ! $post ) {
		return $post;
	}

	$post = get_post( $post );

	if ( ! $force_delete
		&& ( 'post' === $post->post_type || 'page' === $post->post_type )
		&& 'trash' !== get_post_status( $post_id ) && EMPTY_TRASH_DAYS
	) {
		return wp_trash_post( $post_id );
	}

	if ( 'attachment' === $post->post_type ) {
		return wp_delete_attachment( $post_id, $force_delete );
	}

	/**
	 * Filters whether a post deletion should take place.
	 *
	 * @since 4.4.0
	 *
	 * @param WP_Post|false|null $check        Whether to go forward with deletion. Anything other than null will short-circuit deletion.
	 * @param WP_Post            $post         Post object.
	 * @param bool               $force_delete Whether to bypass the Trash.
	 */
	$check = apply_filters( 'pre_delete_post', null, $post, $force_delete );
	if ( null !== $check ) {
		return $check;
	}

	/**
	 * Fires before a post is deleted, at the start of wp_delete_post().
	 *
	 * @since 3.2.0
	 * @since 5.5.0 Added the `$post` parameter.
	 *
	 * @see wp_delete_post()
	 *
	 * @param int     $post_id Post ID.
	 * @param WP_Post $post    Post object.
	 */
	do_action( 'before_delete_post', $post_id, $post );

	delete_post_meta( $post_id, '_wp_trash_meta_status' );
	delete_post_meta( $post_id, '_wp_trash_meta_time' );

	wp_delete_object_term_relationships( $post_id, get_object_taxonomies( $post->post_type ) );

	$parent_data  = array( 'post_parent' => $post->post_parent );
	$parent_where = array( 'post_parent' => $post_id );

	if ( is_post_type_hierarchical( $post->post_type ) ) {
		// Point children of this page to its parent, also clean the cache of affected children.
		$children_query = $wpdb->prepare(
			"SELECT * FROM $wpdb->posts WHERE post_parent = %d AND post_type = %s",
			$post_id,
			$post->post_type
		);

		$children = $wpdb->get_results( $children_query );

		if ( $children ) {
			$wpdb->update( $wpdb->posts, $parent_data, $parent_where + array( 'post_type' => $post->post_type ) );
		}
	}

	// Do raw query. wp_get_post_revisions() is filtered.
	$revision_ids = $wpdb->get_col(
		$wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'revision'", $post_id )
	);

	// Use wp_delete_post (via wp_delete_post_revision) again. Ensures any meta/misplaced data gets cleaned up.
	foreach ( $revision_ids as $revision_id ) {
		wp_delete_post_revision( $revision_id );
	}

	// Point all attachments to this post up one level.
	$wpdb->update( $wpdb->posts, $parent_data, $parent_where + array( 'post_type' => 'attachment' ) );

	wp_defer_comment_counting( true );

	$comment_ids = $wpdb->get_col(
		$wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_post_ID = %d ORDER BY comment_ID DESC", $post_id )
	);

	foreach ( $comment_ids as $comment_id ) {
		wp_delete_comment( $comment_id, true );
	}

	wp_defer_comment_counting( false );

	$post_meta_ids = $wpdb->get_col(
		$wpdb->prepare( "SELECT meta_id FROM $wpdb->postmeta WHERE post_id = %d ", $post_id )
	);

	foreach ( $post_meta_ids as $mid ) {
		delete_metadata_by_mid( 'post', $mid );
	}

	/**
	 * Fires immediately before a post is deleted from the database.
	 *
	 * The dynamic portion of the hook name, `$post->post_type`, refers to
	 * the post type slug.
	 *
	 * @since 6.6.0
	 *
	 * @param int     $post_id Post ID.
	 * @param WP_Post $post    Post object.
	 */
	do_action( "delete_post_{$post->post_type}", $post_id, $post );

	/**
	 * Fires immediately before a post is deleted from the database.
	 *
	 * @since 1.2.0
	 * @since 5.5.0 Added the `$post` parameter.
	 *
	 * @param int     $post_id Post ID.
	 * @param WP_Post $post    Post object.
	 */
	do_action( 'delete_post', $post_id, $post );

	$result = $wpdb->delete( $wpdb->posts, array( 'ID' => $post_id ) );
	if ( ! $result ) {
		return false;
	}

	/**
	 * Fires immediately after a post is deleted from the database.
	 *
	 * The dynamic portion of the hook name, `$post->post_type`, refers to
	 * the post type slug.
	 *
	 * @since 6.6.0
	 *
	 * @param int     $post_id Post ID.
	 * @param WP_Post $post    Post object.
	 */
	do_action( "deleted_post_{$post->post_type}", $post_id, $post );

	/**
	 * Fires immediately after a post is deleted from the database.
	 *
	 * @since 2.2.0
	 * @since 5.5.0 Added the `$post` parameter.
	 *
	 * @param int     $post_id Post ID.
	 * @param WP_Post $post    Post object.
	 */
	do_action( 'deleted_post', $post_id, $post );

	clean_post_cache( $post );

	if ( is_post_type_hierarchical( $post->post_type ) && $children ) {
		foreach ( $children as $child ) {
			clean_post_cache( $child );
		}
	}

	wp_clear_scheduled_hook( 'publish_future_post', array( $post_id ) );

	/**
	 * Fires after a post is deleted, at the conclusion of wp_delete_post().
	 *
	 * @since 3.2.0
	 * @since 5.5.0 Added the `$post` parameter.
	 *
	 * @see wp_delete_post()
	 *
	 * @param int     $post_id Post ID.
	 * @param WP_Post $post    Post object.
	 */
	do_action( 'after_delete_post', $post_id, $post );

	return $post;
}
```

## История изменений

- 1.0.0 — Introduced.

## Связанные

Использует: [`wp_clear_scheduled_hook`](https://chugunov.pro/api-wordpress/functions/wp_clear_scheduled_hook/), [`wp_delete_object_term_relationships`](https://chugunov.pro/api-wordpress/functions/wp_delete_object_term_relationships/), [`get_object_taxonomies`](https://chugunov.pro/api-wordpress/functions/get_object_taxonomies/), [`clean_post_cache`](https://chugunov.pro/api-wordpress/functions/clean_post_cache/), [`wp_delete_attachment`](https://chugunov.pro/api-wordpress/functions/wp_delete_attachment/), [`wp_trash_post`](https://chugunov.pro/api-wordpress/functions/wp_trash_post/), [`delete_post_meta`](https://chugunov.pro/api-wordpress/functions/delete_post_meta/), [`get_post_status`](https://chugunov.pro/api-wordpress/functions/get_post_status/), [`is_post_type_hierarchical`](https://chugunov.pro/api-wordpress/functions/is_post_type_hierarchical/), [`wp_delete_post_revision`](https://chugunov.pro/api-wordpress/functions/wp_delete_post_revision/), `wpdb::get_row`, `wpdb::update`, `wpdb::get_col`, `wpdb::delete`, [`wp_defer_comment_counting`](https://chugunov.pro/api-wordpress/functions/wp_defer_comment_counting/), [`wp_delete_comment`](https://chugunov.pro/api-wordpress/functions/wp_delete_comment/), [`delete_metadata_by_mid`](https://chugunov.pro/api-wordpress/functions/delete_metadata_by_mid/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`_doing_it_wrong`](https://chugunov.pro/api-wordpress/functions/_doing_it_wrong/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), [`do_action`](https://chugunov.pro/api-wordpress/functions/do_action/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/), `wpdb::get_results`, `wpdb::prepare`.
Используется в: [`_wp_after_delete_font_family`](https://chugunov.pro/api-wordpress/functions/_wp_after_delete_font_family/), `WP_REST_Menu_Items_Controller::delete_item`, `WP_REST_Templates_Controller::update_item`, `WP_REST_Templates_Controller::delete_item`, `WP_Privacy_Requests_Table::process_bulk_action`, `WP_Customize_Manager::handle_dismiss_autosave_or_lock_request`, `WP_Customize_Manager::trash_changeset_post`, [`_wp_delete_customize_changeset_dependent_auto_drafts`](https://chugunov.pro/api-wordpress/functions/_wp_delete_customize_changeset_dependent_auto_drafts/), `WP_Customize_Manager::save_changeset_post`, `WP_REST_Revisions_Controller::delete_item`, `WP_REST_Posts_Controller::delete_item`, `WP_Customize_Nav_Menu_Item_Setting::update`, [`wpmu_delete_user`](https://chugunov.pro/api-wordpress/functions/wpmu_delete_user/), [`wp_delete_user`](https://chugunov.pro/api-wordpress/functions/wp_delete_user/), [`wp_ajax_save_attachment`](https://chugunov.pro/api-wordpress/functions/wp_ajax_save_attachment/), [`wp_ajax_delete_post`](https://chugunov.pro/api-wordpress/functions/wp_ajax_delete_post/), [`wp_ajax_delete_page`](https://chugunov.pro/api-wordpress/functions/wp_ajax_delete_page/), [`_wp_delete_orphaned_draft_menu_items`](https://chugunov.pro/api-wordpress/functions/_wp_delete_orphaned_draft_menu_items/), [`wp_nav_menu_update_menu_items`](https://chugunov.pro/api-wordpress/functions/wp_nav_menu_update_menu_items/), [`wp_scheduled_delete`](https://chugunov.pro/api-wordpress/functions/wp_scheduled_delete/), [`wp_delete_auto_drafts`](https://chugunov.pro/api-wordpress/functions/wp_delete_auto_drafts/), [`wp_trash_post`](https://chugunov.pro/api-wordpress/functions/wp_trash_post/), [`wp_delete_post_revision`](https://chugunov.pro/api-wordpress/functions/wp_delete_post_revision/), [`_wp_delete_post_menu_item`](https://chugunov.pro/api-wordpress/functions/_wp_delete_post_menu_item/), [`_wp_delete_tax_menu_item`](https://chugunov.pro/api-wordpress/functions/_wp_delete_tax_menu_item/), [`wp_delete_nav_menu`](https://chugunov.pro/api-wordpress/functions/wp_delete_nav_menu/), `wp_xmlrpc_server::blogger_deletePost`, `wp_xmlrpc_server::wp_deletePage`, `wp_xmlrpc_server::wp_deletePost`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_delete_post/