enmi-conf.org: comparison wp/wp-admin/includes/upgrade.php

equal deleted inserted replaced

-:490d5cc509ed
+:cf61fcea0001
 *
 * @package WordPress
 * @subpackage Administration
 */
-/** Include user install customize script. */
+/** Include user installation customization script. */
 if ( file_exists(WP_CONTENT_DIR . '/install.php') )
 	require (WP_CONTENT_DIR . '/install.php');
 /** WordPress Administration API */
 require_once(ABSPATH . 'wp-admin/includes/admin.php');
 * Runs the required functions to set up and populate the database,
 * including primary admin user and initial options.
 *
 * @since 2.1.0
 *
-* @param string $blog_title    Blog title.
+* @param string $blog_title    Site title.
 * @param string $user_name     User's username.
 * @param string $user_email    User's email.
-* @param bool   $public        Whether blog is public.
+* @param bool   $public        Whether site is public.
 * @param string $deprecated    Optional. Not used.
 * @param string $user_password Optional. User's chosen password. Default empty (random password).
 * @param string $language      Optional. Language chosen. Default empty.
 * @return array Array keys 'url', 'user_id', 'password', and 'password_message'.
 */
 function wp_install( $blog_title, $user_name, $user_email, $public, $deprecated = '', $user_password = '', $language = '' ) {
 	if ( !empty( $deprecated ) )
-		_deprecated_argument( __FUNCTION__, '2.6' );
+		_deprecated_argument( __FUNCTION__, '2.6.0' );
 	wp_check_mysql_version();
 	wp_cache_flush();
 	make_db_current_silent();
 	populate_options();
 	update_option('blogname', $blog_title);
 	update_option('admin_email', $user_email);
 	update_option('blog_public', $public);
+	// Freshness of site - in the future, this could get more specific about actions taken, perhaps.
+	update_option( 'fresh_site', 1 );
 	if ( $language ) {
 		update_option( 'WPLANG', $language );
 	}
 	$guessurl = wp_guess_url();
 	if ( ! $public )
 		update_option('default_pingback_flag', 0);
 	/*
 	 * Create default user. If the user already exists, the user tables are
-	 * being shared among blogs. Just set the role in that case.
+	 * being shared among sites. Just set the role in that case.
 	 */
 	$user_id = username_exists($user_name);
 	$user_password = trim($user_password);
 	$email_password = false;
 	if ( !$user_id && empty($user_password) ) {
 	wp_install_maybe_enable_pretty_permalinks();
 	flush_rewrite_rules();
-	wp_new_blog_notification($blog_title, $guessurl, $user_id, ($email_password ? $user_password : __('The password you chose during the install.') ) );
+	wp_new_blog_notification($blog_title, $guessurl, $user_id, ($email_password ? $user_password : __('The password you chose during installation.') ) );
 	wp_cache_flush();
 	/**
 	 * Fires after a site is fully installed.
 * Adds the default "Uncategorized" category, the first post (with comment),
 * first page, and default widgets for default theme for the current version.
 *
 * @since 2.1.0
 *
+* @global wpdb       $wpdb
+* @global WP_Rewrite $wp_rewrite
+* @global string     $table_prefix
+*
 * @param int $user_id User ID.
 */
 function wp_install_defaults( $user_id ) {
 	global $wpdb, $wp_rewrite, $table_prefix;
 	$first_post_guid = get_option( 'home' ) . '/?p=1';
 	if ( is_multisite() ) {
 		$first_post = get_site_option( 'first_post' );
-		if ( empty($first_post) )
+		if ( ! $first_post ) {
-			$first_post = __( 'Welcome to <a href="SITE_URL">SITE_NAME</a>. This is your first post. Edit or delete it, then start blogging!' );
+			/* translators: %s: site link */
+			$first_post = __( 'Welcome to %s. This is your first post. Edit or delete it, then start blogging!' );
-		$first_post = str_replace( "SITE_URL", esc_url( network_home_url() ), $first_post );
+		}
-		$first_post = str_replace( "SITE_NAME", get_current_site()->site_name, $first_post );
+		$first_post = sprintf( $first_post,
+			sprintf( '<a href="%s">%s</a>', esc_url( network_home_url() ), get_network()->site_name )
+		);
+		// Back-compat for pre-4.4
+		$first_post = str_replace( 'SITE_URL', esc_url( network_home_url() ), $first_post );
+		$first_post = str_replace( 'SITE_NAME', get_network()->site_name, $first_post );
 	} else {
-		$first_post = __('Welcome to WordPress. This is your first post. Edit or delete it, then start blogging!');
+		$first_post = __( 'Welcome to WordPress. This is your first post. Edit or delete it, then start writing!' );
 	}
 	$wpdb->insert( $wpdb->posts, array(
-								'post_author' => $user_id,
+		'post_author' => $user_id,
-								'post_date' => $now,
+		'post_date' => $now,
-								'post_date_gmt' => $now_gmt,
+		'post_date_gmt' => $now_gmt,
-								'post_content' => $first_post,
+		'post_content' => $first_post,
-								'post_excerpt' => '',
+		'post_excerpt' => '',
-								'post_title' => __('Hello world!'),
+		'post_title' => __('Hello world!'),
-								/* translators: Default post slug */
+		/* translators: Default post slug */
-								'post_name' => sanitize_title( _x('hello-world', 'Default post slug') ),
+		'post_name' => sanitize_title( _x('hello-world', 'Default post slug') ),
-								'post_modified' => $now,
+		'post_modified' => $now,
-								'post_modified_gmt' => $now_gmt,
+		'post_modified_gmt' => $now_gmt,
-								'guid' => $first_post_guid,
+		'guid' => $first_post_guid,
-								'comment_count' => 1,
+		'comment_count' => 1,
-								'to_ping' => '',
+		'to_ping' => '',
-								'pinged' => '',
+		'pinged' => '',
-								'post_content_filtered' => ''
+		'post_content_filtered' => ''
-								));
+	));
 	$wpdb->insert( $wpdb->term_relationships, array('term_taxonomy_id' => $cat_tt_id, 'object_id' => 1) );
 	// Default comment
-	$first_comment_author = __('Mr WordPress');
-	$first_comment_url = 'https://wordpress.org/';
-	$first_comment = __('Hi, this is a comment.
-To delete a comment, just log in and view the post&#039;s comments. There you will have the option to edit or delete them.');
 	if ( is_multisite() ) {
-		$first_comment_author = get_site_option( 'first_comment_author', $first_comment_author );
+		$first_comment_author = get_site_option( 'first_comment_author' );
+		$first_comment_email = get_site_option( 'first_comment_email' );
 		$first_comment_url = get_site_option( 'first_comment_url', network_home_url() );
-		$first_comment = get_site_option( 'first_comment', $first_comment );
+		$first_comment = get_site_option( 'first_comment' );
 	}
+	$first_comment_author = ! empty( $first_comment_author ) ? $first_comment_author : __( 'A WordPress Commenter' );
+	$first_comment_email = ! empty( $first_comment_email ) ? $first_comment_email : 'wapuu@wordpress.example';
+	$first_comment_url = ! empty( $first_comment_url ) ? $first_comment_url : 'https://wordpress.org/';
+	$first_comment = ! empty( $first_comment ) ? $first_comment :  __( 'Hi, this is a comment.
+To get started with moderating, editing, and deleting comments, please visit the Comments screen in the dashboard.
+Commenter avatars come from <a href="https://gravatar.com">Gravatar</a>.' );
 	$wpdb->insert( $wpdb->comments, array(
-								'comment_post_ID' => 1,
+		'comment_post_ID' => 1,
-								'comment_author' => $first_comment_author,
+		'comment_author' => $first_comment_author,
-								'comment_author_email' => '',
+		'comment_author_email' => $first_comment_email,
-								'comment_author_url' => $first_comment_url,
+		'comment_author_url' => $first_comment_url,
-								'comment_date' => $now,
+		'comment_date' => $now,
-								'comment_date_gmt' => $now_gmt,
+		'comment_date_gmt' => $now_gmt,
-								'comment_content' => $first_comment
+		'comment_content' => $first_comment
-								));
+	));
 	// First Page
-	$first_page = sprintf( __( "This is an example page. It's different from a blog post because it will stay in one place and will show up in your site navigation (in most themes). Most people start with an About page that introduces them to potential site visitors. It might say something like this:
+	if ( is_multisite() )
+		$first_page = get_site_option( 'first_page' );
-<blockquote>Hi there! I'm a bike messenger by day, aspiring actor by night, and this is my blog. I live in Los Angeles, have a great dog named Jack, and I like pi&#241;a coladas. (And gettin' caught in the rain.)</blockquote>
+	$first_page = ! empty( $first_page ) ? $first_page : sprintf( __( "This is an example page. It's different from a blog post because it will stay in one place and will show up in your site navigation (in most themes). Most people start with an About page that introduces them to potential site visitors. It might say something like this:
+<blockquote>Hi there! I'm a bike messenger by day, aspiring actor by night, and this is my website. I live in Los Angeles, have a great dog named Jack, and I like pi&#241;a coladas. (And gettin' caught in the rain.)</blockquote>
 ...or something like this:
 <blockquote>The XYZ Doohickey Company was founded in 1971, and has been providing quality doohickeys to the public ever since. Located in Gotham City, XYZ employs over 2,000 people and does all kinds of awesome things for the Gotham community.</blockquote>
 As a new WordPress user, you should go to <a href=\"%s\">your dashboard</a> to delete this page and create new pages for your content. Have fun!" ), admin_url() );
-	if ( is_multisite() )
-		$first_page = get_site_option( 'first_page', $first_page );
 	$first_post_guid = get_option('home') . '/?page_id=2';
 	$wpdb->insert( $wpdb->posts, array(
-								'post_author' => $user_id,
+		'post_author' => $user_id,
-								'post_date' => $now,
+		'post_date' => $now,
-								'post_date_gmt' => $now_gmt,
+		'post_date_gmt' => $now_gmt,
-								'post_content' => $first_page,
+		'post_content' => $first_page,
-								'post_excerpt' => '',
+		'post_excerpt' => '',
-								'post_title' => __( 'Sample Page' ),
+		'comment_status' => 'closed',
-								/* translators: Default page slug */
+		'post_title' => __( 'Sample Page' ),
-								'post_name' => __( 'sample-page' ),
+		/* translators: Default page slug */
-								'post_modified' => $now,
+		'post_name' => __( 'sample-page' ),
-								'post_modified_gmt' => $now_gmt,
+		'post_modified' => $now,
-								'guid' => $first_post_guid,
+		'post_modified_gmt' => $now_gmt,
-								'post_type' => 'page',
+		'guid' => $first_post_guid,
-								'to_ping' => '',
+		'post_type' => 'page',
-								'pinged' => '',
+		'to_ping' => '',
-								'post_content_filtered' => ''
+		'pinged' => '',
-								));
+		'post_content_filtered' => ''
+	));
 	$wpdb->insert( $wpdb->postmeta, array( 'post_id' => 2, 'meta_key' => '_wp_page_template', 'meta_value' => 'default' ) );
