wp_delete_user( int $id, int $reassign = null ): bool

350function wp_delete_user( $id, $reassign = null ) {351	global $wpdb;352 353	if ( ! is_numeric( $id ) ) {354		return false;355	}356 357	$id   = (int) $id;358	$user = new WP_User( $id );359 360	if ( ! $user->exists() ) {361		return false;362	}363 364	// Normalize $reassign to null or a user ID. 'novalue' was an older default.365	if ( 'novalue' === $reassign ) {366		$reassign = null;367	} elseif ( null !== $reassign ) {368		$reassign = (int) $reassign;369	}370 371	/**372	 * Fires immediately before a user is deleted from the site.373	 *374	 * Note that on a Multisite installation the user only gets removed from the site375	 * and does not get deleted from the database.376	 *377	 * @since 2.0.0378	 * @since 5.5.0 Added the `$user` parameter.379	 *380	 * @param int      $id       ID of the user to delete.381	 * @param int|null $reassign ID of the user to reassign posts and links to.382	 *                           Default null, for no reassignment.383	 * @param WP_User  $user     WP_User object of the user to delete.384	 */385	do_action( 'delete_user', $id, $reassign, $user );386 387	if ( null === $reassign ) {388		$post_types_to_delete = array();389		foreach ( get_post_types( array(), 'objects' ) as $post_type ) {390			if ( $post_type->delete_with_user ) {391				$post_types_to_delete[] = $post_type->name;392			} elseif ( null === $post_type->delete_with_user && post_type_supports( $post_type->name, 'author' ) ) {393				$post_types_to_delete[] = $post_type->name;394			}395		}396 397		/**398		 * Filters the list of post types to delete with a user.399		 *400		 * @since 3.4.0401		 *402		 * @param string[] $post_types_to_delete Array of post types to delete.403		 * @param int      $id                   User ID.404		 */405		$post_types_to_delete = apply_filters( 'post_types_to_delete_with_user', $post_types_to_delete, $id );406		$post_types_to_delete = implode( "', '", $post_types_to_delete );407		$post_ids             = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_author = %d AND post_type IN ('$post_types_to_delete')", $id ) );408		if ( $post_ids ) {409			foreach ( $post_ids as $post_id ) {410				wp_delete_post( $post_id );411			}412		}413 414		// Clean links.415		$link_ids = $wpdb->get_col( $wpdb->prepare( "SELECT link_id FROM $wpdb->links WHERE link_owner = %d", $id ) );416 417		if ( $link_ids ) {418			foreach ( $link_ids as $link_id ) {419				wp_delete_link( $link_id );420			}421		}422	} else {423		$post_ids = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_author = %d", $id ) );424		$wpdb->update( $wpdb->posts, array( 'post_author' => $reassign ), array( 'post_author' => $id ) );425		if ( ! empty( $post_ids ) ) {426			foreach ( $post_ids as $post_id ) {427				clean_post_cache( $post_id );428			}429		}
When	Instructions	Calls it makes
`!$id`	6	none
`$id && !->exists()`	15	`->exists()`
`$id && ->exists() && $reassign === null && is_multisite()`	89–99	`->exists(), do_action(), get_post_types(), apply_filters(), ->prepare(), ->get_col(), ->prepare(), ->get_col(), is_multisite(), get_current_blog_id(), remove_user_from_blog(), clean_user_cache(), do_action()`
`$id && ->exists() && $reassign !== null && is_multisite()`	92–100	`->exists(), do_action(), ->prepare(), ->get_col(), post_author(), ->prepare(), ->get_col(), link_owner(), is_multisite(), get_current_blog_id(), remove_user_from_blog(), clean_user_cache(), do_action()`
`$id && ->exists() && $reassign === null && !is_multisite()`	103–114	`->exists(), do_action(), get_post_types(), apply_filters(), ->prepare(), ->get_col(), ->prepare(), ->get_col(), is_multisite(), ->prepare(), ->get_col(), ID(), clean_user_cache(), do_action()`
`$id && ->exists() && $reassign !== null && !is_multisite()`	106–115	`->exists(), do_action(), ->prepare(), ->get_col(), post_author(), ->prepare(), ->get_col(), link_owner(), is_multisite(), ->prepare(), ->get_col(), ID(), clean_user_cache(), do_action()`
PHP	Compiled	Executed	Branches	Notes
8.6-dev	218	6–115	25
8.5	218	6–115	25
8.4	218	6–115	25	5 fewer instructions than PHP 8.3
8.3	223	8–119	25
8.2	223	8–119	25
8.1	223	8–119	25
7.4	223	8–119	25