[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-admin/includes/ -> update-core.php (source)

   1  <?php
   2  /**
   3   * WordPress core upgrade functionality.
   4   *
   5   * @package WordPress
   6   * @subpackage Administration
   7   * @since 2.7.0
   8   */
   9  
  10  /**
  11   * Stores files to be deleted.
  12   *
  13   * @since 2.7.0
  14   *
  15   * @global array $_old_files
  16   * @var array
  17   * @name $_old_files
  18   */
  19  global $_old_files;
  20  
  21  $_old_files = array(
  22      // 2.0
  23      'wp-admin/import-b2.php',
  24      'wp-admin/import-blogger.php',
  25      'wp-admin/import-greymatter.php',
  26      'wp-admin/import-livejournal.php',
  27      'wp-admin/import-mt.php',
  28      'wp-admin/import-rss.php',
  29      'wp-admin/import-textpattern.php',
  30      'wp-admin/quicktags.js',
  31      'wp-images/fade-butt.png',
  32      'wp-images/get-firefox.png',
  33      'wp-images/header-shadow.png',
  34      'wp-images/smilies',
  35      'wp-images/wp-small.png',
  36      'wp-images/wpminilogo.png',
  37      'wp.php',
  38      // 2.0.8
  39      'wp-includes/js/tinymce/plugins/inlinepopups/readme.txt',
  40      // 2.1
  41      'wp-admin/edit-form-ajax-cat.php',
  42      'wp-admin/execute-pings.php',
  43      'wp-admin/inline-uploading.php',
  44      'wp-admin/link-categories.php',
  45      'wp-admin/list-manipulation.js',
  46      'wp-admin/list-manipulation.php',
  47      'wp-includes/comment-functions.php',
  48      'wp-includes/feed-functions.php',
  49      'wp-includes/functions-compat.php',
  50      'wp-includes/functions-formatting.php',
  51      'wp-includes/functions-post.php',
  52      'wp-includes/js/dbx-key.js',
  53      'wp-includes/js/tinymce/plugins/autosave/langs/cs.js',
  54      'wp-includes/js/tinymce/plugins/autosave/langs/sv.js',
  55      'wp-includes/links.php',
  56      'wp-includes/pluggable-functions.php',
  57      'wp-includes/template-functions-author.php',
  58      'wp-includes/template-functions-category.php',
  59      'wp-includes/template-functions-general.php',
  60      'wp-includes/template-functions-links.php',
  61      'wp-includes/template-functions-post.php',
  62      'wp-includes/wp-l10n.php',
  63      // 2.2
  64      'wp-admin/cat-js.php',
  65      'wp-admin/import/b2.php',
  66      'wp-includes/js/autosave-js.php',
  67      'wp-includes/js/list-manipulation-js.php',
  68      'wp-includes/js/wp-ajax-js.php',
  69      // 2.3
  70      'wp-admin/admin-db.php',
  71      'wp-admin/cat.js',
  72      'wp-admin/categories.js',
  73      'wp-admin/custom-fields.js',
  74      'wp-admin/dbx-admin-key.js',
  75      'wp-admin/edit-comments.js',
  76      'wp-admin/install-rtl.css',
  77      'wp-admin/install.css',
  78      'wp-admin/upgrade-schema.php',
  79      'wp-admin/upload-functions.php',
  80      'wp-admin/upload-rtl.css',
  81      'wp-admin/upload.css',
  82      'wp-admin/upload.js',
  83      'wp-admin/users.js',
  84      'wp-admin/widgets-rtl.css',
  85      'wp-admin/widgets.css',
  86      'wp-admin/xfn.js',
  87      'wp-includes/js/tinymce/license.html',
  88      // 2.5
  89      'wp-admin/css/upload.css',
  90      'wp-admin/images/box-bg-left.gif',
  91      'wp-admin/images/box-bg-right.gif',
  92      'wp-admin/images/box-bg.gif',
  93      'wp-admin/images/box-butt-left.gif',
  94      'wp-admin/images/box-butt-right.gif',
  95      'wp-admin/images/box-butt.gif',
  96      'wp-admin/images/box-head-left.gif',
  97      'wp-admin/images/box-head-right.gif',
  98      'wp-admin/images/box-head.gif',
  99      'wp-admin/images/heading-bg.gif',
 100      'wp-admin/images/login-bkg-bottom.gif',
 101      'wp-admin/images/login-bkg-tile.gif',
 102      'wp-admin/images/notice.gif',
 103      'wp-admin/images/toggle.gif',
 104      'wp-admin/includes/upload.php',
 105      'wp-admin/js/dbx-admin-key.js',
 106      'wp-admin/js/link-cat.js',
 107      'wp-admin/profile-update.php',
 108      'wp-admin/templates.php',
 109      'wp-includes/images/wlw/WpComments.png',
 110      'wp-includes/images/wlw/WpIcon.png',
 111      'wp-includes/images/wlw/WpWatermark.png',
 112      'wp-includes/js/dbx.js',
 113      'wp-includes/js/fat.js',
 114      'wp-includes/js/list-manipulation.js',
 115      'wp-includes/js/tinymce/langs/en.js',
 116      'wp-includes/js/tinymce/plugins/autosave/editor_plugin_src.js',
 117      'wp-includes/js/tinymce/plugins/autosave/langs',
 118      'wp-includes/js/tinymce/plugins/directionality/images',
 119      'wp-includes/js/tinymce/plugins/directionality/langs',
 120      'wp-includes/js/tinymce/plugins/inlinepopups/css',
 121      'wp-includes/js/tinymce/plugins/inlinepopups/images',
 122      'wp-includes/js/tinymce/plugins/inlinepopups/jscripts',
 123      'wp-includes/js/tinymce/plugins/paste/images',
 124      'wp-includes/js/tinymce/plugins/paste/jscripts',
 125      'wp-includes/js/tinymce/plugins/paste/langs',
 126      'wp-includes/js/tinymce/plugins/spellchecker/classes/HttpClient.class.php',
 127      'wp-includes/js/tinymce/plugins/spellchecker/classes/TinyGoogleSpell.class.php',
 128      'wp-includes/js/tinymce/plugins/spellchecker/classes/TinyPspell.class.php',
 129      'wp-includes/js/tinymce/plugins/spellchecker/classes/TinyPspellShell.class.php',
 130      'wp-includes/js/tinymce/plugins/spellchecker/css/spellchecker.css',
 131      'wp-includes/js/tinymce/plugins/spellchecker/images',
 132      'wp-includes/js/tinymce/plugins/spellchecker/langs',
 133      'wp-includes/js/tinymce/plugins/spellchecker/tinyspell.php',
 134      'wp-includes/js/tinymce/plugins/wordpress/images',
 135      'wp-includes/js/tinymce/plugins/wordpress/langs',
 136      'wp-includes/js/tinymce/plugins/wordpress/wordpress.css',
 137      'wp-includes/js/tinymce/plugins/wphelp',
 138      'wp-includes/js/tinymce/themes/advanced/css',
 139      'wp-includes/js/tinymce/themes/advanced/images',
 140      'wp-includes/js/tinymce/themes/advanced/jscripts',
 141      'wp-includes/js/tinymce/themes/advanced/langs',
 142      // 2.5.1
 143      'wp-includes/js/tinymce/tiny_mce_gzip.php',
 144      // 2.6
 145      'wp-admin/bookmarklet.php',
 146      'wp-includes/js/jquery/jquery.dimensions.min.js',
 147      'wp-includes/js/tinymce/plugins/wordpress/popups.css',
 148      'wp-includes/js/wp-ajax.js',
 149      // 2.7
 150      'wp-admin/css/press-this-ie-rtl.css',
 151      'wp-admin/css/press-this-ie.css',
 152      'wp-admin/css/upload-rtl.css',
 153      'wp-admin/edit-form.php',
 154      'wp-admin/images/comment-pill.gif',
 155      'wp-admin/images/comment-stalk-classic.gif',
 156      'wp-admin/images/comment-stalk-fresh.gif',
 157      'wp-admin/images/comment-stalk-rtl.gif',
 158      'wp-admin/images/del.png',
 159      'wp-admin/images/gear.png',
 160      'wp-admin/images/media-button-gallery.gif',
 161      'wp-admin/images/media-buttons.gif',
 162      'wp-admin/images/postbox-bg.gif',
 163      'wp-admin/images/tab.png',
 164      'wp-admin/images/tail.gif',
 165      'wp-admin/js/forms.js',
 166      'wp-admin/js/upload.js',
 167      'wp-admin/link-import.php',
 168      'wp-includes/images/audio.png',
 169      'wp-includes/images/css.png',
 170      'wp-includes/images/default.png',
 171      'wp-includes/images/doc.png',
 172      'wp-includes/images/exe.png',
 173      'wp-includes/images/html.png',
 174      'wp-includes/images/js.png',
 175      'wp-includes/images/pdf.png',
 176      'wp-includes/images/swf.png',
 177      'wp-includes/images/tar.png',
 178      'wp-includes/images/text.png',
 179      'wp-includes/images/video.png',
 180      'wp-includes/images/zip.png',
 181      'wp-includes/js/tinymce/tiny_mce_config.php',
 182      'wp-includes/js/tinymce/tiny_mce_ext.js',
 183      // 2.8
 184      'wp-admin/js/users.js',
 185      'wp-includes/js/swfupload/plugins/swfupload.documentready.js',
 186      'wp-includes/js/swfupload/plugins/swfupload.graceful_degradation.js',
 187      'wp-includes/js/swfupload/swfupload_f9.swf',
 188      'wp-includes/js/tinymce/plugins/autosave',
 189      'wp-includes/js/tinymce/plugins/paste/css',
 190      'wp-includes/js/tinymce/utils/mclayer.js',
 191      'wp-includes/js/tinymce/wordpress.css',
 192      // 2.8.5
 193      'wp-admin/import/btt.php',
 194      'wp-admin/import/jkw.php',
 195      // 2.9
 196      'wp-admin/js/page.dev.js',
 197      'wp-admin/js/page.js',
 198      'wp-admin/js/set-post-thumbnail-handler.dev.js',
 199      'wp-admin/js/set-post-thumbnail-handler.js',
 200      'wp-admin/js/slug.dev.js',
 201      'wp-admin/js/slug.js',
 202      'wp-includes/gettext.php',
 203      'wp-includes/js/tinymce/plugins/wordpress/js',
 204      'wp-includes/streams.php',
 205      // MU
 206      'README.txt',
 207      'htaccess.dist',
 208      'index-install.php',
 209      'wp-admin/css/mu-rtl.css',
 210      'wp-admin/css/mu.css',
 211      'wp-admin/images/site-admin.png',
 212      'wp-admin/includes/mu.php',
 213      'wp-admin/wpmu-admin.php',
 214      'wp-admin/wpmu-blogs.php',
 215      'wp-admin/wpmu-edit.php',
 216      'wp-admin/wpmu-options.php',
 217      'wp-admin/wpmu-themes.php',
 218      'wp-admin/wpmu-upgrade-site.php',
 219      'wp-admin/wpmu-users.php',
 220      'wp-includes/images/wordpress-mu.png',
 221      'wp-includes/wpmu-default-filters.php',
 222      'wp-includes/wpmu-functions.php',
 223      'wpmu-settings.php',
 224      // 3.0
 225      'wp-admin/categories.php',
 226      'wp-admin/edit-category-form.php',
 227      'wp-admin/edit-page-form.php',
 228      'wp-admin/edit-pages.php',
 229      'wp-admin/images/admin-header-footer.png',
 230      'wp-admin/images/browse-happy.gif',
 231      'wp-admin/images/ico-add.png',
 232      'wp-admin/images/ico-close.png',
 233      'wp-admin/images/ico-edit.png',
 234      'wp-admin/images/ico-viewpage.png',
 235      'wp-admin/images/fav-top.png',
 236      'wp-admin/images/screen-options-left.gif',
 237      'wp-admin/images/wp-logo-vs.gif',
 238      'wp-admin/images/wp-logo.gif',
 239      'wp-admin/import',
 240      'wp-admin/js/wp-gears.dev.js',
 241      'wp-admin/js/wp-gears.js',
 242      'wp-admin/options-misc.php',
 243      'wp-admin/page-new.php',
 244      'wp-admin/page.php',
 245      'wp-admin/rtl.css',
 246      'wp-admin/rtl.dev.css',
 247      'wp-admin/update-links.php',
 248      'wp-admin/wp-admin.css',
 249      'wp-admin/wp-admin.dev.css',
 250      'wp-includes/js/codepress',
 251      'wp-includes/js/codepress/engines/khtml.js',
 252      'wp-includes/js/codepress/engines/older.js',
 253      'wp-includes/js/jquery/autocomplete.dev.js',
 254      'wp-includes/js/jquery/autocomplete.js',
 255      'wp-includes/js/jquery/interface.js',
 256      'wp-includes/js/scriptaculous/prototype.js',
 257      // Following file added back in 5.1, see #45645.
 258      //'wp-includes/js/tinymce/wp-tinymce.js',
 259      // 3.1
 260      'wp-admin/edit-attachment-rows.php',
 261      'wp-admin/edit-link-categories.php',
 262      'wp-admin/edit-link-category-form.php',
 263      'wp-admin/edit-post-rows.php',
 264      'wp-admin/images/button-grad-active-vs.png',
 265      'wp-admin/images/button-grad-vs.png',
 266      'wp-admin/images/fav-arrow-vs-rtl.gif',
 267      'wp-admin/images/fav-arrow-vs.gif',
 268      'wp-admin/images/fav-top-vs.gif',
 269      'wp-admin/images/list-vs.png',
 270      'wp-admin/images/screen-options-right-up.gif',
 271      'wp-admin/images/screen-options-right.gif',
 272      'wp-admin/images/visit-site-button-grad-vs.gif',
 273      'wp-admin/images/visit-site-button-grad.gif',
 274      'wp-admin/link-category.php',
 275      'wp-admin/sidebar.php',
 276      'wp-includes/classes.php',
 277      'wp-includes/js/tinymce/blank.htm',
 278      'wp-includes/js/tinymce/plugins/media/css/content.css',
 279      'wp-includes/js/tinymce/plugins/media/img',
 280      'wp-includes/js/tinymce/plugins/safari',
 281      // 3.2
 282      'wp-admin/images/logo-login.gif',
 283      'wp-admin/images/star.gif',
 284      'wp-admin/js/list-table.dev.js',
 285      'wp-admin/js/list-table.js',
 286      'wp-includes/default-embeds.php',
 287      'wp-includes/js/tinymce/plugins/wordpress/img/help.gif',
 288      'wp-includes/js/tinymce/plugins/wordpress/img/more.gif',
 289      'wp-includes/js/tinymce/plugins/wordpress/img/toolbars.gif',
 290      'wp-includes/js/tinymce/themes/advanced/img/fm.gif',
 291      'wp-includes/js/tinymce/themes/advanced/img/sflogo.png',
 292      // 3.3
 293      'wp-admin/css/colors-classic-rtl.css',
 294      'wp-admin/css/colors-classic-rtl.dev.css',
 295      'wp-admin/css/colors-fresh-rtl.css',
 296      'wp-admin/css/colors-fresh-rtl.dev.css',
 297      'wp-admin/css/dashboard-rtl.dev.css',
 298      'wp-admin/css/dashboard.dev.css',
 299      'wp-admin/css/global-rtl.css',
 300      'wp-admin/css/global-rtl.dev.css',
 301      'wp-admin/css/global.css',
 302      'wp-admin/css/global.dev.css',
 303      'wp-admin/css/install-rtl.dev.css',
 304      'wp-admin/css/login-rtl.dev.css',
 305      'wp-admin/css/login.dev.css',
 306      'wp-admin/css/ms.css',
 307      'wp-admin/css/ms.dev.css',
 308      'wp-admin/css/nav-menu-rtl.css',
 309      'wp-admin/css/nav-menu-rtl.dev.css',
 310      'wp-admin/css/nav-menu.css',
 311      'wp-admin/css/nav-menu.dev.css',
 312      'wp-admin/css/plugin-install-rtl.css',
 313      'wp-admin/css/plugin-install-rtl.dev.css',
 314      'wp-admin/css/plugin-install.css',
 315      'wp-admin/css/plugin-install.dev.css',
 316      'wp-admin/css/press-this-rtl.dev.css',
 317      'wp-admin/css/press-this.dev.css',
 318      'wp-admin/css/theme-editor-rtl.css',
 319      'wp-admin/css/theme-editor-rtl.dev.css',
 320      'wp-admin/css/theme-editor.css',
 321      'wp-admin/css/theme-editor.dev.css',
 322      'wp-admin/css/theme-install-rtl.css',
 323      'wp-admin/css/theme-install-rtl.dev.css',
 324      'wp-admin/css/theme-install.css',
 325      'wp-admin/css/theme-install.dev.css',
 326      'wp-admin/css/widgets-rtl.dev.css',
 327      'wp-admin/css/widgets.dev.css',
 328      'wp-admin/includes/internal-linking.php',
 329      'wp-includes/images/admin-bar-sprite-rtl.png',
 330      'wp-includes/js/jquery/ui.button.js',
 331      'wp-includes/js/jquery/ui.core.js',
 332      'wp-includes/js/jquery/ui.dialog.js',
 333      'wp-includes/js/jquery/ui.draggable.js',
 334      'wp-includes/js/jquery/ui.droppable.js',
 335      'wp-includes/js/jquery/ui.mouse.js',
 336      'wp-includes/js/jquery/ui.position.js',
 337      'wp-includes/js/jquery/ui.resizable.js',
 338      'wp-includes/js/jquery/ui.selectable.js',
 339      'wp-includes/js/jquery/ui.sortable.js',
 340      'wp-includes/js/jquery/ui.tabs.js',
 341      'wp-includes/js/jquery/ui.widget.js',
 342      'wp-includes/js/l10n.dev.js',
 343      'wp-includes/js/l10n.js',
 344      'wp-includes/js/tinymce/plugins/wplink/css',
 345      'wp-includes/js/tinymce/plugins/wplink/img',
 346      'wp-includes/js/tinymce/plugins/wplink/js',
 347      'wp-includes/js/tinymce/themes/advanced/img/wpicons.png',
 348      'wp-includes/js/tinymce/themes/advanced/skins/wp_theme/img/butt2.png',
 349      'wp-includes/js/tinymce/themes/advanced/skins/wp_theme/img/button_bg.png',
 350      'wp-includes/js/tinymce/themes/advanced/skins/wp_theme/img/down_arrow.gif',
 351      'wp-includes/js/tinymce/themes/advanced/skins/wp_theme/img/fade-butt.png',
 352      'wp-includes/js/tinymce/themes/advanced/skins/wp_theme/img/separator.gif',
 353      // Don't delete, yet: 'wp-rss.php',
 354      // Don't delete, yet: 'wp-rdf.php',
 355      // Don't delete, yet: 'wp-rss2.php',
 356      // Don't delete, yet: 'wp-commentsrss2.php',
 357      // Don't delete, yet: 'wp-atom.php',
 358      // Don't delete, yet: 'wp-feed.php',
 359      // 3.4
 360      'wp-admin/images/gray-star.png',
 361      'wp-admin/images/logo-login.png',
 362      'wp-admin/images/star.png',
 363      'wp-admin/index-extra.php',
 364      'wp-admin/network/index-extra.php',
 365      'wp-admin/user/index-extra.php',
 366      'wp-admin/images/screenshots/admin-flyouts.png',
 367      'wp-admin/images/screenshots/coediting.png',
 368      'wp-admin/images/screenshots/drag-and-drop.png',
 369      'wp-admin/images/screenshots/help-screen.png',
 370      'wp-admin/images/screenshots/media-icon.png',
 371      'wp-admin/images/screenshots/new-feature-pointer.png',
 372      'wp-admin/images/screenshots/welcome-screen.png',
 373      'wp-includes/css/editor-buttons.css',
 374      'wp-includes/css/editor-buttons.dev.css',
 375      'wp-includes/js/tinymce/plugins/paste/blank.htm',
 376      'wp-includes/js/tinymce/plugins/wordpress/css',
 377      'wp-includes/js/tinymce/plugins/wordpress/editor_plugin.dev.js',
 378      'wp-includes/js/tinymce/plugins/wordpress/img/embedded.png',
 379      'wp-includes/js/tinymce/plugins/wordpress/img/more_bug.gif',
 380      'wp-includes/js/tinymce/plugins/wordpress/img/page_bug.gif',
 381      'wp-includes/js/tinymce/plugins/wpdialogs/editor_plugin.dev.js',
 382      'wp-includes/js/tinymce/plugins/wpeditimage/css/editimage-rtl.css',
 383      'wp-includes/js/tinymce/plugins/wpeditimage/editor_plugin.dev.js',
 384      'wp-includes/js/tinymce/plugins/wpfullscreen/editor_plugin.dev.js',
 385      'wp-includes/js/tinymce/plugins/wpgallery/editor_plugin.dev.js',
 386      'wp-includes/js/tinymce/plugins/wpgallery/img/gallery.png',
 387      'wp-includes/js/tinymce/plugins/wplink/editor_plugin.dev.js',
 388      // Don't delete, yet: 'wp-pass.php',
 389      // Don't delete, yet: 'wp-register.php',
 390      // 3.5
 391      'wp-admin/gears-manifest.php',
 392      'wp-admin/includes/manifest.php',
 393      'wp-admin/images/archive-link.png',
 394      'wp-admin/images/blue-grad.png',
 395      'wp-admin/images/button-grad-active.png',
 396      'wp-admin/images/button-grad.png',
 397      'wp-admin/images/ed-bg-vs.gif',
 398      'wp-admin/images/ed-bg.gif',
 399      'wp-admin/images/fade-butt.png',
 400      'wp-admin/images/fav-arrow-rtl.gif',
 401      'wp-admin/images/fav-arrow.gif',
 402      'wp-admin/images/fav-vs.png',
 403      'wp-admin/images/fav.png',
 404      'wp-admin/images/gray-grad.png',
 405      'wp-admin/images/loading-publish.gif',
 406      'wp-admin/images/logo-ghost.png',
 407      'wp-admin/images/logo.gif',
 408      'wp-admin/images/menu-arrow-frame-rtl.png',
 409      'wp-admin/images/menu-arrow-frame.png',
 410      'wp-admin/images/menu-arrows.gif',
 411      'wp-admin/images/menu-bits-rtl-vs.gif',
 412      'wp-admin/images/menu-bits-rtl.gif',
 413      'wp-admin/images/menu-bits-vs.gif',
 414      'wp-admin/images/menu-bits.gif',
 415      'wp-admin/images/menu-dark-rtl-vs.gif',
 416      'wp-admin/images/menu-dark-rtl.gif',
 417      'wp-admin/images/menu-dark-vs.gif',
 418      'wp-admin/images/menu-dark.gif',
 419      'wp-admin/images/required.gif',
 420      'wp-admin/images/screen-options-toggle-vs.gif',
 421      'wp-admin/images/screen-options-toggle.gif',
 422      'wp-admin/images/toggle-arrow-rtl.gif',
 423      'wp-admin/images/toggle-arrow.gif',
 424      'wp-admin/images/upload-classic.png',
 425      'wp-admin/images/upload-fresh.png',
 426      'wp-admin/images/white-grad-active.png',
 427      'wp-admin/images/white-grad.png',
 428      'wp-admin/images/widgets-arrow-vs.gif',
 429      'wp-admin/images/widgets-arrow.gif',
 430      'wp-admin/images/wpspin_dark.gif',
 431      'wp-includes/images/upload.png',
 432      'wp-includes/js/prototype.js',
 433      'wp-includes/js/scriptaculous',
 434      'wp-admin/css/wp-admin-rtl.dev.css',
 435      'wp-admin/css/wp-admin.dev.css',
 436      'wp-admin/css/media-rtl.dev.css',
 437      'wp-admin/css/media.dev.css',
 438      'wp-admin/css/colors-classic.dev.css',
 439      'wp-admin/css/customize-controls-rtl.dev.css',
 440      'wp-admin/css/customize-controls.dev.css',
 441      'wp-admin/css/ie-rtl.dev.css',
 442      'wp-admin/css/ie.dev.css',
 443      'wp-admin/css/install.dev.css',
 444      'wp-admin/css/colors-fresh.dev.css',
 445      'wp-includes/js/customize-base.dev.js',
 446      'wp-includes/js/json2.dev.js',
 447      'wp-includes/js/comment-reply.dev.js',
 448      'wp-includes/js/customize-preview.dev.js',
 449      'wp-includes/js/wplink.dev.js',
 450      'wp-includes/js/tw-sack.dev.js',
 451      'wp-includes/js/wp-list-revisions.dev.js',
 452      'wp-includes/js/autosave.dev.js',
 453      'wp-includes/js/admin-bar.dev.js',
 454      'wp-includes/js/quicktags.dev.js',
 455      'wp-includes/js/wp-ajax-response.dev.js',
 456      'wp-includes/js/wp-pointer.dev.js',
 457      'wp-includes/js/hoverIntent.dev.js',
 458      'wp-includes/js/colorpicker.dev.js',
 459      'wp-includes/js/wp-lists.dev.js',
 460      'wp-includes/js/customize-loader.dev.js',
 461      'wp-includes/js/jquery/jquery.table-hotkeys.dev.js',
 462      'wp-includes/js/jquery/jquery.color.dev.js',
 463      'wp-includes/js/jquery/jquery.color.js',
 464      'wp-includes/js/jquery/jquery.hotkeys.dev.js',
 465      'wp-includes/js/jquery/jquery.form.dev.js',
 466      'wp-includes/js/jquery/suggest.dev.js',
 467      'wp-admin/js/xfn.dev.js',
 468      'wp-admin/js/set-post-thumbnail.dev.js',
 469      'wp-admin/js/comment.dev.js',
 470      'wp-admin/js/theme.dev.js',
 471      'wp-admin/js/cat.dev.js',
 472      'wp-admin/js/password-strength-meter.dev.js',
 473      'wp-admin/js/user-profile.dev.js',
 474      'wp-admin/js/theme-preview.dev.js',
 475      'wp-admin/js/post.dev.js',
 476      'wp-admin/js/media-upload.dev.js',
 477      'wp-admin/js/word-count.dev.js',
 478      'wp-admin/js/plugin-install.dev.js',
 479      'wp-admin/js/edit-comments.dev.js',
 480      'wp-admin/js/media-gallery.dev.js',
 481      'wp-admin/js/custom-fields.dev.js',
 482      'wp-admin/js/custom-background.dev.js',
 483      'wp-admin/js/common.dev.js',
 484      'wp-admin/js/inline-edit-tax.dev.js',
 485      'wp-admin/js/gallery.dev.js',
 486      'wp-admin/js/utils.dev.js',
 487      'wp-admin/js/widgets.dev.js',
 488      'wp-admin/js/wp-fullscreen.dev.js',
 489      'wp-admin/js/nav-menu.dev.js',
 490      'wp-admin/js/dashboard.dev.js',
 491      'wp-admin/js/link.dev.js',
 492      'wp-admin/js/user-suggest.dev.js',
 493      'wp-admin/js/postbox.dev.js',
 494      'wp-admin/js/tags.dev.js',
 495      'wp-admin/js/image-edit.dev.js',
 496      'wp-admin/js/media.dev.js',
 497      'wp-admin/js/customize-controls.dev.js',
 498      'wp-admin/js/inline-edit-post.dev.js',
 499      'wp-admin/js/categories.dev.js',
 500      'wp-admin/js/editor.dev.js',
 501      'wp-includes/js/tinymce/plugins/wpeditimage/js/editimage.dev.js',
 502      'wp-includes/js/tinymce/plugins/wpdialogs/js/popup.dev.js',
 503      'wp-includes/js/tinymce/plugins/wpdialogs/js/wpdialog.dev.js',
 504      'wp-includes/js/plupload/handlers.dev.js',
 505      'wp-includes/js/plupload/wp-plupload.dev.js',
 506      'wp-includes/js/swfupload/handlers.dev.js',
 507      'wp-includes/js/jcrop/jquery.Jcrop.dev.js',
 508      'wp-includes/js/jcrop/jquery.Jcrop.js',
 509      'wp-includes/js/jcrop/jquery.Jcrop.css',
 510      'wp-includes/js/imgareaselect/jquery.imgareaselect.dev.js',
 511      'wp-includes/css/wp-pointer.dev.css',
 512      'wp-includes/css/editor.dev.css',
 513      'wp-includes/css/jquery-ui-dialog.dev.css',
 514      'wp-includes/css/admin-bar-rtl.dev.css',
 515      'wp-includes/css/admin-bar.dev.css',
 516      'wp-includes/js/jquery/ui/jquery.effects.clip.min.js',
 517      'wp-includes/js/jquery/ui/jquery.effects.scale.min.js',
 518      'wp-includes/js/jquery/ui/jquery.effects.blind.min.js',
 519      'wp-includes/js/jquery/ui/jquery.effects.core.min.js',
 520      'wp-includes/js/jquery/ui/jquery.effects.shake.min.js',
 521      'wp-includes/js/jquery/ui/jquery.effects.fade.min.js',
 522      'wp-includes/js/jquery/ui/jquery.effects.explode.min.js',
 523      'wp-includes/js/jquery/ui/jquery.effects.slide.min.js',
 524      'wp-includes/js/jquery/ui/jquery.effects.drop.min.js',
 525      'wp-includes/js/jquery/ui/jquery.effects.highlight.min.js',
 526      'wp-includes/js/jquery/ui/jquery.effects.bounce.min.js',
 527      'wp-includes/js/jquery/ui/jquery.effects.pulsate.min.js',
 528      'wp-includes/js/jquery/ui/jquery.effects.transfer.min.js',
 529      'wp-includes/js/jquery/ui/jquery.effects.fold.min.js',
 530      'wp-admin/images/screenshots/captions-1.png',
 531      'wp-admin/images/screenshots/captions-2.png',
 532      'wp-admin/images/screenshots/flex-header-1.png',
 533      'wp-admin/images/screenshots/flex-header-2.png',
 534      'wp-admin/images/screenshots/flex-header-3.png',
 535      'wp-admin/images/screenshots/flex-header-media-library.png',
 536      'wp-admin/images/screenshots/theme-customizer.png',
 537      'wp-admin/images/screenshots/twitter-embed-1.png',
 538      'wp-admin/images/screenshots/twitter-embed-2.png',
 539      'wp-admin/js/utils.js',
 540      // Added back in 5.3 [45448], see #43895.
 541      // 'wp-admin/options-privacy.php',
 542      'wp-app.php',
 543      'wp-includes/class-wp-atom-server.php',
 544      'wp-includes/js/tinymce/themes/advanced/skins/wp_theme/ui.css',
 545      // 3.5.2
 546      'wp-includes/js/swfupload/swfupload-all.js',
 547      // 3.6
 548      'wp-admin/js/revisions-js.php',
 549      'wp-admin/images/screenshots',
 550      'wp-admin/js/categories.js',
 551      'wp-admin/js/categories.min.js',
 552      'wp-admin/js/custom-fields.js',
 553      'wp-admin/js/custom-fields.min.js',
 554      // 3.7
 555      'wp-admin/js/cat.js',
 556      'wp-admin/js/cat.min.js',
 557      'wp-includes/js/tinymce/plugins/wpeditimage/js/editimage.min.js',
 558      // 3.8
 559      'wp-includes/js/tinymce/themes/advanced/skins/wp_theme/img/page_bug.gif',
 560      'wp-includes/js/tinymce/themes/advanced/skins/wp_theme/img/more_bug.gif',
 561      'wp-includes/js/thickbox/tb-close-2x.png',
 562      'wp-includes/js/thickbox/tb-close.png',
 563      'wp-includes/images/wpmini-blue-2x.png',
 564      'wp-includes/images/wpmini-blue.png',
 565      'wp-admin/css/colors-fresh.css',
 566      'wp-admin/css/colors-classic.css',
 567      'wp-admin/css/colors-fresh.min.css',
 568      'wp-admin/css/colors-classic.min.css',
 569      'wp-admin/js/about.min.js',
 570      'wp-admin/js/about.js',
 571      'wp-admin/images/arrows-dark-vs-2x.png',
 572      'wp-admin/images/wp-logo-vs.png',
 573      'wp-admin/images/arrows-dark-vs.png',
 574      'wp-admin/images/wp-logo.png',
 575      'wp-admin/images/arrows-pr.png',
 576      'wp-admin/images/arrows-dark.png',
 577      'wp-admin/images/press-this.png',
 578      'wp-admin/images/press-this-2x.png',
 579      'wp-admin/images/arrows-vs-2x.png',
 580      'wp-admin/images/welcome-icons.png',
 581      'wp-admin/images/wp-logo-2x.png',
 582      'wp-admin/images/stars-rtl-2x.png',
 583      'wp-admin/images/arrows-dark-2x.png',
 584      'wp-admin/images/arrows-pr-2x.png',
 585      'wp-admin/images/menu-shadow-rtl.png',
 586      'wp-admin/images/arrows-vs.png',
 587      'wp-admin/images/about-search-2x.png',
 588      'wp-admin/images/bubble_bg-rtl-2x.gif',
 589      'wp-admin/images/wp-badge-2x.png',
 590      'wp-admin/images/wordpress-logo-2x.png',
 591      'wp-admin/images/bubble_bg-rtl.gif',
 592      'wp-admin/images/wp-badge.png',
 593      'wp-admin/images/menu-shadow.png',
 594      'wp-admin/images/about-globe-2x.png',
 595      'wp-admin/images/welcome-icons-2x.png',
 596      'wp-admin/images/stars-rtl.png',
 597      'wp-admin/images/wp-logo-vs-2x.png',
 598      'wp-admin/images/about-updates-2x.png',
 599      // 3.9
 600      'wp-admin/css/colors.css',
 601      'wp-admin/css/colors.min.css',
 602      'wp-admin/css/colors-rtl.css',
 603      'wp-admin/css/colors-rtl.min.css',
 604      // Following files added back in 4.5, see #36083.
 605      // 'wp-admin/css/media-rtl.min.css',
 606      // 'wp-admin/css/media.min.css',
 607      // 'wp-admin/css/farbtastic-rtl.min.css',
 608      'wp-admin/images/lock-2x.png',
 609      'wp-admin/images/lock.png',
 610      'wp-admin/js/theme-preview.js',
 611      'wp-admin/js/theme-install.min.js',
 612      'wp-admin/js/theme-install.js',
 613      'wp-admin/js/theme-preview.min.js',
 614      'wp-includes/js/plupload/plupload.html4.js',
 615      'wp-includes/js/plupload/plupload.html5.js',
 616      'wp-includes/js/plupload/changelog.txt',
 617      'wp-includes/js/plupload/plupload.silverlight.js',
 618      'wp-includes/js/plupload/plupload.flash.js',
 619      // Added back in 4.9 [41328], see #41755.
 620      // 'wp-includes/js/plupload/plupload.js',
 621      'wp-includes/js/tinymce/plugins/spellchecker',
 622      'wp-includes/js/tinymce/plugins/inlinepopups',
 623      'wp-includes/js/tinymce/plugins/media/js',
 624      'wp-includes/js/tinymce/plugins/media/css',
 625      'wp-includes/js/tinymce/plugins/wordpress/img',
 626      'wp-includes/js/tinymce/plugins/wpdialogs/js',
 627      'wp-includes/js/tinymce/plugins/wpeditimage/img',
 628      'wp-includes/js/tinymce/plugins/wpeditimage/js',
 629      'wp-includes/js/tinymce/plugins/wpeditimage/css',
 630      'wp-includes/js/tinymce/plugins/wpgallery/img',
 631      'wp-includes/js/tinymce/plugins/wpfullscreen/css',
 632      'wp-includes/js/tinymce/plugins/paste/js',
 633      'wp-includes/js/tinymce/themes/advanced',
 634      'wp-includes/js/tinymce/tiny_mce.js',
 635      'wp-includes/js/tinymce/mark_loaded_src.js',
 636      'wp-includes/js/tinymce/wp-tinymce-schema.js',
 637      'wp-includes/js/tinymce/plugins/media/editor_plugin.js',
 638      'wp-includes/js/tinymce/plugins/media/editor_plugin_src.js',
 639      'wp-includes/js/tinymce/plugins/media/media.htm',
 640      'wp-includes/js/tinymce/plugins/wpview/editor_plugin_src.js',
 641      'wp-includes/js/tinymce/plugins/wpview/editor_plugin.js',
 642      'wp-includes/js/tinymce/plugins/directionality/editor_plugin.js',
 643      'wp-includes/js/tinymce/plugins/directionality/editor_plugin_src.js',
 644      'wp-includes/js/tinymce/plugins/wordpress/editor_plugin.js',
 645      'wp-includes/js/tinymce/plugins/wordpress/editor_plugin_src.js',
 646      'wp-includes/js/tinymce/plugins/wpdialogs/editor_plugin_src.js',
 647      'wp-includes/js/tinymce/plugins/wpdialogs/editor_plugin.js',
 648      'wp-includes/js/tinymce/plugins/wpeditimage/editimage.html',
 649      'wp-includes/js/tinymce/plugins/wpeditimage/editor_plugin.js',
 650      'wp-includes/js/tinymce/plugins/wpeditimage/editor_plugin_src.js',
 651      'wp-includes/js/tinymce/plugins/fullscreen/editor_plugin_src.js',
 652      'wp-includes/js/tinymce/plugins/fullscreen/fullscreen.htm',
 653      'wp-includes/js/tinymce/plugins/fullscreen/editor_plugin.js',
 654      'wp-includes/js/tinymce/plugins/wplink/editor_plugin_src.js',
 655      'wp-includes/js/tinymce/plugins/wplink/editor_plugin.js',
 656      'wp-includes/js/tinymce/plugins/wpgallery/editor_plugin_src.js',
 657      'wp-includes/js/tinymce/plugins/wpgallery/editor_plugin.js',
 658      'wp-includes/js/tinymce/plugins/tabfocus/editor_plugin.js',
 659      'wp-includes/js/tinymce/plugins/tabfocus/editor_plugin_src.js',
 660      'wp-includes/js/tinymce/plugins/wpfullscreen/editor_plugin.js',
 661      'wp-includes/js/tinymce/plugins/wpfullscreen/editor_plugin_src.js',
 662      'wp-includes/js/tinymce/plugins/paste/editor_plugin.js',
 663      'wp-includes/js/tinymce/plugins/paste/pasteword.htm',
 664      'wp-includes/js/tinymce/plugins/paste/editor_plugin_src.js',
 665      'wp-includes/js/tinymce/plugins/paste/pastetext.htm',
 666      'wp-includes/js/tinymce/langs/wp-langs.php',
 667      // 4.1
 668      'wp-includes/js/jquery/ui/jquery.ui.accordion.min.js',
 669      'wp-includes/js/jquery/ui/jquery.ui.autocomplete.min.js',
 670      'wp-includes/js/jquery/ui/jquery.ui.button.min.js',
 671      'wp-includes/js/jquery/ui/jquery.ui.core.min.js',
 672      'wp-includes/js/jquery/ui/jquery.ui.datepicker.min.js',
 673      'wp-includes/js/jquery/ui/jquery.ui.dialog.min.js',
 674      'wp-includes/js/jquery/ui/jquery.ui.draggable.min.js',
 675      'wp-includes/js/jquery/ui/jquery.ui.droppable.min.js',
 676      'wp-includes/js/jquery/ui/jquery.ui.effect-blind.min.js',
 677      'wp-includes/js/jquery/ui/jquery.ui.effect-bounce.min.js',
 678      'wp-includes/js/jquery/ui/jquery.ui.effect-clip.min.js',
 679      'wp-includes/js/jquery/ui/jquery.ui.effect-drop.min.js',
 680      'wp-includes/js/jquery/ui/jquery.ui.effect-explode.min.js',
 681      'wp-includes/js/jquery/ui/jquery.ui.effect-fade.min.js',
 682      'wp-includes/js/jquery/ui/jquery.ui.effect-fold.min.js',
 683      'wp-includes/js/jquery/ui/jquery.ui.effect-highlight.min.js',
 684      'wp-includes/js/jquery/ui/jquery.ui.effect-pulsate.min.js',
 685      'wp-includes/js/jquery/ui/jquery.ui.effect-scale.min.js',
 686      'wp-includes/js/jquery/ui/jquery.ui.effect-shake.min.js',
 687      'wp-includes/js/jquery/ui/jquery.ui.effect-slide.min.js',
 688      'wp-includes/js/jquery/ui/jquery.ui.effect-transfer.min.js',
 689      'wp-includes/js/jquery/ui/jquery.ui.effect.min.js',
 690      'wp-includes/js/jquery/ui/jquery.ui.menu.min.js',
 691      'wp-includes/js/jquery/ui/jquery.ui.mouse.min.js',
 692      'wp-includes/js/jquery/ui/jquery.ui.position.min.js',
 693      'wp-includes/js/jquery/ui/jquery.ui.progressbar.min.js',
 694      'wp-includes/js/jquery/ui/jquery.ui.resizable.min.js',
 695      'wp-includes/js/jquery/ui/jquery.ui.selectable.min.js',
 696      'wp-includes/js/jquery/ui/jquery.ui.slider.min.js',
 697      'wp-includes/js/jquery/ui/jquery.ui.sortable.min.js',
 698      'wp-includes/js/jquery/ui/jquery.ui.spinner.min.js',
 699      'wp-includes/js/jquery/ui/jquery.ui.tabs.min.js',
 700      'wp-includes/js/jquery/ui/jquery.ui.tooltip.min.js',
 701      'wp-includes/js/jquery/ui/jquery.ui.widget.min.js',
 702      'wp-includes/js/tinymce/skins/wordpress/images/dashicon-no-alt.png',
 703      // 4.3
 704      'wp-admin/js/wp-fullscreen.js',
 705      'wp-admin/js/wp-fullscreen.min.js',
 706      'wp-includes/js/tinymce/wp-mce-help.php',
 707      'wp-includes/js/tinymce/plugins/wpfullscreen',
 708      // 4.5
 709      'wp-includes/theme-compat/comments-popup.php',
 710      // 4.6
 711      'wp-admin/includes/class-wp-automatic-upgrader.php', // Wrong file name, see #37628.
 712      // 4.8
 713      'wp-includes/js/tinymce/plugins/wpembed',
 714      'wp-includes/js/tinymce/plugins/media/moxieplayer.swf',
 715      'wp-includes/js/tinymce/skins/lightgray/fonts/readme.md',
 716      'wp-includes/js/tinymce/skins/lightgray/fonts/tinymce-small.json',
 717      'wp-includes/js/tinymce/skins/lightgray/fonts/tinymce.json',
 718      'wp-includes/js/tinymce/skins/lightgray/skin.ie7.min.css',
 719      // 4.9
 720      'wp-admin/css/press-this-editor-rtl.css',
 721      'wp-admin/css/press-this-editor-rtl.min.css',
 722      'wp-admin/css/press-this-editor.css',
 723      'wp-admin/css/press-this-editor.min.css',
 724      'wp-admin/css/press-this-rtl.css',
 725      'wp-admin/css/press-this-rtl.min.css',
 726      'wp-admin/css/press-this.css',
 727      'wp-admin/css/press-this.min.css',
 728      'wp-admin/includes/class-wp-press-this.php',
 729      'wp-admin/js/bookmarklet.js',
 730      'wp-admin/js/bookmarklet.min.js',
 731      'wp-admin/js/press-this.js',
 732      'wp-admin/js/press-this.min.js',
 733      'wp-includes/js/mediaelement/background.png',
 734      'wp-includes/js/mediaelement/bigplay.png',
 735      'wp-includes/js/mediaelement/bigplay.svg',
 736      'wp-includes/js/mediaelement/controls.png',
 737      'wp-includes/js/mediaelement/controls.svg',
 738      'wp-includes/js/mediaelement/flashmediaelement.swf',
 739      'wp-includes/js/mediaelement/froogaloop.min.js',
 740      'wp-includes/js/mediaelement/jumpforward.png',
 741      'wp-includes/js/mediaelement/loading.gif',
 742      'wp-includes/js/mediaelement/silverlightmediaelement.xap',
 743      'wp-includes/js/mediaelement/skipback.png',
 744      'wp-includes/js/plupload/plupload.flash.swf',
 745      'wp-includes/js/plupload/plupload.full.min.js',
 746      'wp-includes/js/plupload/plupload.silverlight.xap',
 747      'wp-includes/js/swfupload/plugins',
 748      'wp-includes/js/swfupload/swfupload.swf',
 749      // 4.9.2
 750      'wp-includes/js/mediaelement/lang',
 751      'wp-includes/js/mediaelement/lang/ca.js',
 752      'wp-includes/js/mediaelement/lang/cs.js',
 753      'wp-includes/js/mediaelement/lang/de.js',
 754      'wp-includes/js/mediaelement/lang/es.js',
 755      'wp-includes/js/mediaelement/lang/fa.js',
 756      'wp-includes/js/mediaelement/lang/fr.js',
 757      'wp-includes/js/mediaelement/lang/hr.js',
 758      'wp-includes/js/mediaelement/lang/hu.js',
 759      'wp-includes/js/mediaelement/lang/it.js',
 760      'wp-includes/js/mediaelement/lang/ja.js',
 761      'wp-includes/js/mediaelement/lang/ko.js',
 762      'wp-includes/js/mediaelement/lang/nl.js',
 763      'wp-includes/js/mediaelement/lang/pl.js',
 764      'wp-includes/js/mediaelement/lang/pt.js',
 765      'wp-includes/js/mediaelement/lang/ro.js',
 766      'wp-includes/js/mediaelement/lang/ru.js',
 767      'wp-includes/js/mediaelement/lang/sk.js',
 768      'wp-includes/js/mediaelement/lang/sv.js',
 769      'wp-includes/js/mediaelement/lang/uk.js',
 770      'wp-includes/js/mediaelement/lang/zh-cn.js',
 771      'wp-includes/js/mediaelement/lang/zh.js',
 772      'wp-includes/js/mediaelement/mediaelement-flash-audio-ogg.swf',
 773      'wp-includes/js/mediaelement/mediaelement-flash-audio.swf',
 774      'wp-includes/js/mediaelement/mediaelement-flash-video-hls.swf',
 775      'wp-includes/js/mediaelement/mediaelement-flash-video-mdash.swf',
 776      'wp-includes/js/mediaelement/mediaelement-flash-video.swf',
 777      'wp-includes/js/mediaelement/renderers/dailymotion.js',
 778      'wp-includes/js/mediaelement/renderers/dailymotion.min.js',
 779      'wp-includes/js/mediaelement/renderers/facebook.js',
 780      'wp-includes/js/mediaelement/renderers/facebook.min.js',
 781      'wp-includes/js/mediaelement/renderers/soundcloud.js',
 782      'wp-includes/js/mediaelement/renderers/soundcloud.min.js',
 783      'wp-includes/js/mediaelement/renderers/twitch.js',
 784      'wp-includes/js/mediaelement/renderers/twitch.min.js',
 785      // 5.0
 786      'wp-includes/js/codemirror/jshint.js',
 787      // 5.1
 788      'wp-includes/random_compat/random_bytes_openssl.php',
 789      'wp-includes/js/tinymce/wp-tinymce.js.gz',
 790      // 5.3
 791      'wp-includes/js/wp-a11y.js',     // Moved to: wp-includes/js/dist/a11y.js
 792      'wp-includes/js/wp-a11y.min.js', // Moved to: wp-includes/js/dist/a11y.min.js
 793      // 5.4
 794      'wp-admin/js/wp-fullscreen-stub.js',
 795      'wp-admin/js/wp-fullscreen-stub.min.js',
 796      // 5.5
 797      'wp-admin/css/ie.css',
 798      'wp-admin/css/ie.min.css',
 799      'wp-admin/css/ie-rtl.css',
 800      'wp-admin/css/ie-rtl.min.css',
 801      // 5.6
 802      'wp-includes/js/jquery/ui/position.min.js',
 803      'wp-includes/js/jquery/ui/widget.min.js',
 804      // 5.7
 805      'wp-includes/blocks/classic/block.json',
 806      // 5.8
 807      'wp-admin/images/freedoms.png',
 808      'wp-admin/images/privacy.png',
 809      'wp-admin/images/about-badge.svg',
 810      'wp-admin/images/about-color-palette.svg',
 811      'wp-admin/images/about-color-palette-vert.svg',
 812      'wp-admin/images/about-header-brushes.svg',
 813      'wp-includes/block-patterns/large-header.php',
 814      'wp-includes/block-patterns/heading-paragraph.php',
 815      'wp-includes/block-patterns/quote.php',
 816      'wp-includes/block-patterns/text-three-columns-buttons.php',
 817      'wp-includes/block-patterns/two-buttons.php',
 818      'wp-includes/block-patterns/two-images.php',
 819      'wp-includes/block-patterns/three-buttons.php',
 820      'wp-includes/block-patterns/text-two-columns-with-images.php',
 821      'wp-includes/block-patterns/text-two-columns.php',
 822      'wp-includes/block-patterns/large-header-button.php',
 823      'wp-includes/blocks/subhead/block.json',
 824      'wp-includes/blocks/subhead',
 825      'wp-includes/css/dist/editor/editor-styles.css',
 826      'wp-includes/css/dist/editor/editor-styles.min.css',
 827      'wp-includes/css/dist/editor/editor-styles-rtl.css',
 828      'wp-includes/css/dist/editor/editor-styles-rtl.min.css',
 829  );
 830  
 831  /**
 832   * Stores new files in wp-content to copy
 833   *
 834   * The contents of this array indicate any new bundled plugins/themes which
 835   * should be installed with the WordPress Upgrade. These items will not be
 836   * re-installed in future upgrades, this behaviour is controlled by the
 837   * introduced version present here being older than the current installed version.
 838   *
 839   * The content of this array should follow the following format:
 840   * Filename (relative to wp-content) => Introduced version
 841   * Directories should be noted by suffixing it with a trailing slash (/)
 842   *
 843   * @since 3.2.0
 844   * @since 4.7.0 New themes were not automatically installed for 4.4-4.6 on
 845   *              upgrade. New themes are now installed again. To disable new
 846   *              themes from being installed on upgrade, explicitly define
 847   *              CORE_UPGRADE_SKIP_NEW_BUNDLED as true.
 848   * @global array $_new_bundled_files
 849   * @var array
 850   * @name $_new_bundled_files
 851   */
 852  global $_new_bundled_files;
 853  
 854  $_new_bundled_files = array(
 855      'plugins/akismet/'        => '2.0',
 856      'themes/twentyten/'       => '3.0',
 857      'themes/twentyeleven/'    => '3.2',
 858      'themes/twentytwelve/'    => '3.5',
 859      'themes/twentythirteen/'  => '3.6',
 860      'themes/twentyfourteen/'  => '3.8',
 861      'themes/twentyfifteen/'   => '4.1',
 862      'themes/twentysixteen/'   => '4.4',
 863      'themes/twentyseventeen/' => '4.7',
 864      'themes/twentynineteen/'  => '5.0',
 865      'themes/twentytwenty/'    => '5.3',
 866      'themes/twentytwentyone/' => '5.6',
 867  );
 868  
 869  /**
 870   * Upgrades the core of WordPress.
 871   *
 872   * This will create a .maintenance file at the base of the WordPress directory
 873   * to ensure that people can not access the web site, when the files are being
 874   * copied to their locations.
 875   *
 876   * The files in the `$_old_files` list will be removed and the new files
 877   * copied from the zip file after the database is upgraded.
 878   *
 879   * The files in the `$_new_bundled_files` list will be added to the installation
 880   * if the version is greater than or equal to the old version being upgraded.
 881   *
 882   * The steps for the upgrader for after the new release is downloaded and
 883   * unzipped is:
 884   *   1. Test unzipped location for select files to ensure that unzipped worked.
 885   *   2. Create the .maintenance file in current WordPress base.
 886   *   3. Copy new WordPress directory over old WordPress files.
 887   *   4. Upgrade WordPress to new version.
 888   *     4.1. Copy all files/folders other than wp-content
 889   *     4.2. Copy any language files to WP_LANG_DIR (which may differ from WP_CONTENT_DIR
 890   *     4.3. Copy any new bundled themes/plugins to their respective locations
 891   *   5. Delete new WordPress directory path.
 892   *   6. Delete .maintenance file.
 893   *   7. Remove old files.
 894   *   8. Delete 'update_core' option.
 895   *
 896   * There are several areas of failure. For instance if PHP times out before step
 897   * 6, then you will not be able to access any portion of your site. Also, since
 898   * the upgrade will not continue where it left off, you will not be able to
 899   * automatically remove old files and remove the 'update_core' option. This
 900   * isn't that bad.
 901   *
 902   * If the copy of the new WordPress over the old fails, then the worse is that
 903   * the new WordPress directory will remain.
 904   *
 905   * If it is assumed that every file will be copied over, including plugins and
 906   * themes, then if you edit the default theme, you should rename it, so that
 907   * your changes remain.
 908   *
 909   * @since 2.7.0
 910   *
 911   * @global WP_Filesystem_Base $wp_filesystem          WordPress filesystem subclass.
 912   * @global array              $_old_files
 913   * @global array              $_new_bundled_files
 914   * @global wpdb               $wpdb                   WordPress database abstraction object.
 915   * @global string             $wp_version
 916   * @global string             $required_php_version
 917   * @global string             $required_mysql_version
 918   *
 919   * @param string $from New release unzipped path.
 920   * @param string $to   Path to old WordPress installation.
 921   * @return string|WP_Error New WordPress version on success, WP_Error on failure.
 922   */
 923  function update_core( $from, $to ) {
 924      global $wp_filesystem, $_old_files, $_new_bundled_files, $wpdb;
 925  
 926      set_time_limit( 300 );
 927  
 928      /**
 929       * Filters feedback messages displayed during the core update process.
 930       *
 931       * The filter is first evaluated after the zip file for the latest version
 932       * has been downloaded and unzipped. It is evaluated five more times during
 933       * the process:
 934       *
 935       * 1. Before WordPress begins the core upgrade process.
 936       * 2. Before Maintenance Mode is enabled.
 937       * 3. Before WordPress begins copying over the necessary files.
 938       * 4. Before Maintenance Mode is disabled.
 939       * 5. Before the database is upgraded.
 940       *
 941       * @since 2.5.0
 942       *
 943       * @param string $feedback The core update feedback messages.
 944       */
 945      apply_filters( 'update_feedback', __( 'Verifying the unpacked files&#8230;' ) );
 946  
 947      // Sanity check the unzipped distribution.
 948      $distro = '';
 949      $roots  = array( '/wordpress/', '/wordpress-mu/' );
 950  
 951      foreach ( $roots as $root ) {
 952          if ( $wp_filesystem->exists( $from . $root . 'readme.html' )
 953              && $wp_filesystem->exists( $from . $root . 'wp-includes/version.php' )
 954          ) {
 955              $distro = $root;
 956              break;
 957          }
 958      }
 959  
 960      if ( ! $distro ) {
 961          $wp_filesystem->delete( $from, true );
 962  
 963          return new WP_Error( 'insane_distro', __( 'The update could not be unpacked' ) );
 964      }
 965  
 966      /*
 967       * Import $wp_version, $required_php_version, and $required_mysql_version from the new version.
 968       * DO NOT globalise any variables imported from `version-current.php` in this function.
 969       *
 970       * BC Note: $wp_filesystem->wp_content_dir() returned unslashed pre-2.8.
 971       */
 972      $versions_file = trailingslashit( $wp_filesystem->wp_content_dir() ) . 'upgrade/version-current.php';
 973  
 974      if ( ! $wp_filesystem->copy( $from . $distro . 'wp-includes/version.php', $versions_file ) ) {
 975          $wp_filesystem->delete( $from, true );
 976  
 977          return new WP_Error(
 978              'copy_failed_for_version_file',
 979              __( 'The update cannot be installed because we will be unable to copy some files. This is usually due to inconsistent file permissions.' ),
 980              'wp-includes/version.php'
 981          );
 982      }
 983  
 984      $wp_filesystem->chmod( $versions_file, FS_CHMOD_FILE );
 985  
 986      /*
 987       * `wp_opcache_invalidate()` only exists in WordPress 5.5 or later,
 988       * so don't run it when upgrading from older versions.
 989       */
 990      if ( function_exists( 'wp_opcache_invalidate' ) ) {
 991          wp_opcache_invalidate( $versions_file );
 992      }
 993  
 994      require WP_CONTENT_DIR . '/upgrade/version-current.php';
 995      $wp_filesystem->delete( $versions_file );
 996  
 997      $php_version       = phpversion();
 998      $mysql_version     = $wpdb->db_version();
 999      $old_wp_version    = $GLOBALS['wp_version']; // The version of WordPress we're updating from.
1000      $development_build = ( false !== strpos( $old_wp_version . $wp_version, '-' ) ); // A dash in the version indicates a development release.
1001      $php_compat        = version_compare( $php_version, $required_php_version, '>=' );
1002  
1003      if ( file_exists( WP_CONTENT_DIR . '/db.php' ) && empty( $wpdb->is_mysql ) ) {
1004          $mysql_compat = true;
1005      } else {
1006          $mysql_compat = version_compare( $mysql_version, $required_mysql_version, '>=' );
1007      }
1008  
1009      if ( ! $mysql_compat || ! $php_compat ) {
1010          $wp_filesystem->delete( $from, true );
1011      }
1012  
1013      $php_update_message = '';
1014  
1015      if ( function_exists( 'wp_get_update_php_url' ) ) {
1016          $php_update_message = '</p><p>' . sprintf(
1017              /* translators: %s: URL to Update PHP page. */
1018              __( '<a href="%s">Learn more about updating PHP</a>.' ),
1019              esc_url( wp_get_update_php_url() )
1020          );
1021  
1022          if ( function_exists( 'wp_get_update_php_annotation' ) ) {
1023              $annotation = wp_get_update_php_annotation();
1024  
1025              if ( $annotation ) {
1026                  $php_update_message .= '</p><p><em>' . $annotation . '</em>';
1027              }
1028          }
1029      }
1030  
1031      if ( ! $mysql_compat && ! $php_compat ) {
1032          return new WP_Error(
1033              'php_mysql_not_compatible',
1034              sprintf(
1035                  /* translators: 1: WordPress version number, 2: Minimum required PHP version number, 3: Minimum required MySQL version number, 4: Current PHP version number, 5: Current MySQL version number. */
1036                  __( 'The update cannot be installed because WordPress %1$s requires PHP version %2$s or higher and MySQL version %3$s or higher. You are running PHP version %4$s and MySQL version %5$s.' ),
1037                  $wp_version,
1038                  $required_php_version,
1039                  $required_mysql_version,
1040                  $php_version,
1041                  $mysql_version
1042              ) . $php_update_message
1043          );
1044      } elseif ( ! $php_compat ) {
1045          return new WP_Error(
1046              'php_not_compatible',
1047              sprintf(
1048                  /* translators: 1: WordPress version number, 2: Minimum required PHP version number, 3: Current PHP version number. */
1049                  __( 'The update cannot be installed because WordPress %1$s requires PHP version %2$s or higher. You are running version %3$s.' ),
1050                  $wp_version,
1051                  $required_php_version,
1052                  $php_version
1053              ) . $php_update_message
1054          );
1055      } elseif ( ! $mysql_compat ) {
1056          return new WP_Error(
1057              'mysql_not_compatible',
1058              sprintf(
1059                  /* translators: 1: WordPress version number, 2: Minimum required MySQL version number, 3: Current MySQL version number. */
1060                  __( 'The update cannot be installed because WordPress %1$s requires MySQL version %2$s or higher. You are running version %3$s.' ),
1061                  $wp_version,
1062                  $required_mysql_version,
1063                  $mysql_version
1064              )
1065          );
1066      }
1067  
1068      // Add a warning when the JSON PHP extension is missing.
1069      if ( ! extension_loaded( 'json' ) ) {
1070          return new WP_Error(
1071              'php_not_compatible_json',
1072              sprintf(
1073                  /* translators: 1: WordPress version number, 2: The PHP extension name needed. */
1074                  __( 'The update cannot be installed because WordPress %1$s requires the %2$s PHP extension.' ),
1075                  $wp_version,
1076                  'JSON'
1077              )
1078          );
1079      }
1080  
1081      /** This filter is documented in wp-admin/includes/update-core.php */
1082      apply_filters( 'update_feedback', __( 'Preparing to install the latest version&#8230;' ) );
1083  
1084      // Don't copy wp-content, we'll deal with that below.
1085      // We also copy version.php last so failed updates report their old version.
1086      $skip              = array( 'wp-content', 'wp-includes/version.php' );
1087      $check_is_writable = array();
1088  
1089      // Check to see which files don't really need updating - only available for 3.7 and higher.
1090      if ( function_exists( 'get_core_checksums' ) ) {
1091          // Find the local version of the working directory.
1092          $working_dir_local = WP_CONTENT_DIR . '/upgrade/' . basename( $from ) . $distro;
1093  
1094          $checksums = get_core_checksums( $wp_version, isset( $wp_local_package ) ? $wp_local_package : 'en_US' );
1095  
1096          if ( is_array( $checksums ) && isset( $checksums[ $wp_version ] ) ) {
1097              $checksums = $checksums[ $wp_version ]; // Compat code for 3.7-beta2.
1098          }
1099  
1100          if ( is_array( $checksums ) ) {
1101              foreach ( $checksums as $file => $checksum ) {
1102                  if ( 'wp-content' === substr( $file, 0, 10 ) ) {
1103                      continue;
1104                  }
1105  
1106                  if ( ! file_exists( ABSPATH . $file ) ) {
1107                      continue;
1108                  }
1109  
1110                  if ( ! file_exists( $working_dir_local . $file ) ) {
1111                      continue;
1112                  }
1113  
1114                  if ( '.' === dirname( $file )
1115                      && in_array( pathinfo( $file, PATHINFO_EXTENSION ), array( 'html', 'txt' ), true )
1116                  ) {
1117                      continue;
1118                  }
1119  
1120                  if ( md5_file( ABSPATH . $file ) === $checksum ) {
1121                      $skip[] = $file;
1122                  } else {
1123                      $check_is_writable[ $file ] = ABSPATH . $file;
1124                  }
1125              }
1126          }
1127      }
1128  
1129      // If we're using the direct method, we can predict write failures that are due to permissions.
1130      if ( $check_is_writable && 'direct' === $wp_filesystem->method ) {
1131          $files_writable = array_filter( $check_is_writable, array( $wp_filesystem, 'is_writable' ) );
1132  
1133          if ( $files_writable !== $check_is_writable ) {
1134              $files_not_writable = array_diff_key( $check_is_writable, $files_writable );
1135  
1136              foreach ( $files_not_writable as $relative_file_not_writable => $file_not_writable ) {
1137                  // If the writable check failed, chmod file to 0644 and try again, same as copy_dir().
1138                  $wp_filesystem->chmod( $file_not_writable, FS_CHMOD_FILE );
1139  
1140                  if ( $wp_filesystem->is_writable( $file_not_writable ) ) {
1141                      unset( $files_not_writable[ $relative_file_not_writable ] );
1142                  }
1143              }
1144  
1145              // Store package-relative paths (the key) of non-writable files in the WP_Error object.
1146              $error_data = version_compare( $old_wp_version, '3.7-beta2', '>' ) ? array_keys( $files_not_writable ) : '';
1147  
1148              if ( $files_not_writable ) {
1149                  return new WP_Error(
1150                      'files_not_writable',
1151                      __( 'The update cannot be installed because we will be unable to copy some files. This is usually due to inconsistent file permissions.' ),
1152                      implode( ', ', $error_data )
1153                  );
1154              }
1155          }
1156      }
1157  
1158      /** This filter is documented in wp-admin/includes/update-core.php */
1159      apply_filters( 'update_feedback', __( 'Enabling Maintenance mode&#8230;' ) );
1160  
1161      // Create maintenance file to signal that we are upgrading.
1162      $maintenance_string = '<?php $upgrading = ' . time() . '; ?>';
1163      $maintenance_file   = $to . '.maintenance';
1164      $wp_filesystem->delete( $maintenance_file );
1165      $wp_filesystem->put_contents( $maintenance_file, $maintenance_string, FS_CHMOD_FILE );
1166  
1167      /** This filter is documented in wp-admin/includes/update-core.php */
1168      apply_filters( 'update_feedback', __( 'Copying the required files&#8230;' ) );
1169  
1170      // Copy new versions of WP files into place.
1171      $result = _copy_dir( $from . $distro, $to, $skip );
1172  
1173      if ( is_wp_error( $result ) ) {
1174          $result = new WP_Error(
1175              $result->get_error_code(),
1176              $result->get_error_message(),
1177              substr( $result->get_error_data(), strlen( $to ) )
1178          );
1179      }
1180  
1181      // Since we know the core files have copied over, we can now copy the version file.
1182      if ( ! is_wp_error( $result ) ) {
1183          if ( ! $wp_filesystem->copy( $from . $distro . 'wp-includes/version.php', $to . 'wp-includes/version.php', true /* overwrite */ ) ) {
1184              $wp_filesystem->delete( $from, true );
1185              $result = new WP_Error(
1186                  'copy_failed_for_version_file',
1187                  __( 'The update cannot be installed because we will be unable to copy some files. This is usually due to inconsistent file permissions.' ),
1188                  'wp-includes/version.php'
1189              );
1190          }
1191  
1192          $wp_filesystem->chmod( $to . 'wp-includes/version.php', FS_CHMOD_FILE );
1193  
1194          /*
1195           * `wp_opcache_invalidate()` only exists in WordPress 5.5 or later,
1196           * so don't run it when upgrading from older versions.
1197           */
1198          if ( function_exists( 'wp_opcache_invalidate' ) ) {
1199              wp_opcache_invalidate( $to . 'wp-includes/version.php' );
1200          }
1201      }
1202  
1203      // Check to make sure everything copied correctly, ignoring the contents of wp-content.
1204      $skip   = array( 'wp-content' );
1205      $failed = array();
1206  
1207      if ( isset( $checksums ) && is_array( $checksums ) ) {
1208          foreach ( $checksums as $file => $checksum ) {
1209              if ( 'wp-content' === substr( $file, 0, 10 ) ) {
1210                  continue;
1211              }
1212  
1213              if ( ! file_exists( $working_dir_local . $file ) ) {
1214                  continue;
1215              }
1216  
1217              if ( '.' === dirname( $file )
1218                  && in_array( pathinfo( $file, PATHINFO_EXTENSION ), array( 'html', 'txt' ), true )
1219              ) {
1220                  $skip[] = $file;
1221                  continue;
1222              }
1223  
1224              if ( file_exists( ABSPATH . $file ) && md5_file( ABSPATH . $file ) === $checksum ) {
1225                  $skip[] = $file;
1226              } else {
1227                  $failed[] = $file;
1228              }
1229          }
1230      }
1231  
1232      // Some files didn't copy properly.
1233      if ( ! empty( $failed ) ) {
1234          $total_size = 0;
1235  
1236          foreach ( $failed as $file ) {
1237              if ( file_exists( $working_dir_local . $file ) ) {
1238                  $total_size += filesize( $working_dir_local . $file );
1239              }
1240          }
1241  
1242          // If we don't have enough free space, it isn't worth trying again.
1243          // Unlikely to be hit due to the check in unzip_file().
1244          $available_space = @disk_free_space( ABSPATH );
1245  
1246          if ( $available_space && $total_size >= $available_space ) {
1247              $result = new WP_Error( 'disk_full', __( 'There is not enough free disk space to complete the update.' ) );
1248          } else {
1249              $result = _copy_dir( $from . $distro, $to, $skip );
1250  
1251              if ( is_wp_error( $result ) ) {
1252                  $result = new WP_Error(
1253                      $result->get_error_code() . '_retry',
1254                      $result->get_error_message(),
1255                      substr( $result->get_error_data(), strlen( $to ) )
1256                  );
1257              }
1258          }
1259      }
1260  
1261      // Custom content directory needs updating now.
1262      // Copy languages.
1263      if ( ! is_wp_error( $result ) && $wp_filesystem->is_dir( $from . $distro . 'wp-content/languages' ) ) {
1264          if ( WP_LANG_DIR !== ABSPATH . WPINC . '/languages' || @is_dir( WP_LANG_DIR ) ) {
1265              $lang_dir = WP_LANG_DIR;
1266          } else {
1267              $lang_dir = WP_CONTENT_DIR . '/languages';
1268          }
1269  
1270          // Check if the language directory exists first.
1271          if ( ! @is_dir( $lang_dir ) && 0 === strpos( $lang_dir, ABSPATH ) ) {
1272              // If it's within the ABSPATH we can handle it here, otherwise they're out of luck.
1273              $wp_filesystem->mkdir( $to . str_replace( ABSPATH, '', $lang_dir ), FS_CHMOD_DIR );
1274              clearstatcache(); // For FTP, need to clear the stat cache.
1275          }
1276  
1277          if ( @is_dir( $lang_dir ) ) {
1278              $wp_lang_dir = $wp_filesystem->find_folder( $lang_dir );
1279  
1280              if ( $wp_lang_dir ) {
1281                  $result = copy_dir( $from . $distro . 'wp-content/languages/', $wp_lang_dir );
1282  
1283                  if ( is_wp_error( $result ) ) {
1284                      $result = new WP_Error(
1285                          $result->get_error_code() . '_languages',
1286                          $result->get_error_message(),
1287                          substr( $result->get_error_data(), strlen( $wp_lang_dir ) )
1288                      );
1289                  }
1290              }
1291          }
1292      }
1293  
1294      /** This filter is documented in wp-admin/includes/update-core.php */
1295      apply_filters( 'update_feedback', __( 'Disabling Maintenance mode&#8230;' ) );
1296  
1297      // Remove maintenance file, we're done with potential site-breaking changes.
1298      $wp_filesystem->delete( $maintenance_file );
1299  
1300      // 3.5 -> 3.5+ - an empty twentytwelve directory was created upon upgrade to 3.5 for some users,
1301      // preventing installation of Twenty Twelve.
1302      if ( '3.5' === $old_wp_version ) {
1303          if ( is_dir( WP_CONTENT_DIR . '/themes/twentytwelve' )
1304              && ! file_exists( WP_CONTENT_DIR . '/themes/twentytwelve/style.css' )
1305          ) {
1306              $wp_filesystem->delete( $wp_filesystem->wp_themes_dir() . 'twentytwelve/' );
1307          }
1308      }
1309  
1310      /*
1311       * Copy new bundled plugins & themes.
1312       * This gives us the ability to install new plugins & themes bundled with
1313       * future versions of WordPress whilst avoiding the re-install upon upgrade issue.
1314       * $development_build controls us overwriting bundled themes and plugins when a non-stable release is being updated.
1315       */
1316      if ( ! is_wp_error( $result )
1317          && ( ! defined( 'CORE_UPGRADE_SKIP_NEW_BUNDLED' ) || ! CORE_UPGRADE_SKIP_NEW_BUNDLED )
1318      ) {
1319          foreach ( (array) $_new_bundled_files as $file => $introduced_version ) {
1320              // If a $development_build or if $introduced version is greater than what the site was previously running.
1321              if ( $development_build || version_compare( $introduced_version, $old_wp_version, '>' ) ) {
1322                  $directory = ( '/' === $file[ strlen( $file ) - 1 ] );
1323  
1324                  list( $type, $filename ) = explode( '/', $file, 2 );
1325  
1326                  // Check to see if the bundled items exist before attempting to copy them.
1327                  if ( ! $wp_filesystem->exists( $from . $distro . 'wp-content/' . $file ) ) {
1328                      continue;
1329                  }
1330  
1331                  if ( 'plugins' === $type ) {
1332                      $dest = $wp_filesystem->wp_plugins_dir();
1333                  } elseif ( 'themes' === $type ) {
1334                      // Back-compat, ::wp_themes_dir() did not return trailingslash'd pre-3.2.
1335                      $dest = trailingslashit( $wp_filesystem->wp_themes_dir() );
1336                  } else {
1337                      continue;
1338                  }
1339  
1340                  if ( ! $directory ) {
1341                      if ( ! $development_build && $wp_filesystem->exists( $dest . $filename ) ) {
1342                          continue;
1343                      }
1344  
1345                      if ( ! $wp_filesystem->copy( $from . $distro . 'wp-content/' . $file, $dest . $filename, FS_CHMOD_FILE ) ) {
1346                          $result = new WP_Error( "copy_failed_for_new_bundled_$type", __( 'Could not copy file.' ), $dest . $filename );
1347                      }
1348                  } else {
1349                      if ( ! $development_build && $wp_filesystem->is_dir( $dest . $filename ) ) {
1350                          continue;
1351                      }
1352  
1353                      $wp_filesystem->mkdir( $dest . $filename, FS_CHMOD_DIR );
1354                      $_result = copy_dir( $from . $distro . 'wp-content/' . $file, $dest . $filename );
1355  
1356                      // If a error occurs partway through this final step, keep the error flowing through, but keep process going.
1357                      if ( is_wp_error( $_result ) ) {
1358                          if ( ! is_wp_error( $result ) ) {
1359                              $result = new WP_Error;
1360                          }
1361  
1362                          $result->add(
1363                              $_result->get_error_code() . "_$type",
1364                              $_result->get_error_message(),
1365                              substr( $_result->get_error_data(), strlen( $dest ) )
1366                          );
1367                      }
1368                  }
1369              }
1370          } // End foreach.
1371      }
1372  
1373      // Handle $result error from the above blocks.
1374      if ( is_wp_error( $result ) ) {
1375          $wp_filesystem->delete( $from, true );
1376  
1377          return $result;
1378      }
1379  
1380      // Remove old files.
1381      foreach ( $_old_files as $old_file ) {
1382          $old_file = $to . $old_file;
1383  
1384          if ( ! $wp_filesystem->exists( $old_file ) ) {
1385              continue;
1386          }
1387  
1388          // If the file isn't deleted, try writing an empty string to the file instead.
1389          if ( ! $wp_filesystem->delete( $old_file, true ) && $wp_filesystem->is_file( $old_file ) ) {
1390              $wp_filesystem->put_contents( $old_file, '' );
1391          }
1392      }
1393  
1394      // Remove any Genericons example.html's from the filesystem.
1395      _upgrade_422_remove_genericons();
1396  
1397      // Deactivate the REST API plugin if its version is 2.0 Beta 4 or lower.
1398      _upgrade_440_force_deactivate_incompatible_plugins();
1399  
1400      // Deactivate the Gutenberg plugin if its version is 10.7 or lower.
1401      _upgrade_580_force_deactivate_incompatible_plugins();
1402  
1403      // Upgrade DB with separate request.
1404      /** This filter is documented in wp-admin/includes/update-core.php */
1405      apply_filters( 'update_feedback', __( 'Upgrading database&#8230;' ) );
1406  
1407      $db_upgrade_url = admin_url( 'upgrade.php?step=upgrade_db' );
1408      wp_remote_post( $db_upgrade_url, array( 'timeout' => 60 ) );
1409  
1410      // Clear the cache to prevent an update_option() from saving a stale db_version to the cache.
1411      wp_cache_flush();
1412      // Not all cache back ends listen to 'flush'.
1413      wp_cache_delete( 'alloptions', 'options' );
1414  
1415      // Remove working directory.
1416      $wp_filesystem->delete( $from, true );
1417  
1418      // Force refresh of update information.
1419      if ( function_exists( 'delete_site_transient' ) ) {
1420          delete_site_transient( 'update_core' );
1421      } else {
1422          delete_option( 'update_core' );
1423      }
1424  
1425      /**
1426       * Fires after WordPress core has been successfully updated.
1427       *
1428       * @since 3.3.0
1429       *
1430       * @param string $wp_version The current WordPress version.
1431       */
1432      do_action( '_core_updated_successfully', $wp_version );
1433  
1434      // Clear the option that blocks auto-updates after failures, now that we've been successful.
1435      if ( function_exists( 'delete_site_option' ) ) {
1436          delete_site_option( 'auto_core_update_failed' );
1437      }
1438  
1439      return $wp_version;
1440  }
1441  
1442  /**
1443   * Copies a directory from one location to another via the WordPress Filesystem Abstraction.
1444   *
1445   * Assumes that WP_Filesystem() has already been called and setup.
1446   *
1447   * This is a standalone copy of the `copy_dir()` function that is used to
1448   * upgrade the core files. It is placed here so that the version of this
1449   * function from the *new* WordPress version will be called.
1450   *
1451   * It was initially added for the 3.1 -> 3.2 upgrade.
1452   *
1453   * @ignore
1454   * @since 3.2.0
1455   * @since 3.7.0 Updated not to use a regular expression for the skip list.
1456   *
1457   * @see copy_dir()
1458   * @link https://core.trac.wordpress.org/ticket/17173
1459   *
1460   * @global WP_Filesystem_Base $wp_filesystem
1461   *
1462   * @param string   $from      Source directory.
1463   * @param string   $to        Destination directory.
1464   * @param string[] $skip_list Array of files/folders to skip copying.
1465   * @return true|WP_Error True on success, WP_Error on failure.
1466   */
1467  function _copy_dir( $from, $to, $skip_list = array() ) {
1468      global $wp_filesystem;
1469  
1470      $dirlist = $wp_filesystem->dirlist( $from );
1471  
1472      if ( false === $dirlist ) {
1473          return new WP_Error( 'dirlist_failed__copy_dir', __( 'Directory listing failed.' ), basename( $to ) );
1474      }
1475  
1476      $from = trailingslashit( $from );
1477      $to   = trailingslashit( $to );
1478  
1479      foreach ( (array) $dirlist as $filename => $fileinfo ) {
1480          if ( in_array( $filename, $skip_list, true ) ) {
1481              continue;
1482          }
1483  
1484          if ( 'f' === $fileinfo['type'] ) {
1485              if ( ! $wp_filesystem->copy( $from . $filename, $to . $filename, true, FS_CHMOD_FILE ) ) {
1486                  // If copy failed, chmod file to 0644 and try again.
1487                  $wp_filesystem->chmod( $to . $filename, FS_CHMOD_FILE );
1488  
1489                  if ( ! $wp_filesystem->copy( $from . $filename, $to . $filename, true, FS_CHMOD_FILE ) ) {
1490                      return new WP_Error( 'copy_failed__copy_dir', __( 'Could not copy file.' ), $to . $filename );
1491                  }
1492              }
1493  
1494              /*
1495               * `wp_opcache_invalidate()` only exists in WordPress 5.5 or later,
1496               * so don't run it when upgrading from older versions.
1497               */
1498              if ( function_exists( 'wp_opcache_invalidate' ) ) {
1499                  wp_opcache_invalidate( $to . $filename );
1500              }
1501          } elseif ( 'd' === $fileinfo['type'] ) {
1502              if ( ! $wp_filesystem->is_dir( $to . $filename ) ) {
1503                  if ( ! $wp_filesystem->mkdir( $to . $filename, FS_CHMOD_DIR ) ) {
1504                      return new WP_Error( 'mkdir_failed__copy_dir', __( 'Could not create directory.' ), $to . $filename );
1505                  }
1506              }
1507  
1508              /*
1509               * Generate the $sub_skip_list for the subdirectory as a sub-set
1510               * of the existing $skip_list.
1511               */
1512              $sub_skip_list = array();
1513  
1514              foreach ( $skip_list as $skip_item ) {
1515                  if ( 0 === strpos( $skip_item, $filename . '/' ) ) {
1516                      $sub_skip_list[] = preg_replace( '!^' . preg_quote( $filename, '!' ) . '/!i', '', $skip_item );
1517                  }
1518              }
1519  
1520              $result = _copy_dir( $from . $filename, $to . $filename, $sub_skip_list );
1521  
1522              if ( is_wp_error( $result ) ) {
1523                  return $result;
1524              }
1525          }
1526      }
1527  
1528      return true;
1529  }
1530  
1531  /**
1532   * Redirect to the About WordPress page after a successful upgrade.
1533   *
1534   * This function is only needed when the existing installation is older than 3.4.0.
1535   *
1536   * @since 3.3.0
1537   *
1538   * @global string $wp_version The WordPress version string.
1539   * @global string $pagenow
1540   * @global string $action
1541   *
1542   * @param string $new_version
1543   */
1544  function _redirect_to_about_wordpress( $new_version ) {
1545      global $wp_version, $pagenow, $action;
1546  
1547      if ( version_compare( $wp_version, '3.4-RC1', '>=' ) ) {
1548          return;
1549      }
1550  
1551      // Ensure we only run this on the update-core.php page. The Core_Upgrader may be used in other contexts.
1552      if ( 'update-core.php' !== $pagenow ) {
1553          return;
1554      }
1555  
1556      if ( 'do-core-upgrade' !== $action && 'do-core-reinstall' !== $action ) {
1557          return;
1558      }
1559  
1560      // Load the updated default text localization domain for new strings.
1561      load_default_textdomain();
1562  
1563      // See do_core_upgrade().
1564      show_message( __( 'WordPress updated successfully.' ) );
1565  
1566      // self_admin_url() won't exist when upgrading from <= 3.0, so relative URLs are intentional.
1567      show_message(
1568          '<span class="hide-if-no-js">' . sprintf(
1569              /* translators: 1: WordPress version, 2: URL to About screen. */
1570              __( 'Welcome to WordPress %1$s. You will be redirected to the About WordPress screen. If not, click <a href="%2$s">here</a>.' ),
1571              $new_version,
1572              'about.php?updated'
1573          ) . '</span>'
1574      );
1575      show_message(
1576          '<span class="hide-if-js">' . sprintf(
1577              /* translators: 1: WordPress version, 2: URL to About screen. */
1578              __( 'Welcome to WordPress %1$s. <a href="%2$s">Learn more</a>.' ),
1579              $new_version,
1580              'about.php?updated'
1581          ) . '</span>'
1582      );
1583      echo '</div>';
1584      ?>
1585  <script type="text/javascript">
1586  window.location = 'about.php?updated';
1587  </script>
1588      <?php
1589  
1590      // Include admin-footer.php and exit.
1591      require_once ABSPATH . 'wp-admin/admin-footer.php';
1592      exit;
1593  }
1594  
1595  /**
1596   * Cleans up Genericons example files.
1597   *
1598   * @since 4.2.2
1599   *
1600   * @global array              $wp_theme_directories
1601   * @global WP_Filesystem_Base $wp_filesystem
1602   */
1603  function _upgrade_422_remove_genericons() {
1604      global $wp_theme_directories, $wp_filesystem;
1605  
1606      // A list of the affected files using the filesystem absolute paths.
1607      $affected_files = array();
1608  
1609      // Themes.
1610      foreach ( $wp_theme_directories as $directory ) {
1611          $affected_theme_files = _upgrade_422_find_genericons_files_in_folder( $directory );
1612          $affected_files       = array_merge( $affected_files, $affected_theme_files );
1613      }
1614  
1615      // Plugins.
1616      $affected_plugin_files = _upgrade_422_find_genericons_files_in_folder( WP_PLUGIN_DIR );
1617      $affected_files        = array_merge( $affected_files, $affected_plugin_files );
1618  
1619      foreach ( $affected_files as $file ) {
1620          $gen_dir = $wp_filesystem->find_folder( trailingslashit( dirname( $file ) ) );
1621  
1622          if ( empty( $gen_dir ) ) {
1623              continue;
1624          }
1625  
1626          // The path when the file is accessed via WP_Filesystem may differ in the case of FTP.
1627          $remote_file = $gen_dir . basename( $file );
1628  
1629          if ( ! $wp_filesystem->exists( $remote_file ) ) {
1630              continue;
1631          }
1632  
1633          if ( ! $wp_filesystem->delete( $remote_file, false, 'f' ) ) {
1634              $wp_filesystem->put_contents( $remote_file, '' );
1635          }
1636      }
1637  }
1638  
1639  /**
1640   * Recursively find Genericons example files in a given folder.
1641   *
1642   * @ignore
1643   * @since 4.2.2
1644   *
1645   * @param string $directory Directory path. Expects trailingslashed.
1646   * @return array
1647   */
1648  function _upgrade_422_find_genericons_files_in_folder( $directory ) {
1649      $directory = trailingslashit( $directory );
1650      $files     = array();
1651  
1652      if ( file_exists( "{$directory}example.html" )
1653          && false !== strpos( file_get_contents( "{$directory}example.html" ), '<title>Genericons</title>' )
1654      ) {
1655          $files[] = "{$directory}example.html";
1656      }
1657  
1658      $dirs = glob( $directory . '*', GLOB_ONLYDIR );
1659      $dirs = array_filter(
1660          $dirs,
1661          static function( $dir ) {
1662              // Skip any node_modules directories.
1663              return false === strpos( $dir, 'node_modules' );
1664          }
1665      );
1666  
1667      if ( $dirs ) {
1668          foreach ( $dirs as $dir ) {
1669              $files = array_merge( $files, _upgrade_422_find_genericons_files_in_folder( $dir ) );
1670          }
1671      }
1672  
1673      return $files;
1674  }
1675  
1676  /**
1677   * @ignore
1678   * @since 4.4.0
1679   */
1680  function _upgrade_440_force_deactivate_incompatible_plugins() {
1681      if ( defined( 'REST_API_VERSION' ) && version_compare( REST_API_VERSION, '2.0-beta4', '<=' ) ) {
1682          deactivate_plugins( array( 'rest-api/plugin.php' ), true );
1683      }
1684  }
1685  
1686  /**
1687   * @ignore
1688   * @since 5.8.0
1689   */
1690  function _upgrade_580_force_deactivate_incompatible_plugins() {
1691      if ( defined( 'GUTENBERG_VERSION' ) && version_compare( GUTENBERG_VERSION, '10.7', '<=' ) ) {
1692          $deactivated_gutenberg['gutenberg'] = array(
1693              'plugin_name'         => 'Gutenberg',
1694              'version_deactivated' => GUTENBERG_VERSION,
1695              'version_compatible'  => '10.8',
1696          );
1697          if ( is_plugin_active_for_network( 'gutenberg/gutenberg.php' ) ) {
1698              $deactivated_plugins = get_site_option( 'wp_force_deactivated_plugins', array() );
1699              $deactivated_plugins = array_merge( $deactivated_plugins, $deactivated_gutenberg );
1700              update_site_option( 'wp_force_deactivated_plugins', $deactivated_plugins );
1701          } else {
1702              $deactivated_plugins = get_option( 'wp_force_deactivated_plugins', array() );
1703              $deactivated_plugins = array_merge( $deactivated_plugins, $deactivated_gutenberg );
1704              update_option( 'wp_force_deactivated_plugins', $deactivated_plugins );
1705          }
1706          deactivate_plugins( array( 'gutenberg/gutenberg.php' ), true );
1707      }
1708  }


Generated: Sun Sep 26 01:00:08 2021 Cross-referenced by PHPXref 0.7.1