+	// Privacy Policy page
+	if ( is_multisite() ) {
+		// Disable by default unless the suggested content is provided.
+		$privacy_policy_content = get_site_option( 'default_privacy_policy_content' );
+	} else {
+		if ( ! class_exists( 'WP_Privacy_Policy_Content' ) ) {
+			include_once( ABSPATH . 'wp-admin/includes/misc.php' );
+		}
+		$privacy_policy_content = WP_Privacy_Policy_Content::get_default_content();
+	}
+	if ( ! empty( $privacy_policy_content ) ) {
+		$privacy_policy_guid = get_option( 'home' ) . '/?page_id=3';
+		$wpdb->insert(
+			$wpdb->posts, array(
+				'post_author'           => $user_id,
+				'post_date'             => $now,
+				'post_date_gmt'         => $now_gmt,
+				'post_content'          => $privacy_policy_content,
+				'post_excerpt'          => '',
+				'comment_status'        => 'closed',
+				'post_title'            => __( 'Privacy Policy' ),
+				/* translators: Privacy Policy page slug */
+				'post_name'             => __( 'privacy-policy' ),
+				'post_modified'         => $now,
+				'post_modified_gmt'     => $now_gmt,
+				'guid'                  => $privacy_policy_guid,
+				'post_type'             => 'page',
+				'post_status'           => 'draft',
+				'to_ping'               => '',
+				'pinged'                => '',
+				'post_content_filtered' => '',
+			)
+		);
+		$wpdb->insert(
+			$wpdb->postmeta, array(
+				'post_id'    => 3,
+				'meta_key'   => '_wp_page_template',
+				'meta_value' => 'default',
+			)
+		);
+		update_option( 'wp_page_for_privacy_policy', 3 );
+	}
 	// Set up default widgets for default theme.
 	update_option( 'widget_search', array ( 2 => array ( 'title' => '' ), '_multiwidget' => 1 ) );
 	update_option( 'widget_recent-posts', array ( 2 => array ( 'title' => '', 'number' => 5 ), '_multiwidget' => 1 ) );
 	update_option( 'widget_recent-comments', array ( 2 => array ( 'title' => '', 'number' => 5 ), '_multiwidget' => 1 ) );
 	update_option( 'widget_archives', array ( 2 => array ( 'title' => '', 'count' => 0, 'dropdown' => 0 ), '_multiwidget' => 1 ) );
 	update_option( 'widget_categories', array ( 2 => array ( 'title' => '', 'count' => 0, 'hierarchical' => 0, 'dropdown' => 0 ), '_multiwidget' => 1 ) );
 	update_option( 'widget_meta', array ( 2 => array ( 'title' => '' ), '_multiwidget' => 1 ) );
-	update_option( 'sidebars_widgets', array ( 'wp_inactive_widgets' => array (), 'sidebar-1' => array ( 0 => 'search-2', 1 => 'recent-posts-2', 2 => 'recent-comments-2', 3 => 'archives-2', 4 => 'categories-2', 5 => 'meta-2', ), 'array_version' => 3 ) );
+	update_option( 'sidebars_widgets', array( 'wp_inactive_widgets' => array(), 'sidebar-1' => array( 0 => 'search-2', 1 => 'recent-posts-2', 2 => 'recent-comments-2', 3 => 'archives-2', 4 => 'categories-2', 5 => 'meta-2' ), 'sidebar-2' => array(), 'sidebar-3' => array(), 'array_version' => 3 ) );
 	if ( ! is_multisite() )
 		update_user_meta( $user_id, 'show_welcome_panel', 1 );
 	elseif ( ! is_super_admin( $user_id ) && ! metadata_exists( 'user', $user_id, 'show_welcome_panel' ) )
 		update_user_meta( $user_id, 'show_welcome_panel', 2 );
 	}
 }
 endif;
 /**
-* Maybe enable pretty permalinks on install.
+* Maybe enable pretty permalinks on installation.
 *
 * If after enabling pretty permalinks don't work, fallback to query-string permalinks.
 *
 * @since 4.2.0
 *
 	 	 * Flush rules with the hard option to force refresh of the web-server's
 	 	 * rewrite config file (e.g. .htaccess or web.config).
 	 	 */
 		$wp_rewrite->flush_rules( true );
