wp_upgrade()

Runs WordPress Upgrade functions.

Contents

Description Description

Upgrades the database if needed during a site update.

Source Source

File: wp-admin/includes/upgrade.php

627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
function wp_upgrade() {
    global $wp_current_db_version, $wp_db_version, $wpdb;
 
    $wp_current_db_version = __get_option( 'db_version' );
 
    // We are up-to-date. Nothing to do.
    if ( $wp_db_version == $wp_current_db_version ) {
        return;
    }
 
    if ( ! is_blog_installed() ) {
        return;
    }
 
    wp_check_mysql_version();
    wp_cache_flush();
    pre_schema_upgrade();
    make_db_current_silent();
    upgrade_all();
    if ( is_multisite() && is_main_site() ) {
        upgrade_network();
    }
    wp_cache_flush();
 
    if ( is_multisite() ) {
        $site_id = get_current_blog_id();
 
        if ( $wpdb->get_row( $wpdb->prepare( "SELECT blog_id FROM {$wpdb->blog_versions} WHERE blog_id = %d", $site_id ) ) ) {
            $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->blog_versions} SET db_version = %d WHERE blog_id = %d", $wp_db_version, $site_id ) );
        } else {
            $wpdb->query( $wpdb->prepare( "INSERT INTO {$wpdb->blog_versions} ( `blog_id` , `db_version` , `last_updated` ) VALUES ( %d, %d, NOW() );", $site_id, $wp_db_version ) );
        }
    }
 
    /**
     * Fires after a site is fully upgraded.
     *
     * @since 3.9.0
     *
     * @param int $wp_db_version         The new $wp_db_version.
     * @param int $wp_current_db_version The old (current) $wp_db_version.
     */
    do_action( 'wp_upgrade', $wp_db_version, $wp_current_db_version );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
2.1.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-admin/includes/upgrade.php: wp_check_mysql_version()

Checks the version of the installed MySQL binary.
wp-admin/includes/upgrade.php: pre_schema_upgrade()

Runs before the schema is upgraded.
wp-admin/includes/upgrade.php: make_db_current_silent()

Updates the database tables to a new schema, but without displaying results.
wp-admin/includes/upgrade.php: upgrade_network()

Executes network-level upgrade routines.
wp-admin/includes/upgrade.php: wp_upgrade

Fires after a site is fully upgraded.
wp-includes/cache.php: wp_cache_flush()

Removes all cache items.
wp-includes/load.php: is_multisite()

If Multisite is enabled.
wp-includes/load.php: get_current_blog_id()

Retrieve the current site ID.
wp-includes/functions.php: is_main_site()

Determine whether a site is the main site of the current network.
wp-includes/functions.php: is_blog_installed()

Determines whether WordPress is already installed.
wp-includes/plugin.php: do_action()

Execute functions hooked on a specific action hook.
wp-includes/wp-db.php: wpdb::get_row()

Retrieve one row from the database.
wp-includes/wp-db.php: wpdb::query()

Perform a MySQL database query, using current database connection.
wp-includes/wp-db.php: wpdb::prepare()

Prepares a SQL query for safe execution. Uses sprintf()-like syntax.
Show 9 more uses Hide more uses

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.