-		// Test against a real WordPress Post, or if none were created, a random 404 page.
+		$test_url = '';
-		$test_url = get_permalink( 1 );
+		// Test against a real WordPress Post
-		if ( ! $test_url ) {
+		$first_post = get_page_by_path( sanitize_title( _x( 'hello-world', 'Default post slug' ) ), OBJECT, 'post' );
-			$test_url = home_url( '/wordpress-check-for-rewrites/' );
+		if ( $first_post ) {
+			$test_url = get_permalink( $first_post->ID );
 		}
 		/*
 	 	 * Send a request to the site, and check whether
 	 	 * the 'x-pingback' header is returned as expected.
 * Sends an email with wp_mail to the new administrator that the site setup is complete,
 * and provides them with a record of their login credentials.
 *
 * @since 2.1.0
 *
-* @param string $blog_title Blog title.
+* @param string $blog_title Site title.
-* @param string $blog_url   Blog url.
+* @param string $blog_url   Site url.
 * @param int    $user_id    User ID.
 * @param string $password   User's Password.
 */
 function wp_new_blog_notification($blog_title, $blog_url, $user_id, $password) {
 	$user = new WP_User( $user_id );
 	$email = $user->user_email;
 	$name = $user->user_login;
 	$login_url = wp_login_url();
+	/* translators: New site notification email. 1: New site URL, 2: User login, 3: User password or password reset link, 4: Login URL */
 	$message = sprintf( __( "Your new WordPress site has been successfully set up at:
 %1\$s
 You can log in to the administrator account with the following information:
 *
 * Upgrades the database if needed during a site update.
 *
 * @since 2.1.0
 *
-* @return null If no update is necessary or site isn't completely installed, null.
+* @global int  $wp_current_db_version
+* @global int  $wp_db_version
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function wp_upgrade() {
 	global $wp_current_db_version, $wp_db_version, $wpdb;
 	$wp_current_db_version = __get_option('db_version');
 	if ( is_multisite() && is_main_site() )
 		upgrade_network();
 	wp_cache_flush();
 	if ( is_multisite() ) {
-		if ( $wpdb->get_row( "SELECT blog_id FROM {$wpdb->blog_versions} WHERE blog_id = '{$wpdb->blogid}'" ) )
+		$site_id = get_current_blog_id();
-			$wpdb->query( "UPDATE {$wpdb->blog_versions} SET db_version = '{$wp_db_version}' WHERE blog_id = '{$wpdb->blogid}'" );
-		else
+		if ( $wpdb->get_row( $wpdb->prepare( "SELECT blog_id FROM {$wpdb->blog_versions} WHERE blog_id = %d", $site_id ) ) ) {
-			$wpdb->query( "INSERT INTO {$wpdb->blog_versions} ( `blog_id` , `db_version` , `last_updated` ) VALUES ( '{$wpdb->blogid}', '{$wp_db_version}', NOW());" );
+			$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.
 	 *
 	do_action( 'wp_upgrade', $wp_db_version, $wp_current_db_version );
 }
 endif;
 /**
-* Functions to be called in install and upgrade scripts.
+* Functions to be called in installation and upgrade scripts.
 *
 * Contains conditional checks to determine which upgrade scripts to run,
 * based on database version and WP version being updated-to.
 *
+* @ignore
 * @since 1.0.1
 *
-* @return null If no update is necessary, null.
+* @global int $wp_current_db_version
+* @global int $wp_db_version
 */
 function upgrade_all() {
 	global $wp_current_db_version, $wp_db_version;
 	$wp_current_db_version = __get_option('db_version');
 		upgrade_380();
 	if ( $wp_current_db_version < 29630 )
 		upgrade_400();
-	// Don't harsh my mellow. upgrade_422() must be called before
+	if ( $wp_current_db_version < 33055 )
-	// upgrade_420() to catch bad comments prior to any auto-expansion of
+		upgrade_430();
-	// MySQL column widths.
-	if ( $wp_current_db_version < 31534 )
+	if ( $wp_current_db_version < 33056 )
-		upgrade_422();
+		upgrade_431();
-	if ( $wp_current_db_version < 31351 )
+	if ( $wp_current_db_version < 35700 )
-		upgrade_420();
+		upgrade_440();
+	if ( $wp_current_db_version < 36686 )
+		upgrade_450();
+	if ( $wp_current_db_version < 37965 )
+		upgrade_460();
 	maybe_disable_link_manager();
 	maybe_disable_automattic_widgets();
 }
 /**
 * Execute changes made in WordPress 1.0.
 *
+* @ignore
 * @since 1.0.0
+*
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function upgrade_100() {
 	global $wpdb;
 	// Get the title and ID of every post, post_name to check if it already has a value
 	$posts = $wpdb->get_results("SELECT ID, post_title, post_name FROM $wpdb->posts WHERE post_name = ''");
 	if ($posts) {
-		foreach($posts as $post) {
+		foreach ($posts as $post) {
 			if ('' == $post->post_name) {
 				$newtitle = sanitize_title($post->post_title);
 				$wpdb->query( $wpdb->prepare("UPDATE $wpdb->posts SET post_name = %s WHERE ID = %d", $newtitle, $post->ID) );
 			}
 		}
 }
 /**
 * Execute changes made in WordPress 1.0.1.
 *
+* @ignore
 * @since 1.0.1
+*
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function upgrade_101() {
 	global $wpdb;
 	// Clean up indices, add a few
 }
 /**
 * Execute changes made in WordPress 1.2.
 *
+* @ignore
 * @since 1.2.0
+*
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function upgrade_110() {
 	global $wpdb;
 	// Set user_nicename.
 }
 /**
 * Execute changes made in WordPress 1.5.
 *
+* @ignore
 * @since 1.5.0
+*
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function upgrade_130() {
 	global $wpdb;
 	// Remove extraneous backslashes.
 	$posts = $wpdb->get_results("SELECT ID, post_title, post_content, post_excerpt, guid, post_date, post_name, post_status, post_author FROM $wpdb->posts");
 	if ($posts) {
-		foreach($posts as $post) {
+		foreach ($posts as $post) {
 			$post_content = addslashes(deslash($post->post_content));
 			$post_title = addslashes(deslash($post->post_title));
 			$post_excerpt = addslashes(deslash($post->post_excerpt));
 			if ( empty($post->guid) )
 				$guid = get_permalink($post->ID);
 	}
 	// Remove extraneous backslashes.
 	$comments = $wpdb->get_results("SELECT comment_ID, comment_author, comment_content FROM $wpdb->comments");
 	if ($comments) {
-		foreach($comments as $comment) {
+		foreach ($comments as $comment) {
 			$comment_content = deslash($comment->comment_content);
 			$comment_author = deslash($comment->comment_author);
 			$wpdb->update($wpdb->comments, compact('comment_content', 'comment_author'), array('comment_ID' => $comment->comment_ID) );
 		}
 	}
 	// Remove extraneous backslashes.
 	$links = $wpdb->get_results("SELECT link_id, link_name, link_description FROM $wpdb->links");
 	if ($links) {
-		foreach($links as $link) {
+		foreach ($links as $link) {
 			$link_name = deslash($link->link_name);
 			$link_description = deslash($link->link_description);
 			$wpdb->update( $wpdb->links, compact('link_name', 'link_description'), array('link_id' => $link->link_id) );
 		}
 }
 /**
 * Execute changes made in WordPress 2.0.
 *
+* @ignore
 * @since 2.0.0
+*
+* @global wpdb $wpdb WordPress database abstraction object.
+* @global int  $wp_current_db_version
 */
 function upgrade_160() {
 	global $wpdb, $wp_current_db_version;
 	populate_roles_160();
 }
 /**
 * Execute changes made in WordPress 2.1.
 *
+* @ignore
 * @since 2.1.0
+*
+* @global wpdb $wpdb WordPress database abstraction object.
+* @global int  $wp_current_db_version
 */
 function upgrade_210() {
 	global $wpdb, $wp_current_db_version;
 	if ( $wp_current_db_version < 3506 ) {
 }
 /**
 * Execute changes made in WordPress 2.3.
 *
+* @ignore
 * @since 2.3.0
+*
+* @global wpdb $wpdb WordPress database abstraction object.
+* @global int  $wp_current_db_version
 */
 function upgrade_230() {
 	global $wp_current_db_version, $wpdb;
 	if ( $wp_current_db_version < 5200 ) {
 }
 /**
 * Remove old options from the database.
 *
+* @ignore
 * @since 2.3.0
+*
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function upgrade_230_options_table() {
 	global $wpdb;
 	$old_options_fields = array( 'option_can_override', 'option_type', 'option_width', 'option_height', 'option_description', 'option_admin_level' );
 	$wpdb->hide_errors();
 }
 /**
 * Remove old categories, link2cat, and post2cat database tables.
 *
+* @ignore
 * @since 2.3.0
+*
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function upgrade_230_old_tables() {
 	global $wpdb;
 	$wpdb->query('DROP TABLE IF EXISTS ' . $wpdb->prefix . 'categories');
 	$wpdb->query('DROP TABLE IF EXISTS ' . $wpdb->prefix . 'link2cat');
 }
 /**
 * Upgrade old slugs made in version 2.2.
 *
+* @ignore
 * @since 2.2.0
+*
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function upgrade_old_slugs() {
 	// Upgrade people who were using the Redirect Old Slugs plugin.
 	global $wpdb;
 	$wpdb->query("UPDATE $wpdb->postmeta SET meta_key = '_wp_old_slug' WHERE meta_key = 'old_slug'");
 }
 /**
 * Execute changes made in WordPress 2.5.0.
 *
+* @ignore
 * @since 2.5.0
+*
+* @global int $wp_current_db_version
 */
 function upgrade_250() {
 	global $wp_current_db_version;
 	if ( $wp_current_db_version < 6689 ) {
 }
 /**
 * Execute changes made in WordPress 2.5.2.
 *
+* @ignore
 * @since 2.5.2
+*
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function upgrade_252() {
 	global $wpdb;
 	$wpdb->query("UPDATE $wpdb->users SET user_activation_key = ''");
 }
 /**
 * Execute changes made in WordPress 2.6.
 *
+* @ignore
 * @since 2.6.0
+*
+* @global int $wp_current_db_version
 */
 function upgrade_260() {
 	global $wp_current_db_version;
 	if ( $wp_current_db_version < 8000 )
 }
 /**
 * Execute changes made in WordPress 2.7.
 *
+* @ignore
 * @since 2.7.0
+*
+* @global wpdb $wpdb WordPress database abstraction object.
+* @global int  $wp_current_db_version
 */
 function upgrade_270() {
 	global $wpdb, $wp_current_db_version;
 	if ( $wp_current_db_version < 8980 )
 }
 /**
 * Execute changes made in WordPress 2.8.
 *
+* @ignore
 * @since 2.8.0
+*
+* @global int  $wp_current_db_version
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function upgrade_280() {
 	global $wp_current_db_version, $wpdb;
 	if ( $wp_current_db_version < 10360 )
 		populate_roles_280();
 	if ( is_multisite() ) {
 		$start = 0;
 		while( $rows = $wpdb->get_results( "SELECT option_name, option_value FROM $wpdb->options ORDER BY option_id LIMIT $start, 20" ) ) {
-			foreach( $rows as $row ) {
+			foreach ( $rows as $row ) {
 				$value = $row->option_value;
 				if ( !@unserialize( $value ) )
 					$value = stripslashes( $value );
 				if ( $value !== $row->option_value ) {
 					update_option( $row->option_name, $value );
 				}
 			}
 			$start += 20;
 		}
-		refresh_blog_details( $wpdb->blogid );
+		clean_blog_cache( get_current_blog_id() );
 	}
 }
 /**
 * Execute changes made in WordPress 2.9.
 *
+* @ignore
 * @since 2.9.0
+*
+* @global int $wp_current_db_version
 */
 function upgrade_290() {
 	global $wp_current_db_version;
 	if ( $wp_current_db_version < 11958 ) {
 }
 /**
 * Execute changes made in WordPress 3.0.
 *
+* @ignore
 * @since 3.0.0
+*
+* @global int  $wp_current_db_version
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function upgrade_300() {
 	global $wp_current_db_version, $wpdb;
 	if ( $wp_current_db_version < 15093 )
 	if ( $wp_current_db_version < 14139 && is_multisite() && is_main_site() && ! defined( 'MULTISITE' ) && get_site_option( 'siteurl' ) === false )
 		add_site_option( 'siteurl', '' );
 	// 3.0 screen options key name changes.
-	if ( is_main_site() && !defined('DO_NOT_UPGRADE_GLOBAL_TABLES') ) {
+	if ( wp_should_upgrade_global_tables() ) {
 		$sql = "DELETE FROM $wpdb->usermeta
 			WHERE meta_key LIKE %s
 			OR meta_key LIKE %s
 			OR meta_key LIKE %s
 			OR meta_key LIKE %s
 }
 /**
 * Execute changes made in WordPress 3.3.
 *
+* @ignore
 * @since 3.3.0
+*
+* @global int   $wp_current_db_version
+* @global wpdb  $wpdb
+* @global array $wp_registered_widgets
+* @global array $sidebars_widgets
 */
 function upgrade_330() {
 	global $wp_current_db_version, $wpdb, $wp_registered_widgets, $sidebars_widgets;
-	if ( $wp_current_db_version < 19061 && is_main_site() && ! defined( 'DO_NOT_UPGRADE_GLOBAL_TABLES' ) ) {
+	if ( $wp_current_db_version < 19061 && wp_should_upgrade_global_tables() ) {
 		$wpdb->query( "DELETE FROM $wpdb->usermeta WHERE meta_key IN ('show_admin_bar_admin', 'plugins_last_view')" );
 	}
 	if ( $wp_current_db_version >= 11548 )
 		return;
 }
 /**
 * Execute changes made in WordPress 3.4.
 *
+* @ignore
 * @since 3.4.0
+*
+* @global int   $wp_current_db_version
+* @global wpdb  $wpdb
 */
 function upgrade_340() {
 	global $wp_current_db_version, $wpdb;
 	if ( $wp_current_db_version < 19798 ) {
 		$wpdb->hide_errors();
 		$wpdb->query("ALTER TABLE $wpdb->comments DROP INDEX comment_approved");
 		$wpdb->show_errors();
 	}
-	if ( $wp_current_db_version < 20022 && is_main_site() && ! defined( 'DO_NOT_UPGRADE_GLOBAL_TABLES' ) ) {
+	if ( $wp_current_db_version < 20022 && wp_should_upgrade_global_tables() ) {
 		$wpdb->query( "DELETE FROM $wpdb->usermeta WHERE meta_key = 'themes_last_view'" );
 	}
 	if ( $wp_current_db_version < 20080 ) {
 		if ( 'yes' == $wpdb->get_var( "SELECT autoload FROM $wpdb->options WHERE option_name = 'uninstall_plugins'" ) ) {
 }
 /**
 * Execute changes made in WordPress 3.5.
 *
+* @ignore
 * @since 3.5.0
+*
+* @global int   $wp_current_db_version
+* @global wpdb  $wpdb
 */
 function upgrade_350() {
 	global $wp_current_db_version, $wpdb;
 	if ( $wp_current_db_version < 22006 && $wpdb->get_var( "SELECT link_id FROM $wpdb->links LIMIT 1" ) )
 		update_option( 'link_manager_enabled', 1 ); // Previously set to 0 by populate_options()
-	if ( $wp_current_db_version < 21811 && is_main_site() && ! defined( 'DO_NOT_UPGRADE_GLOBAL_TABLES' ) ) {
+	if ( $wp_current_db_version < 21811 && wp_should_upgrade_global_tables() ) {
 		$meta_keys = array();
 		foreach ( array_merge( get_post_types(), get_taxonomies() ) as $name ) {
 			if ( false !== strpos( $name, '-' ) )
 			$meta_keys[] = 'edit_' . str_replace( '-', '_', $name ) . '_per_page';
 		}
 }
 /**
 * Execute changes made in WordPress 3.7.
 *
+* @ignore
 * @since 3.7.0
+*
+* @global int $wp_current_db_version
 */
 function upgrade_370() {
 	global $wp_current_db_version;
 	if ( $wp_current_db_version < 25824 )
 		wp_clear_scheduled_hook( 'wp_auto_updates_maybe_update' );
 }
 /**
 * Execute changes made in WordPress 3.7.2.
 *
+* @ignore
 * @since 3.7.2
 * @since 3.8.0
+*
+* @global int $wp_current_db_version
 */
 function upgrade_372() {
 	global $wp_current_db_version;
 	if ( $wp_current_db_version < 26148 )
 		wp_clear_scheduled_hook( 'wp_maybe_auto_update' );
 }
 /**
 * Execute changes made in WordPress 3.8.0.
 *
+* @ignore
 * @since 3.8.0
+*
+* @global int $wp_current_db_version
 */
 function upgrade_380() {
 	global $wp_current_db_version;
 	if ( $wp_current_db_version < 26691 ) {
 		deactivate_plugins( array( 'mp6/mp6.php' ), true );
 }
 /**
 * Execute changes made in WordPress 4.0.0.
 *
+* @ignore
 * @since 4.0.0
+*
+* @global int $wp_current_db_version
 */
 function upgrade_400() {
 	global $wp_current_db_version;
 	if ( $wp_current_db_version < 29630 ) {
 		if ( ! is_multisite() && false === get_option( 'WPLANG' ) ) {
 }
 /**
 * Execute changes made in WordPress 4.2.0.
 *
+* @ignore
 * @since 4.2.0
-*/
+*
-function upgrade_420() {
+* @global int   $wp_current_db_version
+* @global wpdb  $wpdb
+*/
+function upgrade_420() {}
+/**
+* Executes changes made in WordPress 4.3.0.
+*
+* @ignore
+* @since 4.3.0
+*
+* @global int  $wp_current_db_version Current version.
+* @global wpdb $wpdb                  WordPress database abstraction object.
+*/
+function upgrade_430() {
 	global $wp_current_db_version, $wpdb;
-	if ( $wp_current_db_version < 31351 && $wpdb->charset === 'utf8mb4' ) {
+	if ( $wp_current_db_version < 32364 ) {
+		upgrade_430_fix_comments();
+	}
+	// Shared terms are split in a separate process.
+	if ( $wp_current_db_version < 32814 ) {
+		update_option( 'finished_splitting_shared_terms', 0 );
+		wp_schedule_single_event( time() + ( 1 * MINUTE_IN_SECONDS ), 'wp_split_shared_term_batch' );
+	}
+	if ( $wp_current_db_version < 33055 && 'utf8mb4' === $wpdb->charset ) {
 		if ( is_multisite() ) {
 			$tables = $wpdb->tables( 'blog' );
 		} else {
 			$tables = $wpdb->tables( 'all' );
+			if ( ! wp_should_upgrade_global_tables() ) {
+				$global_tables = $wpdb->tables( 'global' );
+				$tables = array_diff_assoc( $tables, $global_tables );
+			}
 		}
 		foreach ( $tables as $table ) {
 			maybe_convert_table_to_utf8mb4( $table );
 		}
 	}
 }
 /**
-* Execute changes made in WordPress 4.2.1.
+* Executes comments changes made in WordPress 4.3.0.
 *
-* @since 4.2.1
+* @ignore
-*/
+* @since 4.3.0
-function upgrade_421() {
+*
-}
+* @global int  $wp_current_db_version Current version.
+* @global wpdb $wpdb                  WordPress database abstraction object.
-/**
+*/
-* Execute changes made in WordPress 4.2.2.
+function upgrade_430_fix_comments() {
-*
-* @since 4.2.2
-*/
-function upgrade_422() {
 	global $wp_current_db_version, $wpdb;
-	if ( $wp_current_db_version < 31534 ) {
+	$content_length = $wpdb->get_col_length( $wpdb->comments, 'comment_content' );
-		$content_length = $wpdb->get_col_length( $wpdb->comments, 'comment_content' );
+	if ( is_wp_error( $content_length ) ) {
-		if ( is_wp_error( $content_length ) ) {
+		return;
-			return;
+	}
-		}
+	if ( false === $content_length ) {
-		if ( false === $content_length ) {
+		$content_length = array(
-			$content_length = array(
+			'type'   => 'byte',
-				'type'   => 'byte',
+			'length' => 65535,
-				'length' => 65535,
-			);
-		} elseif ( ! is_array( $content_length ) ) {
-			$length = (int) $content_length > 0 ? (int) $content_length : 65535;
-			$content_length = array(
-				'type'	 => 'byte',
-				'length' => $length
-			);
-		}
-		if ( 'byte' !== $content_length['type'] || 0 === $content_length['length'] ) {
-			// Sites with malformed DB schemas are on their own.
-			return;
-		}
-		$allowed_length = intval( $content_length['length'] ) - 10;
-		$comments = $wpdb->get_results(
-			"SELECT `comment_ID` FROM `{$wpdb->comments}`
-				WHERE `comment_date_gmt` > '2015-04-26'
-				AND LENGTH( `comment_content` ) >= {$allowed_length}
-				AND ( `comment_content` LIKE '%<%' OR `comment_content` LIKE '%>%' )"
 		);
+	} elseif ( ! is_array( $content_length ) ) {
-		foreach ( $comments as $comment ) {
+		$length = (int) $content_length > 0 ? (int) $content_length : 65535;
-			wp_delete_comment( $comment->comment_ID, true );
+		$content_length = array(
+			'type'	 => 'byte',
+			'length' => $length
+		);
+	}
+	if ( 'byte' !== $content_length['type'] || 0 === $content_length['length'] ) {
+		// Sites with malformed DB schemas are on their own.
+		return;
+	}
+	$allowed_length = intval( $content_length['length'] ) - 10;
+	$comments = $wpdb->get_results(
+		"SELECT `comment_ID` FROM `{$wpdb->comments}`
+			WHERE `comment_date_gmt` > '2015-04-26'
+			AND LENGTH( `comment_content` ) >= {$allowed_length}
+			AND ( `comment_content` LIKE '%<%' OR `comment_content` LIKE '%>%' )"
+	);
+	foreach ( $comments as $comment ) {
+		wp_delete_comment( $comment->comment_ID, true );
+	}
+}
+/**
+* Executes changes made in WordPress 4.3.1.
+*
+* @ignore
+* @since 4.3.1
+*/
+function upgrade_431() {
+	// Fix incorrect cron entries for term splitting
+	$cron_array = _get_cron_array();
+	if ( isset( $cron_array['wp_batch_split_terms'] ) ) {
+		unset( $cron_array['wp_batch_split_terms'] );
+		_set_cron_array( $cron_array );
+	}
+}
+/**
+* Executes changes made in WordPress 4.4.0.
+*
+* @ignore
+* @since 4.4.0
+*
+* @global int  $wp_current_db_version Current version.
+* @global wpdb $wpdb                  WordPress database abstraction object.
+*/
+function upgrade_440() {
+	global $wp_current_db_version, $wpdb;
+	if ( $wp_current_db_version < 34030 ) {
+		$wpdb->query( "ALTER TABLE {$wpdb->options} MODIFY option_name VARCHAR(191)" );
+	}
+	// Remove the unused 'add_users' role.
+	$roles = wp_roles();
+	foreach ( $roles->role_objects as $role ) {
+		if ( $role->has_cap( 'add_users' ) ) {
+			$role->remove_cap( 'add_users' );
+		}
+	}
+}
+/**
+* Executes changes made in WordPress 4.5.0.
+*
+* @ignore
+* @since 4.5.0
+*
+* @global int  $wp_current_db_version Current database version.
+* @global wpdb $wpdb                  WordPress database abstraction object.
+*/
+function upgrade_450() {
+	global $wp_current_db_version, $wpdb;
+	if ( $wp_current_db_version < 36180 ) {
+		wp_clear_scheduled_hook( 'wp_maybe_auto_update' );
+	}
+	// Remove unused email confirmation options, moved to usermeta.
+	if ( $wp_current_db_version < 36679 && is_multisite() ) {
+		$wpdb->query( "DELETE FROM $wpdb->options WHERE option_name REGEXP '^[0-9]+_new_email$'" );
+	}
+	// Remove unused user setting for wpLink.
+	delete_user_setting( 'wplink' );
+}
+/**
+* Executes changes made in WordPress 4.6.0.
+*
+* @ignore
+* @since 4.6.0
+*
+* @global int $wp_current_db_version Current database version.
+*/
+function upgrade_460() {
+	global $wp_current_db_version;
+	// Remove unused post meta.
+	if ( $wp_current_db_version < 37854 ) {
+		delete_post_meta_by_key( '_post_restored_from' );
+	}
+	// Remove plugins with callback as an array object/method as the uninstall hook, see #13786.
+	if ( $wp_current_db_version < 37965 ) {
+		$uninstall_plugins = get_option( 'uninstall_plugins', array() );
+		if ( ! empty( $uninstall_plugins ) ) {
+			foreach ( $uninstall_plugins as $basename => $callback ) {
+				if ( is_array( $callback ) && is_object( $callback[0] ) ) {
+					unset( $uninstall_plugins[ $basename ] );
+				}
+			}
+			update_option( 'uninstall_plugins', $uninstall_plugins );
 		}
 	}
 }
 /**
 * Executes network-level upgrade routines.
 *
 * @since 3.0.0
+*
+* @global int   $wp_current_db_version
+* @global wpdb  $wpdb
 */
 function upgrade_network() {
 	global $wp_current_db_version, $wpdb;
-	// Always.
+	// Always clear expired transients
-	if ( is_main_network() ) {
+	delete_expired_transients( true );
-		/*
-		 * Deletes all expired transients. The multi-table delete syntax is used
-		 * to delete the transient record from table a, and the corresponding
-		 * transient_timeout record from table b.
-		 */
-		$time = time();
-		$sql = "DELETE a, b FROM $wpdb->sitemeta a, $wpdb->sitemeta b
-			WHERE a.meta_key LIKE %s
-			AND a.meta_key NOT LIKE %s
-			AND b.meta_key = CONCAT( '_site_transient_timeout_', SUBSTRING( a.meta_key, 17 ) )
-			AND b.meta_value < %d";
-		$wpdb->query( $wpdb->prepare( $sql, $wpdb->esc_like( '_site_transient_' ) . '%', $wpdb->esc_like ( '_site_transient_timeout_' ) . '%', $time ) );
-	}
 	// 2.8.
 	if ( $wp_current_db_version < 11549 ) {
 		$wpmu_sitewide_plugins = get_site_option( 'wpmu_sitewide_plugins' );
 		$active_sitewide_plugins = get_site_option( 'active_sitewide_plugins' );
 		delete_site_option( 'wpmu_sitewide_plugins' );
 		delete_site_option( 'deactivated_sitewide_plugins' );
 		$start = 0;
 		while( $rows = $wpdb->get_results( "SELECT meta_key, meta_value FROM {$wpdb->sitemeta} ORDER BY meta_id LIMIT $start, 20" ) ) {
-			foreach( $rows as $row ) {
+			foreach ( $rows as $row ) {
 				$value = $row->meta_value;
 				if ( !@unserialize( $value ) )
 					$value = stripslashes( $value );
 				if ( $value !== $row->meta_value ) {
 					update_site_option( $row->meta_key, $value );
 		}
 	}
 	// 4.2
 	if ( $wp_current_db_version < 31351 && $wpdb->charset === 'utf8mb4' ) {
-		if ( ! ( defined( 'DO_NOT_UPGRADE_GLOBAL_TABLES' ) && DO_NOT_UPGRADE_GLOBAL_TABLES ) ) {
+		if ( wp_should_upgrade_global_tables() ) {
 			$wpdb->query( "ALTER TABLE $wpdb->usermeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
 			$wpdb->query( "ALTER TABLE $wpdb->site DROP INDEX domain, ADD INDEX domain(domain(140),path(51))" );
 			$wpdb->query( "ALTER TABLE $wpdb->sitemeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
 			$wpdb->query( "ALTER TABLE $wpdb->signups DROP INDEX domain_path, ADD INDEX domain_path(domain(140),path(51))" );
 			$tables = $wpdb->tables( 'global' );
+			// sitecategories may not exist.
+			if ( ! $wpdb->get_var( "SHOW TABLES LIKE '{$tables['sitecategories']}'" ) ) {
+				unset( $tables['sitecategories'] );
+			}
 			foreach ( $tables as $table ) {
 				maybe_convert_table_to_utf8mb4( $table );
 			}
 		}
 	}
-	// 4.2.2
+	// 4.3
-	if ( $wp_current_db_version < 31535 && 'utf8mb4' === $wpdb->charset ) {
+	if ( $wp_current_db_version < 33055 && 'utf8mb4' === $wpdb->charset ) {
-		if ( ! ( defined( 'DO_NOT_UPGRADE_GLOBAL_TABLES' ) && DO_NOT_UPGRADE_GLOBAL_TABLES ) ) {
+		if ( wp_should_upgrade_global_tables() ) {
 			$upgrade = false;
 			$indexes = $wpdb->get_results( "SHOW INDEXES FROM $wpdb->signups" );
-			foreach( $indexes as $index ) {
+			foreach ( $indexes as $index ) {
 				if ( 'domain_path' == $index->Key_name && 'domain' == $index->Column_name && 140 != $index->Sub_part ) {
 					$upgrade = true;
 					break;
 				}
 			}
 			if ( $upgrade ) {
 				$wpdb->query( "ALTER TABLE $wpdb->signups DROP INDEX domain_path, ADD INDEX domain_path(domain(140),path(51))" );
 			}
+			$tables = $wpdb->tables( 'global' );
+			// sitecategories may not exist.
+			if ( ! $wpdb->get_var( "SHOW TABLES LIKE '{$tables['sitecategories']}'" ) ) {
+				unset( $tables['sitecategories'] );
+			}
+			foreach ( $tables as $table ) {
+				maybe_convert_table_to_utf8mb4( $table );
+			}
 		}
 	}
 }
 //
 * already present. It doesn't rely on MySQL's "IF NOT EXISTS" statement, but chooses
 * to query all tables first and then run the SQL statement creating the table.
 *
 * @since 1.0.0
 *
+* @global wpdb  $wpdb
+*
 * @param string $table_name Database table name to create.
 * @param string $create_ddl SQL statement to create table.
 * @return bool If table already exists or was created by function.
 */
 function maybe_create_table($table_name, $create_ddl) {
 /**
 * Drops a specified index from a table.
 *
 * @since 1.0.1
 *
+* @global wpdb  $wpdb
+*
 * @param string $table Database table name.
 * @param string $index Index name to drop.
-* @return bool True, when finished.
+* @return true True, when finished.
 */
 function drop_index($table, $index) {
 	global $wpdb;
 	$wpdb->hide_errors();
 	$wpdb->query("ALTER TABLE `$table` DROP INDEX `$index`");
 /**
 * Adds an index to a specified table.
 *
 * @since 1.0.1
 *
+* @global wpdb  $wpdb
+*
 * @param string $table Database table name.
 * @param string $index Database table index column.
-* @return bool True, when done with execution.
+* @return true True, when done with execution.
 */
 function add_clean_index($table, $index) {
 	global $wpdb;
 	drop_index($table, $index);
 	$wpdb->query("ALTER TABLE `$table` ADD INDEX ( `$index` )");
 /**
 * Adds column to a database table if it doesn't already exist.
 *
 * @since 1.3.0
 *
+* @global wpdb  $wpdb
+*
 * @param string $table_name  The table name to modify.
 * @param string $column_name The column name to add to the table.
 * @param string $create_ddl  The SQL statement used to add the column.
-* @return True if already exists or on successful completion, false on error.
+* @return bool True if already exists or on successful completion, false on error.
 */
 function maybe_add_column($table_name, $column_name, $create_ddl) {
 	global $wpdb;
 	foreach ($wpdb->get_col("DESC $table_name", 0) as $column ) {
 		if ($column == $column_name) {
 /**
 * If a table only contains utf8 or utf8mb4 columns, convert it to utf8mb4.
 *
 * @since 4.2.0
+*
+* @global wpdb  $wpdb
 *
 * @param string $table The table to convert.
 * @return bool true if the table was converted, false if it wasn't.
 */
 function maybe_convert_table_to_utf8mb4( $table ) {
 				return false;
 			}
 		}
 	}
+	$table_details = $wpdb->get_row( "SHOW TABLE STATUS LIKE '$table'" );
+	if ( ! $table_details ) {
+		return false;
+	}
+	list( $table_charset ) = explode( '_', $table_details->Collation );
+	$table_charset = strtolower( $table_charset );
+	if ( 'utf8mb4' === $table_charset ) {
+		return true;
+	}
 	return $wpdb->query( "ALTER TABLE $table CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci" );
 }
 /**
 * Retrieve all options as it was for 1.2.
 *
 * @since 1.2.0
+*
+* @global wpdb  $wpdb
 *
 * @return stdClass List of options.
 */
 function get_alloptions_110() {
 	global $wpdb;
 	}
 	return $all_options;
 }
 /**
-* Utility version of get_option that is private to install/upgrade.
+* Utility version of get_option that is private to installation/upgrade.
 *
 * @ignore
 * @since 1.5.1
 * @access private
+*
+* @global wpdb  $wpdb
 *
 * @param string $setting Option name.
 * @return mixed
 */
 function __get_option($setting) {
 * Modifies the database based on specified SQL statements.
 *
 * Useful for creating new tables and updating existing tables to a new structure.
 *
 * @since 1.5.0
+*
+* @global wpdb  $wpdb
 *
 * @param string|array $queries Optional. The query to run. Can be multiple queries
 *                              in an array, or a string of queries separated by
 *                              semicolons. Default empty.
 * @param bool         $execute Optional. Whether or not to execute the query right away.
 		$queries = explode( ';', $queries );
 		$queries = array_filter( $queries );
 	}
 	/**
-	 * Filter the dbDelta SQL queries.
+	 * Filters the dbDelta SQL queries.
 	 *
 	 * @since 3.3.0
 	 *
 	 * @param array $queries An array of dbDelta SQL queries.
 	 */
 	$cqueries = array(); // Creation Queries
 	$iqueries = array(); // Insertion Queries
 	$for_update = array();
 	// Create a tablename index for an array ($cqueries) of queries
-	foreach($queries as $qry) {
+	foreach ($queries as $qry) {
 		if ( preg_match( "|CREATE TABLE ([^ ]*)|", $qry, $matches ) ) {
 			$cqueries[ trim( $matches[1], '`' ) ] = $qry;
 			$for_update[$matches[1]] = 'Created table '.$matches[1];
 		} elseif ( preg_match( "|CREATE DATABASE ([^ ]*)|", $qry, $matches ) ) {
 			array_unshift( $cqueries, $qry );
 			// Unrecognized query type
 		}
 	}
 	/**
-	 * Filter the dbDelta SQL queries for creating tables and/or databases.
+	 * Filters the dbDelta SQL queries for creating tables and/or databases.
 	 *
 	 * Queries filterable via this hook contain "CREATE TABLE" or "CREATE DATABASE".
 	 *
 	 * @since 3.3.0
 	 *
 	 * @param array $cqueries An array of dbDelta create SQL queries.
 	 */
 	$cqueries = apply_filters( 'dbdelta_create_queries', $cqueries );
 	/**
-	 * Filter the dbDelta SQL queries for inserting or updating.
+	 * Filters the dbDelta SQL queries for inserting or updating.
 	 *
 	 * Queries filterable via this hook contain "INSERT INTO" or "UPDATE".
 	 *
 	 * @since 3.3.0
 	 *
 	 * @param array $iqueries An array of dbDelta insert or update SQL queries.
 	 */
 	$iqueries = apply_filters( 'dbdelta_insert_queries', $iqueries );
+	$text_fields = array( 'tinytext', 'text', 'mediumtext', 'longtext' );
+	$blob_fields = array( 'tinyblob', 'blob', 'mediumblob', 'longblob' );
 	$global_tables = $wpdb->tables( 'global' );
 	foreach ( $cqueries as $table => $qry ) {
-		// Upgrade global tables only for the main site. Don't upgrade at all if DO_NOT_UPGRADE_GLOBAL_TABLES is defined.
+		// Upgrade global tables only for the main site. Don't upgrade at all if conditions are not optimal.
-		if ( in_array( $table, $global_tables ) && ( !is_main_site() || defined( 'DO_NOT_UPGRADE_GLOBAL_TABLES' ) ) ) {
+		if ( in_array( $table, $global_tables ) && ! wp_should_upgrade_global_tables() ) {
 			unset( $cqueries[ $table ], $for_update[ $table ] );
 			continue;
 		}
 		// Fetch the table column structure from the database
 		if ( ! $tablefields )
 			continue;
 		// Clear the field and index arrays.
-		$cfields = $indices = array();
+		$cfields = $indices = $indices_without_subparts = array();
 		// Get all of the field names in the query from between the parentheses.
 		preg_match("|\((.*)\)|ms", $qry, $match2);
 		$qryline = trim($match2[1]);
 		// Separate field lines into an array.
 		$flds = explode("\n", $qryline);
-		// todo: Remove this?
-		//echo "<hr/><pre>\n".print_r(strtolower($table), true).":\n".print_r($cqueries, true)."</pre><hr/>";
 		// For every field line specified in the query.
-		foreach ($flds as $fld) {
+		foreach ( $flds as $fld ) {
+			$fld = trim( $fld, " \t\n\r\0\x0B," ); // Default trim characters, plus ','.
 			// Extract the field name.
-			preg_match("|^([^ ]*)|", trim($fld), $fvals);
+			preg_match( '|^([^ ]*)|', $fld, $fvals );
 			$fieldname = trim( $fvals[1], '`' );
+			$fieldname_lowercased = strtolower( $fieldname );
 			// Verify the found field name.
 			$validfield = true;
-			switch (strtolower($fieldname)) {
+			switch ( $fieldname_lowercased ) {
-			case '':
+				case '':
-			case 'primary':
+				case 'primary':
-			case 'index':
+				case 'index':
-			case 'fulltext':
+				case 'fulltext':
-			case 'unique':
+				case 'unique':
-			case 'key':
+				case 'key':
-				$validfield = false;
+				case 'spatial':
-				$indices[] = trim(trim($fld), ", \n");
+					$validfield = false;
-				break;
+					/*
+					 * Normalize the index definition.
+					 *
+					 * This is done so the definition can be compared against the result of a
+					 * `SHOW INDEX FROM $table_name` query which returns the current table
+					 * index information.
+					 */
+					// Extract type, name and columns from the definition.
+					preg_match(
+						  '/^'
+						.   '(?P<index_type>'             // 1) Type of the index.
+						.       'PRIMARY\s+KEY|(?:UNIQUE|FULLTEXT|SPATIAL)\s+(?:KEY|INDEX)|KEY|INDEX'
+						.   ')'
+						.   '\s+'                         // Followed by at least one white space character.
+						.   '(?:'                         // Name of the index. Optional if type is PRIMARY KEY.
+						.       '`?'                      // Name can be escaped with a backtick.
+						.           '(?P<index_name>'     // 2) Name of the index.
+						.               '(?:[0-9a-zA-Z$_-]|[\xC2-\xDF][\x80-\xBF])+'
+						.           ')'
+						.       '`?'                      // Name can be escaped with a backtick.
+						.       '\s+'                     // Followed by at least one white space character.
+						.   ')*'
+						.   '\('                          // Opening bracket for the columns.
+						.       '(?P<index_columns>'
+						.           '.+?'                 // 3) Column names, index prefixes, and orders.
+						.       ')'
+						.   '\)'                          // Closing bracket for the columns.
+						. '$/im',
+						$fld,
+						$index_matches
+					);
+					// Uppercase the index type and normalize space characters.
+					$index_type = strtoupper( preg_replace( '/\s+/', ' ', trim( $index_matches['index_type'] ) ) );
+					// 'INDEX' is a synonym for 'KEY', standardize on 'KEY'.
+					$index_type = str_replace( 'INDEX', 'KEY', $index_type );
+					// Escape the index name with backticks. An index for a primary key has no name.
+					$index_name = ( 'PRIMARY KEY' === $index_type ) ? '' : '`' . strtolower( $index_matches['index_name'] ) . '`';
+					// Parse the columns. Multiple columns are separated by a comma.
+					$index_columns = $index_columns_without_subparts = array_map( 'trim', explode( ',', $index_matches['index_columns'] ) );
+					// Normalize columns.
+					foreach ( $index_columns as $id => &$index_column ) {
+						// Extract column name and number of indexed characters (sub_part).
+						preg_match(
+							  '/'
+							.   '`?'                      // Name can be escaped with a backtick.
+							.       '(?P<column_name>'    // 1) Name of the column.
+							.           '(?:[0-9a-zA-Z$_-]|[\xC2-\xDF][\x80-\xBF])+'
+							.       ')'
+							.   '`?'                      // Name can be escaped with a backtick.
+							.   '(?:'                     // Optional sub part.
+							.       '\s*'                 // Optional white space character between name and opening bracket.
+							.       '\('                  // Opening bracket for the sub part.
+							.           '\s*'             // Optional white space character after opening bracket.
+							.           '(?P<sub_part>'
+							.               '\d+'         // 2) Number of indexed characters.
+							.           ')'
+							.           '\s*'             // Optional white space character before closing bracket.
+							.        '\)'                 // Closing bracket for the sub part.
+							.   ')?'
+							. '/',
+							$index_column,
+							$index_column_matches
+						);
+						// Escape the column name with backticks.
+						$index_column = '`' . $index_column_matches['column_name'] . '`';
+						// We don't need to add the subpart to $index_columns_without_subparts
+						$index_columns_without_subparts[ $id ] = $index_column;
+						// Append the optional sup part with the number of indexed characters.
+						if ( isset( $index_column_matches['sub_part'] ) ) {
+							$index_column .= '(' . $index_column_matches['sub_part'] . ')';
+						}
+					}
+					// Build the normalized index definition and add it to the list of indices.
+					$indices[] = "{$index_type} {$index_name} (" . implode( ',', $index_columns ) . ")";
+					$indices_without_subparts[] = "{$index_type} {$index_name} (" . implode( ',', $index_columns_without_subparts ) . ")";
+					// Destroy no longer needed variables.
+					unset( $index_column, $index_column_matches, $index_matches, $index_type, $index_name, $index_columns, $index_columns_without_subparts );
+					break;
 			}
-			$fld = trim($fld);
 			// If it's a valid field, add it to the field array.
-			if ($validfield) {
+			if ( $validfield ) {
-				$cfields[strtolower($fieldname)] = trim($fld, ", \n");
+				$cfields[ $fieldname_lowercased ] = $fld;
 			}
 		}
 		// For every field in the table.
-		foreach ($tablefields as $tablefield) {
+		foreach ( $tablefields as $tablefield ) {
+			$tablefield_field_lowercased = strtolower( $tablefield->Field );
+			$tablefield_type_lowercased = strtolower( $tablefield->Type );
 			// If the table field exists in the field array ...
-			if (array_key_exists(strtolower($tablefield->Field), $cfields)) {
+			if ( array_key_exists( $tablefield_field_lowercased, $cfields ) ) {
 				// Get the field type from the query.
-				preg_match("|".$tablefield->Field." ([^ ]*( unsigned)?)|i", $cfields[strtolower($tablefield->Field)], $matches);
+				preg_match( '|`?' . $tablefield->Field . '`? ([^ ]*( unsigned)?)|i', $cfields[ $tablefield_field_lowercased ], $matches );
 				$fieldtype = $matches[1];
+				$fieldtype_lowercased = strtolower( $fieldtype );
 				// Is actual field type different from the field type in query?
 				if ($tablefield->Type != $fieldtype) {
-					// Add a query to change the column type
+					$do_change = true;
-					$cqueries[] = "ALTER TABLE {$table} CHANGE COLUMN {$tablefield->Field} " . $cfields[strtolower($tablefield->Field)];
+					if ( in_array( $fieldtype_lowercased, $text_fields ) && in_array( $tablefield_type_lowercased, $text_fields ) ) {
-					$for_update[$table.'.'.$tablefield->Field] = "Changed type of {$table}.{$tablefield->Field} from {$tablefield->Type} to {$fieldtype}";
+						if ( array_search( $fieldtype_lowercased, $text_fields ) < array_search( $tablefield_type_lowercased, $text_fields ) ) {
+							$do_change = false;
+						}
+					}
+					if ( in_array( $fieldtype_lowercased, $blob_fields ) && in_array( $tablefield_type_lowercased, $blob_fields ) ) {
+						if ( array_search( $fieldtype_lowercased, $blob_fields ) < array_search( $tablefield_type_lowercased, $blob_fields ) ) {
+							$do_change = false;
+						}
+					}
+					if ( $do_change ) {
+						// Add a query to change the column type.
+						$cqueries[] = "ALTER TABLE {$table} CHANGE COLUMN `{$tablefield->Field}` " . $cfields[ $tablefield_field_lowercased ];
+						$for_update[$table.'.'.$tablefield->Field] = "Changed type of {$table}.{$tablefield->Field} from {$tablefield->Type} to {$fieldtype}";
+					}
 				}
-				// Get the default value from the array
+				// Get the default value from the array.
-					// todo: Remove this?
+				if ( preg_match( "| DEFAULT '(.*?)'|i", $cfields[ $tablefield_field_lowercased ], $matches ) ) {
-					//echo "{$cfields[strtolower($tablefield->Field)]}<br>";
-				if (preg_match("| DEFAULT '(.*?)'|i", $cfields[strtolower($tablefield->Field)], $matches)) {
 					$default_value = $matches[1];
 					if ($tablefield->Default != $default_value) {
 						// Add a query to change the column's default value
-						$cqueries[] = "ALTER TABLE {$table} ALTER COLUMN {$tablefield->Field} SET DEFAULT '{$default_value}'";
+						$cqueries[] = "ALTER TABLE {$table} ALTER COLUMN `{$tablefield->Field}` SET DEFAULT '{$default_value}'";
 						$for_update[$table.'.'.$tablefield->Field] = "Changed default value of {$table}.{$tablefield->Field} from {$tablefield->Default} to {$default_value}";
 					}
 				}
 				// Remove the field from the array (so it's not added).
-				unset($cfields[strtolower($tablefield->Field)]);
+				unset( $cfields[ $tablefield_field_lowercased ] );
 			} else {
 				// This field exists in the table, but not in the creation queries?
 			}
 		}
 			// For every index in the table.
 			foreach ($tableindices as $tableindex) {
 				// Add the index to the index data array.
-				$keyname = $tableindex->Key_name;
+				$keyname = strtolower( $tableindex->Key_name );
 				$index_ary[$keyname]['columns'][] = array('fieldname' => $tableindex->Column_name, 'subpart' => $tableindex->Sub_part);
 				$index_ary[$keyname]['unique'] = ($tableindex->Non_unique == 0)?true:false;
+				$index_ary[$keyname]['index_type'] = $tableindex->Index_type;
 			}
 			// For each actual index in the index array.
 			foreach ($index_ary as $index_name => $index_data) {
 				// Build a create string to compare to the query.
 				$index_string = '';
-				if ($index_name == 'PRIMARY') {
+				if ($index_name == 'primary') {
 					$index_string .= 'PRIMARY ';
 				} elseif ( $index_data['unique'] ) {
 					$index_string .= 'UNIQUE ';
 				}
+				if ( 'FULLTEXT' === strtoupper( $index_data['index_type'] ) ) {
+					$index_string .= 'FULLTEXT ';
+				}
+				if ( 'SPATIAL' === strtoupper( $index_data['index_type'] ) ) {
+					$index_string .= 'SPATIAL ';
+				}
 				$index_string .= 'KEY ';
-				if ($index_name != 'PRIMARY') {
+				if ( 'primary' !== $index_name  ) {
-					$index_string .= $index_name;
+					$index_string .= '`' . $index_name . '`';
 				}
 				$index_columns = '';
 				// For each column in the index.
 				foreach ($index_data['columns'] as $column_data) {
-					if ($index_columns != '') $index_columns .= ',';
+					if ( $index_columns != '' ) {
+						$index_columns .= ',';
+					}
 					// Add the field to the column list string.
-					$index_columns .= $column_data['fieldname'];
+					$index_columns .= '`' . $column_data['fieldname'] . '`';
-					if ($column_data['subpart'] != '') {
-						$index_columns .= '('.$column_data['subpart'].')';
-					}
 				}
-				// The alternative index string doesn't care about subparts
-				$alt_index_columns = preg_replace( '/\([^)]*\)/', '', $index_columns );
 				// Add the column list to the index create string.
-				$index_strings = array(
+				$index_string .= " ($index_columns)";
-					"$index_string ($index_columns)",
-					"$index_string ($alt_index_columns)",
+				// Check if the index definition exists, ignoring subparts.
-				);
+				if ( ! ( ( $aindex = array_search( $index_string, $indices_without_subparts ) ) === false ) ) {
+					// If the index already exists (even with different subparts), we don't need to create it.
-				foreach( $index_strings as $index_string ) {
+					unset( $indices_without_subparts[ $aindex ] );
-					if ( ! ( ( $aindex = array_search( $index_string, $indices ) ) === false ) ) {
+					unset( $indices[ $aindex ] );
-						unset( $indices[ $aindex ] );
-						break;
-						// todo: Remove this?
-						//echo "<pre style=\"border:1px solid #ccc;margin-top:5px;\">{$table}:<br />Found index:".$index_string."</pre>\n";
-					}
 				}
-				// todo: Remove this?
-				//else echo "<pre style=\"border:1px solid #ccc;margin-top:5px;\">{$table}:<br /><b>Did not find index:</b>".$index_string."<br />".print_r($indices, true)."</pre>\n";
 			}
 		}
 		// For every remaining index specified for the table.
 		foreach ( (array) $indices as $index ) {
 	}
 	$allqueries = array_merge($cqueries, $iqueries);
 	if ($execute) {
 		foreach ($allqueries as $query) {
-			// todo: Remove this?
-			//echo "<pre style=\"border:1px solid #ccc;margin-top:5px;\">".print_r($query, true)."</pre>\n";
 			$wpdb->query($query);
 		}
 	}
 	return $for_update;
 * @param string $tables Optional. Which set of tables to update. Default is 'all'.
 */
 function make_db_current( $tables = 'all' ) {
 	$alterations = dbDelta( $tables );
 	echo "<ol>\n";
-	foreach($alterations as $alteration) echo "<li>$alteration</li>\n";
+	foreach ($alterations as $alteration) echo "<li>$alteration</li>\n";
 	echo "</ol>\n";
 }
 /**
 * Updates the database tables to a new schema, but without displaying results.
 				if (! @copy(WP_CONTENT_DIR . '/themes/' . WP_DEFAULT_THEME . '/index.php', "$site_dir/$newfile"))
 					return false;
 				// Don't copy anything.
 				continue;
-				}
+			}
 		}
 		if (! @copy("$oldpath/$oldfile", "$site_dir/$newfile"))
 			return false;
 *
 * @since 1.5.0
 *
 * @param string $theme_name The name of the theme.
 * @param string $template   The directory name of the theme.
-* @return null|false
+* @return false|void
 */
 function make_site_theme_from_default($theme_name, $template) {
 	$site_dir = WP_CONTENT_DIR . "/themes/$template";
 	$default_dir = WP_CONTENT_DIR . '/themes/' . WP_DEFAULT_THEME;
 /**
 * Checks the version of the installed MySQL binary.
 *
 * @since 2.1.0
+*
+* @global wpdb  $wpdb
 */
 function wp_check_mysql_version() {
 	global $wpdb;
 	$result = $wpdb->check_database_version();
 	if ( is_wp_error( $result ) )
 /**
 * Disables the Link Manager on upgrade if, at the time of upgrade, no links exist in the DB.
 *
 * @since 3.5.0
+*
+* @global int  $wp_current_db_version
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function maybe_disable_link_manager() {
 	global $wp_current_db_version, $wpdb;
 	if ( $wp_current_db_version >= 22006 && get_option( 'link_manager_enabled' ) && ! $wpdb->get_var( "SELECT link_id FROM $wpdb->links LIMIT 1" ) )
 /**
 * Runs before the schema is upgraded.
 *
 * @since 2.9.0
+*
+* @global int  $wp_current_db_version
+* @global wpdb $wpdb WordPress database abstraction object.
 */
 function pre_schema_upgrade() {
 	global $wp_current_db_version, $wpdb;
 	// Upgrade versions prior to 2.9
 		// Drop the old option_name index. dbDelta() doesn't do the drop.
 		$wpdb->query("ALTER TABLE $wpdb->options DROP INDEX option_name");
 	}
 	// Multisite schema upgrades.
-	if ( $wp_current_db_version < 25448 && is_multisite() && ! defined( 'DO_NOT_UPGRADE_GLOBAL_TABLES' ) && is_main_network() ) {
+	if ( $wp_current_db_version < 25448 && is_multisite() && wp_should_upgrade_global_tables() ) {
-		// Upgrade verions prior to 3.7
+		// Upgrade versions prior to 3.7
 		if ( $wp_current_db_version < 25179 ) {
 			// New primary key for signups.
 			$wpdb->query( "ALTER TABLE $wpdb->signups ADD signup_id BIGINT(20) NOT NULL AUTO_INCREMENT PRIMARY KEY FIRST" );
 			$wpdb->query( "ALTER TABLE $wpdb->signups DROP INDEX domain" );
 		}
 			$wpdb->query( "ALTER TABLE $wpdb->blogs CHANGE COLUMN archived archived varchar(1) NOT NULL default '0'" );
 			$wpdb->query( "ALTER TABLE $wpdb->blogs CHANGE COLUMN archived archived tinyint(2) NOT NULL default 0" );
 		}
 	}
-	if ( $wp_current_db_version < 30133 ) {
-		// dbDelta() can recreate but can't drop the index.
-		$wpdb->query( "ALTER TABLE $wpdb->terms DROP INDEX slug" );
-	}
 	// Upgrade versions prior to 4.2.
 	if ( $wp_current_db_version < 31351 ) {
-		if ( ! is_multisite() ) {
+		if ( ! is_multisite() && wp_should_upgrade_global_tables() ) {
 			$wpdb->query( "ALTER TABLE $wpdb->usermeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
 		}
 		$wpdb->query( "ALTER TABLE $wpdb->terms DROP INDEX slug, ADD INDEX slug(slug(191))" );
 		$wpdb->query( "ALTER TABLE $wpdb->terms DROP INDEX name, ADD INDEX name(name(191))" );
 		$wpdb->query( "ALTER TABLE $wpdb->commentmeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
 		$wpdb->query( "ALTER TABLE $wpdb->postmeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
 		$wpdb->query( "ALTER TABLE $wpdb->posts DROP INDEX post_name, ADD INDEX post_name(post_name(191))" );
 	}
-}
+	// Upgrade versions prior to 4.4.
+	if ( $wp_current_db_version < 34978 ) {
+		// If compatible termmeta table is found, use it, but enforce a proper index and update collation.
+		if ( $wpdb->get_var( "SHOW TABLES LIKE '{$wpdb->termmeta}'" ) && $wpdb->get_results( "SHOW INDEX FROM {$wpdb->termmeta} WHERE Column_name = 'meta_key'" ) ) {
+			$wpdb->query( "ALTER TABLE $wpdb->termmeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
+			maybe_convert_table_to_utf8mb4( $wpdb->termmeta );
+		}
+	}
+}
+if ( !function_exists( 'install_global_terms' ) ) :
 /**
 * Install global terms.
 *
 * @since 3.0.0
 *
-*/
+* @global wpdb   $wpdb
-if ( !function_exists( 'install_global_terms' ) ) :
+* @global string $charset_collate
+*/
 function install_global_terms() {
 	global $wpdb, $charset_collate;
 	$ms_queries = "
 CREATE TABLE $wpdb->sitecategories (
 cat_ID bigint(20) NOT NULL auto_increment,
 ";
 // now create tables
 	dbDelta( $ms_queries );
 }
 endif;
+/**
+* Determine if global tables should be upgraded.
+*
+* This function performs a series of checks to ensure the environment allows
+* for the safe upgrading of global WordPress database tables. It is necessary
+* because global tables will commonly grow to millions of rows on large
+* installations, and the ability to control their upgrade routines can be
+* critical to the operation of large networks.
+*
+* In a future iteration, this function may use `wp_is_large_network()` to more-
+* intelligently prevent global table upgrades. Until then, we make sure
+* WordPress is on the main site of the main network, to avoid running queries
+* more than once in multi-site or multi-network environments.
+*
+* @since 4.3.0
+*
+* @return bool Whether to run the upgrade routines on global tables.
+*/
+function wp_should_upgrade_global_tables() {
+	// Return false early if explicitly not upgrading
+	if ( defined( 'DO_NOT_UPGRADE_GLOBAL_TABLES' ) ) {
+		return false;
+	}
+	// Assume global tables should be upgraded
+	$should_upgrade = true;
+	// Set to false if not on main network (does not matter if not multi-network)
+	if ( ! is_main_network() ) {
+		$should_upgrade = false;
+	}
+	// Set to false if not on main site of current network (does not matter if not multi-site)
+	if ( ! is_main_site() ) {
+		$should_upgrade = false;
+	}
+	/**
+	 * Filters if upgrade routines should be run on global tables.
+	 *
+	 * @param bool $should_upgrade Whether to run the upgrade routines on global tables.
+	 */
+	return apply_filters( 'wp_should_upgrade_global_tables', $should_upgrade );
+}

changeset 7	cf61fcea0001
parent 5	5e2f62d02dcd
child 9	177826044cd9