MediaWiki REL1_32
MysqlUpdater.php
Go to the documentation of this file.
1<?php
26
34 protected function getCoreUpdateList() {
35 return [
36 [ 'disableContentHandlerUseDB' ],
37
38 // 1.2
39 [ 'addField', 'ipblocks', 'ipb_id', 'patch-ipblocks.sql' ],
40 [ 'addField', 'ipblocks', 'ipb_expiry', 'patch-ipb_expiry.sql' ],
41 [ 'doInterwikiUpdate' ],
42 [ 'doIndexUpdate' ],
43 [ 'addField', 'recentchanges', 'rc_type', 'patch-rc_type.sql' ],
44 [ 'addIndex', 'recentchanges', 'new_name_timestamp', 'patch-rc-newindex.sql' ],
45
46 // 1.3
47 [ 'addField', 'user', 'user_real_name', 'patch-user-realname.sql' ],
48 [ 'addTable', 'querycache', 'patch-querycache.sql' ],
49 [ 'addTable', 'objectcache', 'patch-objectcache.sql' ],
50 [ 'addTable', 'categorylinks', 'patch-categorylinks.sql' ],
51 [ 'doOldLinksUpdate' ],
52 [ 'doFixAncientImagelinks' ],
53 [ 'addField', 'recentchanges', 'rc_ip', 'patch-rc_ip.sql' ],
54
55 // 1.4
56 [ 'addIndex', 'image', 'PRIMARY', 'patch-image_name_primary.sql' ],
57 [ 'addField', 'recentchanges', 'rc_id', 'patch-rc_id.sql' ],
58 [ 'addField', 'recentchanges', 'rc_patrolled', 'patch-rc-patrol.sql' ],
59 [ 'addTable', 'logging', 'patch-logging.sql' ],
60 [ 'addField', 'user', 'user_token', 'patch-user_token.sql' ],
61 [ 'addField', 'watchlist', 'wl_notificationtimestamp', 'patch-email-notification.sql' ],
62 [ 'doWatchlistUpdate' ],
63 [ 'dropField', 'user', 'user_emailauthenticationtimestamp',
64 'patch-email-authentication.sql' ],
65
66 // 1.5
67 [ 'doSchemaRestructuring' ],
68 [ 'addField', 'logging', 'log_params', 'patch-log_params.sql' ],
69 [ 'checkBin', 'logging', 'log_title', 'patch-logging-title.sql', ],
70 [ 'addField', 'archive', 'ar_rev_id', 'patch-archive-rev_id.sql' ],
71 [ 'addField', 'page', 'page_len', 'patch-page_len.sql' ],
72 [ 'dropField', 'revision', 'inverse_timestamp', 'patch-inverse_timestamp.sql' ],
73 [ 'addField', 'revision', 'rev_text_id', 'patch-rev_text_id.sql' ],
74 [ 'addField', 'revision', 'rev_deleted', 'patch-rev_deleted.sql' ],
75 [ 'addField', 'image', 'img_width', 'patch-img_width.sql' ],
76 [ 'addField', 'image', 'img_metadata', 'patch-img_metadata.sql' ],
77 [ 'addField', 'user', 'user_email_token', 'patch-user_email_token.sql' ],
78 [ 'addField', 'archive', 'ar_text_id', 'patch-archive-text_id.sql' ],
79 [ 'doNamespaceSize' ],
80 [ 'addField', 'image', 'img_media_type', 'patch-img_media_type.sql' ],
81 [ 'doPagelinksUpdate' ],
82 [ 'dropField', 'image', 'img_type', 'patch-drop_img_type.sql' ],
83 [ 'doUserUniqueUpdate' ],
84 [ 'doUserGroupsUpdate' ],
85 [ 'addField', 'site_stats', 'ss_total_pages', 'patch-ss_total_articles.sql' ],
86 [ 'addTable', 'user_newtalk', 'patch-usernewtalk.sql' ],
87 [ 'addField', 'interwiki', 'iw_trans', 'patch-interwiki-trans.sql' ],
88
89 // 1.6
90 [ 'doWatchlistNull' ],
91 [ 'addIndex', 'logging', 'times', 'patch-logging-times-index.sql' ],
92 [ 'addField', 'ipblocks', 'ipb_range_start', 'patch-ipb_range_start.sql' ],
93 [ 'doPageRandomUpdate' ],
94 [ 'addField', 'user', 'user_registration', 'patch-user_registration.sql' ],
95 [ 'doTemplatelinksUpdate' ],
96 [ 'addTable', 'externallinks', 'patch-externallinks.sql' ],
97 [ 'addTable', 'job', 'patch-job.sql' ],
98 [ 'addField', 'site_stats', 'ss_images', 'patch-ss_images.sql' ],
99 [ 'addTable', 'langlinks', 'patch-langlinks.sql' ],
100 [ 'addTable', 'querycache_info', 'patch-querycacheinfo.sql' ],
101 [ 'addTable', 'filearchive', 'patch-filearchive.sql' ],
102 [ 'addField', 'ipblocks', 'ipb_anon_only', 'patch-ipb_anon_only.sql' ],
103 [ 'addIndex', 'recentchanges', 'rc_ns_usertext', 'patch-recentchanges-utindex.sql' ],
104 [ 'addIndex', 'recentchanges', 'rc_user_text', 'patch-rc_user_text-index.sql' ],
105
106 // 1.9
107 [ 'addField', 'user', 'user_newpass_time', 'patch-user_newpass_time.sql' ],
108 [ 'addTable', 'redirect', 'patch-redirect.sql' ],
109 [ 'addTable', 'querycachetwo', 'patch-querycachetwo.sql' ],
110 [ 'addField', 'ipblocks', 'ipb_enable_autoblock', 'patch-ipb_optional_autoblock.sql' ],
111 [ 'doBacklinkingIndicesUpdate' ],
112 [ 'addField', 'recentchanges', 'rc_old_len', 'patch-rc_len.sql' ],
113 [ 'addField', 'user', 'user_editcount', 'patch-user_editcount.sql' ],
114
115 // 1.10
116 [ 'doRestrictionsUpdate' ],
117 [ 'addField', 'logging', 'log_id', 'patch-log_id.sql' ],
118 [ 'addField', 'revision', 'rev_parent_id', 'patch-rev_parent_id.sql' ],
119 [ 'addField', 'page_restrictions', 'pr_id', 'patch-page_restrictions_sortkey.sql' ],
120 [ 'addField', 'revision', 'rev_len', 'patch-rev_len.sql' ],
121 [ 'addField', 'recentchanges', 'rc_deleted', 'patch-rc_deleted.sql' ],
122 [ 'addField', 'logging', 'log_deleted', 'patch-log_deleted.sql' ],
123 [ 'addField', 'archive', 'ar_deleted', 'patch-ar_deleted.sql' ],
124 [ 'addField', 'ipblocks', 'ipb_deleted', 'patch-ipb_deleted.sql' ],
125 [ 'addField', 'filearchive', 'fa_deleted', 'patch-fa_deleted.sql' ],
126 [ 'addField', 'archive', 'ar_len', 'patch-ar_len.sql' ],
127
128 // 1.11
129 [ 'addField', 'ipblocks', 'ipb_block_email', 'patch-ipb_emailban.sql' ],
130 [ 'doCategorylinksIndicesUpdate' ],
131 [ 'addField', 'oldimage', 'oi_metadata', 'patch-oi_metadata.sql' ],
132 [ 'addIndex', 'archive', 'usertext_timestamp', 'patch-archive-user-index.sql' ],
133 [ 'addIndex', 'image', 'img_usertext_timestamp', 'patch-image-user-index.sql' ],
134 [ 'addIndex', 'oldimage', 'oi_usertext_timestamp', 'patch-oldimage-user-index.sql' ],
135 [ 'addField', 'archive', 'ar_page_id', 'patch-archive-page_id.sql' ],
136 [ 'addField', 'image', 'img_sha1', 'patch-img_sha1.sql' ],
137
138 // 1.12
139 [ 'addTable', 'protected_titles', 'patch-protected_titles.sql' ],
140
141 // 1.13
142 [ 'addField', 'ipblocks', 'ipb_by_text', 'patch-ipb_by_text.sql' ],
143 [ 'addTable', 'page_props', 'patch-page_props.sql' ],
144 [ 'addTable', 'updatelog', 'patch-updatelog.sql' ],
145 [ 'addTable', 'category', 'patch-category.sql' ],
146 [ 'doCategoryPopulation' ],
147 [ 'addField', 'archive', 'ar_parent_id', 'patch-ar_parent_id.sql' ],
148 [ 'addField', 'user_newtalk', 'user_last_timestamp', 'patch-user_last_timestamp.sql' ],
149 [ 'doPopulateParentId' ],
150 [ 'checkBin', 'protected_titles', 'pt_title', 'patch-pt_title-encoding.sql', ],
151 [ 'doMaybeProfilingMemoryUpdate' ],
152 [ 'doFilearchiveIndicesUpdate' ],
153
154 // 1.14
155 [ 'addField', 'site_stats', 'ss_active_users', 'patch-ss_active_users.sql' ],
156 [ 'doActiveUsersInit' ],
157 [ 'addField', 'ipblocks', 'ipb_allow_usertalk', 'patch-ipb_allow_usertalk.sql' ],
158
159 // 1.15
160 [ 'addTable', 'change_tag', 'patch-change_tag.sql' ],
161 [ 'addTable', 'tag_summary', 'patch-tag_summary.sql' ],
162 [ 'addTable', 'valid_tag', 'patch-valid_tag.sql' ],
163
164 // 1.16
165 [ 'addTable', 'user_properties', 'patch-user_properties.sql' ],
166 [ 'addTable', 'log_search', 'patch-log_search.sql' ],
167 [ 'addField', 'logging', 'log_user_text', 'patch-log_user_text.sql' ],
168 # listed separately from the previous update because 1.16 was released without this update
169 [ 'doLogUsertextPopulation' ],
170 [ 'doLogSearchPopulation' ],
171 [ 'addTable', 'l10n_cache', 'patch-l10n_cache.sql' ],
172 [ 'addIndex', 'tag_summary', 'tag_summary_rc_id', 'patch-change_tag-indexes.sql' ],
173 [ 'addField', 'redirect', 'rd_interwiki', 'patch-rd_interwiki.sql' ],
174 [ 'doUpdateMimeMinorField' ],
175
176 // 1.17
177 [ 'addTable', 'iwlinks', 'patch-iwlinks.sql' ],
178 [ 'addIndex', 'iwlinks', 'iwl_prefix_title_from', 'patch-rename-iwl_prefix.sql' ],
179 [ 'addField', 'updatelog', 'ul_value', 'patch-ul_value.sql' ],
180 [ 'addField', 'interwiki', 'iw_api', 'patch-iw_api_and_wikiid.sql' ],
181 [ 'dropIndex', 'iwlinks', 'iwl_prefix', 'patch-kill-iwl_prefix.sql' ],
182 [ 'addField', 'categorylinks', 'cl_collation', 'patch-categorylinks-better-collation.sql' ],
183 [ 'doClFieldsUpdate' ],
184 [ 'addTable', 'module_deps', 'patch-module_deps.sql' ],
185 [ 'dropIndex', 'archive', 'ar_page_revid', 'patch-archive_kill_ar_page_revid.sql' ],
186 [ 'addIndexIfNoneExist',
187 'archive', [ 'ar_revid', 'ar_revid_uniq' ], 'patch-archive_ar_revid.sql' ],
188 [ 'doLangLinksLengthUpdate' ],
189
190 // 1.18
191 [ 'doUserNewTalkTimestampNotNull' ],
192 [ 'addIndex', 'user', 'user_email', 'patch-user_email_index.sql' ],
193 [ 'modifyField', 'user_properties', 'up_property', 'patch-up_property.sql' ],
194 [ 'addTable', 'uploadstash', 'patch-uploadstash.sql' ],
195 [ 'addTable', 'user_former_groups', 'patch-user_former_groups.sql' ],
196
197 // 1.19
198 [ 'addField', 'revision', 'rev_sha1', 'patch-rev_sha1.sql' ],
199 [ 'doMigrateUserOptions' ],
200 [ 'dropField', 'user', 'user_options', 'patch-drop-user_options.sql' ],
201 [ 'addField', 'archive', 'ar_sha1', 'patch-ar_sha1.sql' ],
202 [ 'addIndex', 'page', 'page_redirect_namespace_len',
203 'patch-page_redirect_namespace_len.sql' ],
204 [ 'addField', 'uploadstash', 'us_chunk_inx', 'patch-uploadstash_chunk.sql' ],
205 [ 'addfield', 'job', 'job_timestamp', 'patch-jobs-add-timestamp.sql' ],
206
207 // 1.20
208 [ 'addIndex', 'revision', 'page_user_timestamp', 'patch-revision-user-page-index.sql' ],
209 [ 'addField', 'ipblocks', 'ipb_parent_block_id', 'patch-ipb-parent-block-id.sql' ],
210 [ 'addIndex', 'ipblocks', 'ipb_parent_block_id', 'patch-ipb-parent-block-id-index.sql' ],
211 [ 'dropField', 'category', 'cat_hidden', 'patch-cat_hidden.sql' ],
212
213 // 1.21
214 [ 'addField', 'revision', 'rev_content_format', 'patch-revision-rev_content_format.sql' ],
215 [ 'addField', 'revision', 'rev_content_model', 'patch-revision-rev_content_model.sql' ],
216 [ 'addField', 'archive', 'ar_content_format', 'patch-archive-ar_content_format.sql' ],
217 [ 'addField', 'archive', 'ar_content_model', 'patch-archive-ar_content_model.sql' ],
218 [ 'addField', 'page', 'page_content_model', 'patch-page-page_content_model.sql' ],
219 [ 'enableContentHandlerUseDB' ],
220 [ 'dropField', 'site_stats', 'ss_admins', 'patch-drop-ss_admins.sql' ],
221 [ 'dropField', 'recentchanges', 'rc_moved_to_title', 'patch-rc_moved.sql' ],
222 [ 'addTable', 'sites', 'patch-sites.sql' ],
223 [ 'addField', 'filearchive', 'fa_sha1', 'patch-fa_sha1.sql' ],
224 [ 'addField', 'job', 'job_token', 'patch-job_token.sql' ],
225 [ 'addField', 'job', 'job_attempts', 'patch-job_attempts.sql' ],
226 [ 'doEnableProfiling' ],
227 [ 'addField', 'uploadstash', 'us_props', 'patch-uploadstash-us_props.sql' ],
228 [ 'modifyField', 'user_groups', 'ug_group', 'patch-ug_group-length-increase-255.sql' ],
229 [ 'modifyField', 'user_former_groups', 'ufg_group',
230 'patch-ufg_group-length-increase-255.sql' ],
231 [ 'addIndex', 'page_props', 'pp_propname_page',
232 'patch-page_props-propname-page-index.sql' ],
233 [ 'addIndex', 'image', 'img_media_mime', 'patch-img_media_mime-index.sql' ],
234
235 // 1.22
236 [ 'doIwlinksIndexNonUnique' ],
237 [ 'addIndex', 'iwlinks', 'iwl_prefix_from_title',
238 'patch-iwlinks-from-title-index.sql' ],
239 [ 'addField', 'archive', 'ar_id', 'patch-archive-ar_id.sql' ],
240 [ 'addField', 'externallinks', 'el_id', 'patch-externallinks-el_id.sql' ],
241
242 // 1.23
243 [ 'addField', 'recentchanges', 'rc_source', 'patch-rc_source.sql' ],
244 [ 'addIndex', 'logging', 'log_user_text_type_time',
245 'patch-logging_user_text_type_time_index.sql' ],
246 [ 'addIndex', 'logging', 'log_user_text_time', 'patch-logging_user_text_time_index.sql' ],
247 [ 'addField', 'page', 'page_links_updated', 'patch-page_links_updated.sql' ],
248 [ 'addField', 'user', 'user_password_expires', 'patch-user_password_expire.sql' ],
249
250 // 1.24
251 [ 'addField', 'page_props', 'pp_sortkey', 'patch-pp_sortkey.sql' ],
252 [ 'dropField', 'recentchanges', 'rc_cur_time', 'patch-drop-rc_cur_time.sql' ],
253 [ 'addIndex', 'watchlist', 'wl_user_notificationtimestamp',
254 'patch-watchlist-user-notificationtimestamp-index.sql' ],
255 [ 'addField', 'page', 'page_lang', 'patch-page_lang.sql' ],
256 [ 'addField', 'pagelinks', 'pl_from_namespace', 'patch-pl_from_namespace.sql' ],
257 [ 'addField', 'templatelinks', 'tl_from_namespace', 'patch-tl_from_namespace.sql' ],
258 [ 'addField', 'imagelinks', 'il_from_namespace', 'patch-il_from_namespace.sql' ],
259 [ 'modifyField', 'image', 'img_major_mime',
260 'patch-img_major_mime-chemical.sql' ],
261 [ 'modifyField', 'oldimage', 'oi_major_mime',
262 'patch-oi_major_mime-chemical.sql' ],
263 [ 'modifyField', 'filearchive', 'fa_major_mime',
264 'patch-fa_major_mime-chemical.sql' ],
265
266 // 1.25
267 // note this patch covers other _comment and _description fields too
268 [ 'doExtendCommentLengths' ],
269
270 // 1.26
271 [ 'dropTable', 'hitcounter' ],
272 [ 'dropField', 'site_stats', 'ss_total_views', 'patch-drop-ss_total_views.sql' ],
273 [ 'dropField', 'page', 'page_counter', 'patch-drop-page_counter.sql' ],
274
275 // 1.27
276 [ 'dropTable', 'msg_resource_links' ],
277 [ 'dropTable', 'msg_resource' ],
278 [ 'addTable', 'bot_passwords', 'patch-bot_passwords.sql' ],
279 [ 'addField', 'watchlist', 'wl_id', 'patch-watchlist-wl_id.sql' ],
280 [ 'dropIndex', 'categorylinks', 'cl_collation', 'patch-kill-cl_collation_index.sql' ],
281 [ 'addIndex', 'categorylinks', 'cl_collation_ext',
282 'patch-add-cl_collation_ext_index.sql' ],
283 [ 'doCollationUpdate' ],
284
285 // 1.28
286 [ 'addIndex', 'recentchanges', 'rc_name_type_patrolled_timestamp',
287 'patch-add-rc_name_type_patrolled_timestamp_index.sql' ],
288 [ 'doRevisionPageRevIndexNonUnique' ],
289 [ 'doNonUniquePlTlIl' ],
290 [ 'addField', 'change_tag', 'ct_id', 'patch-change_tag-ct_id.sql' ],
291 [ 'addField', 'tag_summary', 'ts_id', 'patch-tag_summary-ts_id.sql' ],
292 [ 'modifyField', 'recentchanges', 'rc_ip', 'patch-rc_ip_modify.sql' ],
293 [ 'addIndex', 'archive', 'usertext_timestamp', 'patch-rename-ar_usertext_timestamp.sql' ],
294
295 // 1.29
296 [ 'addField', 'externallinks', 'el_index_60', 'patch-externallinks-el_index_60.sql' ],
297 [ 'dropIndex', 'user_groups', 'ug_user_group', 'patch-user_groups-primary-key.sql' ],
298 [ 'addField', 'user_groups', 'ug_expiry', 'patch-user_groups-ug_expiry.sql' ],
299 [ 'addIndex', 'image', 'img_user_timestamp', 'patch-image-user-index-2.sql' ],
300
301 // 1.30
302 [ 'modifyField', 'image', 'img_media_type', 'patch-add-3d.sql' ],
303 [ 'addTable', 'ip_changes', 'patch-ip_changes.sql' ],
304 [ 'renameIndex', 'categorylinks', 'cl_from', 'PRIMARY', false,
305 'patch-categorylinks-fix-pk.sql' ],
306 [ 'renameIndex', 'templatelinks', 'tl_from', 'PRIMARY', false,
307 'patch-templatelinks-fix-pk.sql' ],
308 [ 'renameIndex', 'pagelinks', 'pl_from', 'PRIMARY', false, 'patch-pagelinks-fix-pk.sql' ],
309 [ 'renameIndex', 'text', 'old_id', 'PRIMARY', false, 'patch-text-fix-pk.sql' ],
310 [ 'renameIndex', 'imagelinks', 'il_from', 'PRIMARY', false, 'patch-imagelinks-fix-pk.sql' ],
311 [ 'renameIndex', 'iwlinks', 'iwl_from', 'PRIMARY', false, 'patch-iwlinks-fix-pk.sql' ],
312 [ 'renameIndex', 'langlinks', 'll_from', 'PRIMARY', false, 'patch-langlinks-fix-pk.sql' ],
313 [ 'renameIndex', 'log_search', 'ls_field_val', 'PRIMARY', false, 'patch-log_search-fix-pk.sql' ],
314 [ 'renameIndex', 'module_deps', 'md_module_skin', 'PRIMARY', false,
315 'patch-module_deps-fix-pk.sql' ],
316 [ 'renameIndex', 'objectcache', 'keyname', 'PRIMARY', false, 'patch-objectcache-fix-pk.sql' ],
317 [ 'renameIndex', 'querycache_info', 'qci_type', 'PRIMARY', false,
318 'patch-querycache_info-fix-pk.sql' ],
319 [ 'renameIndex', 'site_stats', 'ss_row_id', 'PRIMARY', false, 'patch-site_stats-fix-pk.sql' ],
320 [ 'renameIndex', 'user_former_groups', 'ufg_user_group', 'PRIMARY', false,
321 'patch-user_former_groups-fix-pk.sql' ],
322 [ 'renameIndex', 'user_properties', 'user_properties_user_property', 'PRIMARY', false,
323 'patch-user_properties-fix-pk.sql' ],
324 [ 'addTable', 'comment', 'patch-comment-table.sql' ],
325 [ 'addTable', 'revision_comment_temp', 'patch-revision_comment_temp-table.sql' ],
326 // image_comment_temp is no longer needed when upgrading to MW 1.31 or newer,
327 // as it is dropped later in the update process as part of 'migrateImageCommentTemp'.
328 // File kept on disk and the updater entry here for historical purposes.
329 // [ 'addTable', 'image_comment_temp', 'patch-image_comment_temp-table.sql' ],
330 [ 'addField', 'archive', 'ar_comment_id', 'patch-archive-ar_comment_id.sql' ],
331 [ 'addField', 'filearchive', 'fa_description_id', 'patch-filearchive-fa_description_id.sql' ],
332 [ 'modifyField', 'image', 'img_description', 'patch-image-img_description-default.sql' ],
333 [ 'addField', 'ipblocks', 'ipb_reason_id', 'patch-ipblocks-ipb_reason_id.sql' ],
334 [ 'addField', 'logging', 'log_comment_id', 'patch-logging-log_comment_id.sql' ],
335 [ 'addField', 'oldimage', 'oi_description_id', 'patch-oldimage-oi_description_id.sql' ],
336 [ 'addField', 'protected_titles', 'pt_reason_id', 'patch-protected_titles-pt_reason_id.sql' ],
337 [ 'addField', 'recentchanges', 'rc_comment_id', 'patch-recentchanges-rc_comment_id.sql' ],
338 [ 'modifyField', 'revision', 'rev_comment', 'patch-revision-rev_comment-default.sql' ],
339
340 // This field was added in 1.31, but is put here so it can be used by 'migrateComments'
341 [ 'addField', 'image', 'img_description_id', 'patch-image-img_description_id.sql' ],
342
343 [ 'migrateComments' ],
344 [ 'renameIndex', 'l10n_cache', 'lc_lang_key', 'PRIMARY', false,
345 'patch-l10n_cache-primary-key.sql' ],
346 [ 'doUnsignedSyncronisation' ],
347
348 // 1.31
349 [ 'addTable', 'slots', 'patch-slots.sql' ],
350 [ 'addField', 'slots', 'slot_origin', 'patch-slot-origin.sql' ],
351 [ 'addTable', 'content', 'patch-content.sql' ],
352 [ 'addTable', 'slot_roles', 'patch-slot_roles.sql' ],
353 [ 'addTable', 'content_models', 'patch-content_models.sql' ],
354 [ 'migrateArchiveText' ],
355 [ 'addTable', 'actor', 'patch-actor-table.sql' ],
356 [ 'addTable', 'revision_actor_temp', 'patch-revision_actor_temp-table.sql' ],
357 [ 'addField', 'archive', 'ar_actor', 'patch-archive-ar_actor.sql' ],
358 [ 'addField', 'ipblocks', 'ipb_by_actor', 'patch-ipblocks-ipb_by_actor.sql' ],
359 [ 'addField', 'image', 'img_actor', 'patch-image-img_actor.sql' ],
360 [ 'addField', 'oldimage', 'oi_actor', 'patch-oldimage-oi_actor.sql' ],
361 [ 'addField', 'filearchive', 'fa_actor', 'patch-filearchive-fa_actor.sql' ],
362 [ 'addField', 'recentchanges', 'rc_actor', 'patch-recentchanges-rc_actor.sql' ],
363 [ 'addField', 'logging', 'log_actor', 'patch-logging-log_actor.sql' ],
364 [ 'migrateActors' ],
365 [ 'modifyField', 'revision', 'rev_text_id', 'patch-rev_text_id-default.sql' ],
366 [ 'modifyTable', 'site_stats', 'patch-site_stats-modify.sql' ],
367 [ 'populateArchiveRevId' ],
368 [ 'addIndex', 'recentchanges', 'rc_namespace_title_timestamp',
369 'patch-recentchanges-nttindex.sql' ],
370
371 // 1.32
372 [ 'addTable', 'change_tag_def', 'patch-change_tag_def.sql' ],
373 [ 'populateExternallinksIndex60' ],
374 [ 'modifyfield', 'externallinks', 'el_index_60',
375 'patch-externallinks-el_index_60-drop-default.sql' ],
376 [ 'runMaintenance', DeduplicateArchiveRevId::class, 'maintenance/deduplicateArchiveRevId.php' ],
377 [ 'addField', 'change_tag', 'ct_tag_id', 'patch-change_tag-tag_id.sql' ],
378 [ 'addIndex', 'archive', 'ar_revid_uniq', 'patch-archive-ar_rev_id-unique.sql' ],
379 [ 'populateContentTables' ],
380 [ 'addIndex', 'logging', 'log_type_action', 'patch-logging-log-type-action-index.sql' ],
381 [ 'dropIndex', 'logging', 'type_action', 'patch-logging-drop-type-action-index.sql' ],
382 [ 'renameIndex', 'interwiki', 'iw_prefix', 'PRIMARY', false, 'patch-interwiki-fix-pk.sql' ],
383 [ 'renameIndex', 'page_props', 'pp_page_propname', 'PRIMARY', false,
384 'patch-page_props-fix-pk.sql' ],
385 [ 'renameIndex', 'protected_titles', 'pt_namespace_title', 'PRIMARY', false,
386 'patch-protected_titles-fix-pk.sql' ],
387 [ 'renameIndex', 'site_identifiers', 'site_ids_type', 'PRIMARY', false,
388 'patch-site_identifiers-fix-pk.sql' ],
389 [ 'addIndex', 'recentchanges', 'rc_this_oldid', 'patch-recentchanges-rc_this_oldid-index.sql' ],
390 [ 'dropTable', 'transcache' ],
391 [ 'runMaintenance', PopulateChangeTagDef::class, 'maintenance/populateChangeTagDef.php' ],
392 [ 'addIndex', 'change_tag', 'change_tag_rc_tag_id',
393 'patch-change_tag-change_tag_rc_tag_id.sql' ],
394 [ 'addField', 'ipblocks', 'ipb_sitewide', 'patch-ipb_sitewide.sql' ],
395 [ 'addTable', 'ipblocks_restrictions', 'patch-ipblocks_restrictions-table.sql' ],
396 [ 'migrateImageCommentTemp' ],
397 ];
398 }
399
409 protected function checkBin( $table, $field, $patchFile ) {
410 if ( !$this->doTable( $table ) ) {
411 return true;
412 }
413
415 $fieldInfo = $this->db->fieldInfo( $table, $field );
416 if ( $fieldInfo->isBinary() ) {
417 $this->output( "...$table table has correct $field encoding.\n" );
418 } else {
419 $this->applyPatch( $patchFile, false, "Fixing $field encoding on $table table" );
420 }
421 }
422
431 protected function indexHasField( $table, $index, $field ) {
432 if ( !$this->doTable( $table ) ) {
433 return true;
434 }
435
436 $info = $this->db->indexInfo( $table, $index, __METHOD__ );
437 if ( $info ) {
438 foreach ( $info as $row ) {
439 if ( $row->Column_name == $field ) {
440 $this->output( "...index $index on table $table includes field $field.\n" );
441
442 return true;
443 }
444 }
445 }
446 $this->output( "...index $index on table $table has no field $field; added.\n" );
447
448 return false;
449 }
450
454 protected function doInterwikiUpdate() {
455 global $IP;
456
457 if ( !$this->doTable( 'interwiki' ) ) {
458 return;
459 }
460
461 if ( $this->db->tableExists( "interwiki", __METHOD__ ) ) {
462 $this->output( "...already have interwiki table\n" );
463
464 return;
465 }
466
467 $this->applyPatch( 'patch-interwiki.sql', false, 'Creating interwiki table' );
468 $this->applyPatch(
469 "$IP/maintenance/interwiki.sql",
470 true,
471 'Adding default interwiki definitions'
472 );
473 }
474
478 protected function doIndexUpdate() {
479 $meta = $this->db->fieldInfo( 'recentchanges', 'rc_timestamp' );
480 if ( $meta === false ) {
481 throw new MWException( 'Missing rc_timestamp field of recentchanges table. Should not happen.' );
482 }
483 if ( $meta->isMultipleKey() ) {
484 $this->output( "...indexes seem up to 20031107 standards.\n" );
485
486 return;
487 }
488
489 $this->applyPatch( 'patch-indexes.sql', true, "Updating indexes to 20031107" );
490 }
491
492 protected function doOldLinksUpdate() {
493 $cl = $this->maintenance->runChild( ConvertLinks::class );
494 $cl->execute();
495 }
496
497 protected function doFixAncientImagelinks() {
498 $info = $this->db->fieldInfo( 'imagelinks', 'il_from' );
499 if ( !$info || $info->type() !== 'string' ) {
500 $this->output( "...il_from OK\n" );
501
502 return;
503 }
504
505 $applied = $this->applyPatch(
506 'patch-fix-il_from.sql',
507 false,
508 'Fixing ancient broken imagelinks table.'
509 );
510
511 if ( $applied ) {
512 $this->output( "NOTE: you will have to run maintenance/refreshLinks.php after this." );
513 }
514 }
515
519 function doWatchlistUpdate() {
520 $talk = $this->db->selectField( 'watchlist', 'count(*)', 'wl_namespace & 1', __METHOD__ );
521 $nontalk = $this->db->selectField(
522 'watchlist',
523 'count(*)',
524 'NOT (wl_namespace & 1)',
525 __METHOD__
526 );
527 if ( $talk == $nontalk ) {
528 $this->output( "...watchlist talk page rows already present.\n" );
529
530 return;
531 }
532
533 $insertOpts = [ 'IGNORE' ];
534 $selectOpts = [];
535
536 // If wl_id exists, make insertSelect() more replication-safe by
537 // ordering on that column. If not, hint that it should be safe anyway.
538 if ( $this->db->fieldExists( 'watchlist', 'wl_id', __METHOD__ ) ) {
539 $selectOpts['ORDER BY'] = 'wl_id';
540 } else {
541 $insertOpts[] = 'NO_AUTO_COLUMNS';
542 }
543
544 $this->output( "Adding missing watchlist talk page rows... " );
545 $this->db->insertSelect( 'watchlist', 'watchlist',
546 [
547 'wl_user' => 'wl_user',
548 'wl_namespace' => 'wl_namespace | 1',
549 'wl_title' => 'wl_title',
550 'wl_notificationtimestamp' => 'wl_notificationtimestamp'
551 ], [ 'NOT (wl_namespace & 1)' ], __METHOD__, $insertOpts, $selectOpts );
552 $this->output( "done.\n" );
553
554 $this->output( "Adding missing watchlist subject page rows... " );
555 $this->db->insertSelect( 'watchlist', 'watchlist',
556 [
557 'wl_user' => 'wl_user',
558 'wl_namespace' => 'wl_namespace & ~1',
559 'wl_title' => 'wl_title',
560 'wl_notificationtimestamp' => 'wl_notificationtimestamp'
561 ], [ 'wl_namespace & 1' ], __METHOD__, $insertOpts, $selectOpts );
562 $this->output( "done.\n" );
563 }
564
566 if ( $this->db->tableExists( 'page', __METHOD__ ) ) {
567 $this->output( "...page table already exists.\n" );
568
569 return;
570 }
571
572 $this->output( "...converting from cur/old to page/revision/text DB structure.\n" );
573 $this->output( wfTimestamp( TS_DB ) );
574 $this->output( "......checking for duplicate entries.\n" );
575
576 list( $cur, $old, $page, $revision, $text ) = $this->db->tableNamesN(
577 'cur',
578 'old',
579 'page',
580 'revision',
581 'text'
582 );
583
584 $rows = $this->db->query( "
585 SELECT cur_title, cur_namespace, COUNT(cur_namespace) AS c
586 FROM $cur
587 GROUP BY cur_title, cur_namespace
588 HAVING c>1",
589 __METHOD__
590 );
591
592 if ( $rows->numRows() > 0 ) {
593 $this->output( wfTimestamp( TS_DB ) );
594 $this->output( "......<b>Found duplicate entries</b>\n" );
595 $this->output( sprintf( "<b> %-60s %3s %5s</b>\n", 'Title', 'NS', 'Count' ) );
596 $duplicate = [];
597 foreach ( $rows as $row ) {
598 if ( !isset( $duplicate[$row->cur_namespace] ) ) {
599 $duplicate[$row->cur_namespace] = [];
600 }
601
602 $duplicate[$row->cur_namespace][] = $row->cur_title;
603 $this->output( sprintf(
604 " %-60s %3s %5s\n",
605 $row->cur_title, $row->cur_namespace,
606 $row->c
607 ) );
608 }
609 $sql = "SELECT cur_title, cur_namespace, cur_id, cur_timestamp FROM $cur WHERE ";
610 $dupeTitles = [];
611 foreach ( $duplicate as $ns => $titles ) {
612 $dupeTitles[] = "( cur_namespace = {$ns} AND cur_title in ("
613 . $this->db->makeList( $titles ) . ") ) \n";
614 }
615 $sql .= $this->db->makeList( $dupeTitles, IDatabase::LIST_OR );
616 # By sorting descending, the most recent entry will be the first in the list.
617 # All following entries will be deleted by the next while-loop.
618 $sql .= 'ORDER BY cur_namespace, cur_title, cur_timestamp DESC';
619
620 $rows = $this->db->query( $sql, __METHOD__ );
621
622 $prev_title = $prev_namespace = false;
623 $deleteId = [];
624
625 foreach ( $rows as $row ) {
626 if ( $prev_title == $row->cur_title && $prev_namespace == $row->cur_namespace ) {
627 $deleteId[] = (int)$row->cur_id;
628 }
629 $prev_title = $row->cur_title;
630 $prev_namespace = $row->cur_namespace;
631 }
632 $sql = "DELETE FROM $cur WHERE cur_id IN ( " . implode( ',', $deleteId ) . ')';
633 $this->db->query( $sql, __METHOD__ );
634 $this->output( wfTimestamp( TS_DB ) );
635 $this->output( "......<b>Deleted</b> " . $this->db->affectedRows() . " records.\n" );
636 }
637
638 $this->output( wfTimestamp( TS_DB ) );
639 $this->output( "......Creating tables.\n" );
640 $this->db->query( "CREATE TABLE $page (
641 page_id int(8) unsigned NOT NULL auto_increment,
642 page_namespace int NOT NULL,
643 page_title varchar(255) binary NOT NULL,
644 page_restrictions tinyblob NOT NULL,
645 page_is_redirect tinyint(1) unsigned NOT NULL default '0',
646 page_is_new tinyint(1) unsigned NOT NULL default '0',
647 page_random real unsigned NOT NULL,
648 page_touched char(14) binary NOT NULL default '',
649 page_latest int(8) unsigned NOT NULL,
650 page_len int(8) unsigned NOT NULL,
651
652 PRIMARY KEY page_id (page_id),
653 UNIQUE INDEX name_title (page_namespace,page_title),
654 INDEX (page_random),
655 INDEX (page_len)
656 ) ENGINE=InnoDB", __METHOD__ );
657 $this->db->query( "CREATE TABLE $revision (
658 rev_id int(8) unsigned NOT NULL auto_increment,
659 rev_page int(8) unsigned NOT NULL,
660 rev_comment tinyblob NOT NULL,
661 rev_user int(5) unsigned NOT NULL default '0',
662 rev_user_text varchar(255) binary NOT NULL default '',
663 rev_timestamp char(14) binary NOT NULL default '',
664 rev_minor_edit tinyint(1) unsigned NOT NULL default '0',
665 rev_deleted tinyint(1) unsigned NOT NULL default '0',
666 rev_len int(8) unsigned,
667 rev_parent_id int(8) unsigned default NULL,
668 PRIMARY KEY rev_page_id (rev_page, rev_id),
669 UNIQUE INDEX rev_id (rev_id),
670 INDEX rev_timestamp (rev_timestamp),
671 INDEX page_timestamp (rev_page,rev_timestamp),
672 INDEX user_timestamp (rev_user,rev_timestamp),
673 INDEX usertext_timestamp (rev_user_text,rev_timestamp)
674 ) ENGINE=InnoDB", __METHOD__ );
675
676 $this->output( wfTimestamp( TS_DB ) );
677 $this->output( "......Locking tables.\n" );
678 $this->db->query(
679 "LOCK TABLES $page WRITE, $revision WRITE, $old WRITE, $cur WRITE",
680 __METHOD__
681 );
682
683 $maxold = intval( $this->db->selectField( 'old', 'max(old_id)', '', __METHOD__ ) );
684 $this->output( wfTimestamp( TS_DB ) );
685 $this->output( "......maxold is {$maxold}\n" );
686
687 $this->output( wfTimestamp( TS_DB ) );
690 // Create HistoryBlobCurStub entries.
691 // Text will be pulled from the leftover 'cur' table at runtime.
692 $this->output( "......Moving metadata from cur; using blob references to text in cur table.\n" );
693 $cur_text = "concat('O:18:\"historyblobcurstub\":1:{s:6:\"mCurId\";i:',cur_id,';}')";
694 $cur_flags = "'object'";
695 } else {
696 // Copy all cur text in immediately: this may take longer but avoids
697 // having to keep an extra table around.
698 $this->output( "......Moving text from cur.\n" );
699 $cur_text = 'cur_text';
700 $cur_flags = "''";
701 }
702 $this->db->query(
703 "INSERT INTO $old (old_namespace, old_title, old_text, old_comment, old_user,
704 old_user_text, old_timestamp, old_minor_edit, old_flags)
705 SELECT cur_namespace, cur_title, $cur_text, cur_comment, cur_user, cur_user_text,
706 cur_timestamp, cur_minor_edit, $cur_flags
707 FROM $cur",
708 __METHOD__
709 );
710
711 $this->output( wfTimestamp( TS_DB ) );
712 $this->output( "......Setting up revision table.\n" );
713 $this->db->query(
714 "INSERT INTO $revision (rev_id, rev_page, rev_comment, rev_user,
715 rev_user_text, rev_timestamp, rev_minor_edit)
716 SELECT old_id, cur_id, old_comment, old_user, old_user_text,
717 old_timestamp, old_minor_edit
718 FROM $old,$cur WHERE old_namespace=cur_namespace AND old_title=cur_title",
719 __METHOD__
720 );
721
722 $this->output( wfTimestamp( TS_DB ) );
723 $this->output( "......Setting up page table.\n" );
724 $this->db->query(
725 "INSERT INTO $page (page_id, page_namespace, page_title,
726 page_restrictions, page_is_redirect, page_is_new, page_random,
727 page_touched, page_latest, page_len)
728 SELECT cur_id, cur_namespace, cur_title, cur_restrictions,
729 cur_is_redirect, cur_is_new, cur_random, cur_touched, rev_id, LENGTH(cur_text)
730 FROM $cur,$revision
731 WHERE cur_id=rev_page AND rev_timestamp=cur_timestamp AND rev_id > {$maxold}",
732 __METHOD__
733 );
734
735 $this->output( wfTimestamp( TS_DB ) );
736 $this->output( "......Unlocking tables.\n" );
737 $this->db->query( "UNLOCK TABLES", __METHOD__ );
738
739 $this->output( wfTimestamp( TS_DB ) );
740 $this->output( "......Renaming old.\n" );
741 $this->db->query( "ALTER TABLE $old RENAME TO $text", __METHOD__ );
742
743 $this->output( wfTimestamp( TS_DB ) );
744 $this->output( "...done.\n" );
745 }
746
747 protected function doNamespaceSize() {
748 $tables = [
749 'page' => 'page',
750 'archive' => 'ar',
751 'recentchanges' => 'rc',
752 'watchlist' => 'wl',
753 'querycache' => 'qc',
754 'logging' => 'log',
755 ];
756 foreach ( $tables as $table => $prefix ) {
757 $field = $prefix . '_namespace';
758
759 $tablename = $this->db->tableName( $table );
760 $result = $this->db->query( "SHOW COLUMNS FROM $tablename LIKE '$field'", __METHOD__ );
761 $info = $this->db->fetchObject( $result );
762
763 if ( substr( $info->Type, 0, 3 ) == 'int' ) {
764 $this->output( "...$field is already a full int ($info->Type).\n" );
765 } else {
766 $this->output( "Promoting $field from $info->Type to int... " );
767 $this->db->query( "ALTER TABLE $tablename MODIFY $field int NOT NULL", __METHOD__ );
768 $this->output( "done.\n" );
769 }
770 }
771 }
772
773 protected function doPagelinksUpdate() {
774 if ( $this->db->tableExists( 'pagelinks', __METHOD__ ) ) {
775 $this->output( "...already have pagelinks table.\n" );
776
777 return;
778 }
779
780 $this->applyPatch(
781 'patch-pagelinks.sql',
782 false,
783 'Converting links and brokenlinks tables to pagelinks'
784 );
785
786 foreach (
787 MediaWikiServices::getInstance()->getContentLanguage()->getNamespaces() as $ns => $name
788 ) {
789 if ( $ns == 0 ) {
790 continue;
791 }
792
793 $this->output( "Cleaning up broken links for namespace $ns... " );
794 $this->db->update( 'pagelinks',
795 [
796 'pl_namespace' => $ns,
797 "pl_title = TRIM(LEADING {$this->db->addQuotes( "$name:" )} FROM pl_title)",
798 ],
799 [
800 'pl_namespace' => 0,
801 'pl_title' . $this->db->buildLike( "$name:", $this->db->anyString() ),
802 ],
803 __METHOD__
804 );
805 $this->output( "done.\n" );
806 }
807 }
808
809 protected function doUserUniqueUpdate() {
810 if ( !$this->doTable( 'user' ) ) {
811 return true;
812 }
813
814 $duper = new UserDupes( $this->db, [ $this, 'output' ] );
815 if ( $duper->hasUniqueIndex() ) {
816 $this->output( "...already have unique user_name index.\n" );
817
818 return;
819 }
820
821 if ( !$duper->clearDupes() ) {
822 $this->output( "WARNING: This next step will probably fail due to unfixed duplicates...\n" );
823 }
824 $this->applyPatch( 'patch-user_nameindex.sql', false, "Adding unique index on user_name" );
825 }
826
827 protected function doUserGroupsUpdate() {
828 if ( !$this->doTable( 'user_groups' ) ) {
829 return true;
830 }
831
832 if ( $this->db->tableExists( 'user_groups', __METHOD__ ) ) {
833 $info = $this->db->fieldInfo( 'user_groups', 'ug_group' );
834 if ( $info->type() == 'int' ) {
835 $oldug = $this->db->tableName( 'user_groups' );
836 $newug = $this->db->tableName( 'user_groups_bogus' );
837 $this->output( "user_groups table exists but is in bogus intermediate " .
838 "format. Renaming to $newug... " );
839 $this->db->query( "ALTER TABLE $oldug RENAME TO $newug", __METHOD__ );
840 $this->output( "done.\n" );
841
842 $this->applyPatch( 'patch-user_groups.sql', false, "Re-adding fresh user_groups table" );
843
844 $this->output( "***\n" );
845 $this->output( "*** WARNING: You will need to manually fix up user " .
846 "permissions in the user_groups\n" );
847 $this->output( "*** table. Old 1.5 alpha versions did some pretty funky stuff...\n" );
848 $this->output( "***\n" );
849 } else {
850 $this->output( "...user_groups table exists and is in current format.\n" );
851 }
852
853 return;
854 }
855
856 $this->applyPatch( 'patch-user_groups.sql', false, "Adding user_groups table" );
857
858 if ( !$this->db->tableExists( 'user_rights', __METHOD__ ) ) {
859 if ( $this->db->fieldExists( 'user', 'user_rights', __METHOD__ ) ) {
860 $this->applyPatch(
861 'patch-user_rights.sql',
862 false,
863 'Upgrading from a 1.3 or older database? Breaking out user_rights for conversion'
864 );
865 } else {
866 $this->output( "*** WARNING: couldn't locate user_rights table or field for upgrade.\n" );
867 $this->output( "*** You may need to manually configure some sysops by manipulating\n" );
868 $this->output( "*** the user_groups table.\n" );
869
870 return;
871 }
872 }
873
874 $this->output( "Converting user_rights table to user_groups... " );
875 $result = $this->db->select( 'user_rights',
876 [ 'ur_user', 'ur_rights' ],
877 [ "ur_rights != ''" ],
878 __METHOD__ );
879
880 foreach ( $result as $row ) {
881 $groups = array_unique(
882 array_map( 'trim',
883 explode( ',', $row->ur_rights ) ) );
884
885 foreach ( $groups as $group ) {
886 $this->db->insert( 'user_groups',
887 [
888 'ug_user' => $row->ur_user,
889 'ug_group' => $group ],
890 __METHOD__ );
891 }
892 }
893 $this->output( "done.\n" );
894 }
895
900 protected function doWatchlistNull() {
901 $info = $this->db->fieldInfo( 'watchlist', 'wl_notificationtimestamp' );
902 if ( !$info ) {
903 return;
904 }
905 if ( $info->isNullable() ) {
906 $this->output( "...wl_notificationtimestamp is already nullable.\n" );
907
908 return;
909 }
910
911 $this->applyPatch(
912 'patch-watchlist-null.sql',
913 false,
914 'Making wl_notificationtimestamp nullable'
915 );
916 }
917
923 protected function doPageRandomUpdate() {
924 $page = $this->db->tableName( 'page' );
925 $this->db->query( "UPDATE $page SET page_random = RAND() WHERE page_random = 0", __METHOD__ );
926 $rows = $this->db->affectedRows();
927
928 if ( $rows ) {
929 $this->output( "Set page_random to a random value on $rows rows where it was set to 0\n" );
930 } else {
931 $this->output( "...no page_random rows needed to be set\n" );
932 }
933 }
934
935 protected function doTemplatelinksUpdate() {
936 if ( $this->db->tableExists( 'templatelinks', __METHOD__ ) ) {
937 $this->output( "...templatelinks table already exists\n" );
938
939 return;
940 }
941
942 $this->applyPatch( 'patch-templatelinks.sql', false, "Creating templatelinks table" );
943
944 $this->output( "Populating...\n" );
945 $services = MediaWikiServices::getInstance();
946 if ( $services->getDBLoadBalancer()->getServerCount() > 1 ) {
947 // Slow, replication-friendly update
948 $res = $this->db->select( 'pagelinks', [ 'pl_from', 'pl_namespace', 'pl_title' ],
949 [ 'pl_namespace' => NS_TEMPLATE ], __METHOD__ );
950 $count = 0;
951 foreach ( $res as $row ) {
952 $count = ( $count + 1 ) % 100;
953 if ( $count == 0 ) {
954 $lbFactory = $services->getDBLoadBalancerFactory();
955 $lbFactory->waitForReplication( [
956 'domain' => $lbFactory->getLocalDomainID(),
958 ] );
959 }
960 $this->db->insert( 'templatelinks',
961 [
962 'tl_from' => $row->pl_from,
963 'tl_namespace' => $row->pl_namespace,
964 'tl_title' => $row->pl_title,
965 ], __METHOD__
966 );
967 }
968 } else {
969 // Fast update
970 $this->db->insertSelect( 'templatelinks', 'pagelinks',
971 [
972 'tl_from' => 'pl_from',
973 'tl_namespace' => 'pl_namespace',
974 'tl_title' => 'pl_title'
975 ], [
976 'pl_namespace' => 10
977 ], __METHOD__,
978 [ 'NO_AUTO_COLUMNS' ] // There's no "tl_id" auto-increment field
979 );
980 }
981 $this->output( "Done. Please run maintenance/refreshLinks.php for a more " .
982 "thorough templatelinks update.\n" );
983 }
984
985 protected function doBacklinkingIndicesUpdate() {
986 if ( !$this->indexHasField( 'pagelinks', 'pl_namespace', 'pl_from' ) ||
987 !$this->indexHasField( 'templatelinks', 'tl_namespace', 'tl_from' ) ||
988 !$this->indexHasField( 'imagelinks', 'il_to', 'il_from' )
989 ) {
990 $this->applyPatch( 'patch-backlinkindexes.sql', false, "Updating backlinking indices" );
991 }
992 }
993
999 protected function doRestrictionsUpdate() {
1000 if ( $this->db->tableExists( 'page_restrictions', __METHOD__ ) ) {
1001 $this->output( "...page_restrictions table already exists.\n" );
1002
1003 return;
1004 }
1005
1006 $this->applyPatch(
1007 'patch-page_restrictions.sql',
1008 false,
1009 'Creating page_restrictions table (1/2)'
1010 );
1011 $this->applyPatch(
1012 'patch-page_restrictions_sortkey.sql',
1013 false,
1014 'Creating page_restrictions table (2/2)'
1015 );
1016 $this->output( "done.\n" );
1017
1018 $this->output( "Migrating old restrictions to new table...\n" );
1019 $task = $this->maintenance->runChild( UpdateRestrictions::class );
1020 $task->execute();
1021 }
1022
1023 protected function doCategorylinksIndicesUpdate() {
1024 if ( !$this->indexHasField( 'categorylinks', 'cl_sortkey', 'cl_from' ) ) {
1025 $this->applyPatch( 'patch-categorylinksindex.sql', false, "Updating categorylinks Indices" );
1026 }
1027 }
1028
1029 protected function doCategoryPopulation() {
1030 if ( $this->updateRowExists( 'populate category' ) ) {
1031 $this->output( "...category table already populated.\n" );
1032
1033 return;
1034 }
1035
1036 $this->output(
1037 "Populating category table, printing progress markers. " .
1038 "For large databases, you\n" .
1039 "may want to hit Ctrl-C and do this manually with maintenance/\n" .
1040 "populateCategory.php.\n"
1041 );
1042 $task = $this->maintenance->runChild( PopulateCategory::class );
1043 $task->execute();
1044 $this->output( "Done populating category table.\n" );
1045 }
1046
1047 protected function doPopulateParentId() {
1048 if ( !$this->updateRowExists( 'populate rev_parent_id' ) ) {
1049 $this->output(
1050 "Populating rev_parent_id fields, printing progress markers. For large\n" .
1051 "databases, you may want to hit Ctrl-C and do this manually with\n" .
1052 "maintenance/populateParentId.php.\n" );
1053
1054 $task = $this->maintenance->runChild( PopulateParentId::class );
1055 $task->execute();
1056 }
1057 }
1058
1059 protected function doMaybeProfilingMemoryUpdate() {
1060 if ( !$this->doTable( 'profiling' ) ) {
1061 return true;
1062 }
1063
1064 if ( !$this->db->tableExists( 'profiling', __METHOD__ ) ) {
1065 return true;
1066 } elseif ( $this->db->fieldExists( 'profiling', 'pf_memory', __METHOD__ ) ) {
1067 $this->output( "...profiling table has pf_memory field.\n" );
1068
1069 return true;
1070 }
1071
1072 return $this->applyPatch(
1073 'patch-profiling-memory.sql',
1074 false,
1075 'Adding pf_memory field to table profiling'
1076 );
1077 }
1078
1079 protected function doFilearchiveIndicesUpdate() {
1080 $info = $this->db->indexInfo( 'filearchive', 'fa_user_timestamp', __METHOD__ );
1081 if ( !$info ) {
1082 $this->applyPatch( 'patch-filearchive-user-index.sql', false, "Updating filearchive indices" );
1083 }
1084
1085 return true;
1086 }
1087
1088 protected function doNonUniquePlTlIl() {
1089 $info = $this->db->indexInfo( 'pagelinks', 'pl_namespace' );
1090 if ( is_array( $info ) && $info[0]->Non_unique ) {
1091 $this->output( "...pl_namespace, tl_namespace, il_to indices are already non-UNIQUE.\n" );
1092
1093 return true;
1094 }
1095 if ( $this->skipSchema ) {
1096 $this->output( "...skipping schema change (making pl_namespace, tl_namespace " .
1097 "and il_to indices non-UNIQUE).\n" );
1098
1099 return false;
1100 }
1101
1102 return $this->applyPatch(
1103 'patch-pl-tl-il-nonunique.sql',
1104 false,
1105 'Making pl_namespace, tl_namespace and il_to indices non-UNIQUE'
1106 );
1107 }
1108
1109 protected function doUpdateMimeMinorField() {
1110 if ( $this->updateRowExists( 'mime_minor_length' ) ) {
1111 $this->output( "...*_mime_minor fields are already long enough.\n" );
1112
1113 return;
1114 }
1115
1116 $this->applyPatch(
1117 'patch-mime_minor_length.sql',
1118 false,
1119 'Altering all *_mime_minor fields to 100 bytes in size'
1120 );
1121 }
1122
1123 protected function doClFieldsUpdate() {
1124 if ( $this->updateRowExists( 'cl_fields_update' ) ) {
1125 $this->output( "...categorylinks up-to-date.\n" );
1126
1127 return;
1128 }
1129
1130 $this->applyPatch(
1131 'patch-categorylinks-better-collation2.sql',
1132 false,
1133 'Updating categorylinks (again)'
1134 );
1135 }
1136
1137 protected function doLangLinksLengthUpdate() {
1138 $langlinks = $this->db->tableName( 'langlinks' );
1139 $res = $this->db->query( "SHOW COLUMNS FROM $langlinks LIKE 'll_lang'" );
1140 $row = $this->db->fetchObject( $res );
1141
1142 if ( $row && $row->Type == "varbinary(10)" ) {
1143 $this->applyPatch(
1144 'patch-langlinks-ll_lang-20.sql',
1145 false,
1146 'Updating length of ll_lang in langlinks'
1147 );
1148 } else {
1149 $this->output( "...ll_lang is up-to-date.\n" );
1150 }
1151 }
1152
1153 protected function doUserNewTalkTimestampNotNull() {
1154 if ( !$this->doTable( 'user_newtalk' ) ) {
1155 return true;
1156 }
1157
1158 $info = $this->db->fieldInfo( 'user_newtalk', 'user_last_timestamp' );
1159 if ( $info === false ) {
1160 return;
1161 }
1162 if ( $info->isNullable() ) {
1163 $this->output( "...user_last_timestamp is already nullable.\n" );
1164
1165 return;
1166 }
1167
1168 $this->applyPatch(
1169 'patch-user-newtalk-timestamp-null.sql',
1170 false,
1171 'Making user_last_timestamp nullable'
1172 );
1173 }
1174
1175 protected function doIwlinksIndexNonUnique() {
1176 $info = $this->db->indexInfo( 'iwlinks', 'iwl_prefix_title_from' );
1177 if ( is_array( $info ) && $info[0]->Non_unique ) {
1178 $this->output( "...iwl_prefix_title_from index is already non-UNIQUE.\n" );
1179
1180 return true;
1181 }
1182 if ( $this->skipSchema ) {
1183 $this->output( "...skipping schema change (making iwl_prefix_title_from index non-UNIQUE).\n" );
1184
1185 return false;
1186 }
1187
1188 return $this->applyPatch(
1189 'patch-iwl_prefix_title_from-non-unique.sql',
1190 false,
1191 'Making iwl_prefix_title_from index non-UNIQUE'
1192 );
1193 }
1194
1195 protected function doUnsignedSyncronisation() {
1196 $sync = [
1197 [ 'table' => 'bot_passwords', 'field' => 'bp_user' ],
1198 [ 'table' => 'change_tag', 'field' => 'ct_log_id' ],
1199 [ 'table' => 'change_tag', 'field' => 'ct_rev_id' ],
1200 [ 'table' => 'page_restrictions', 'field' => 'pr_user' ],
1201 [ 'table' => 'tag_summary', 'field' => 'ts_log_id' ],
1202 [ 'table' => 'tag_summary', 'field' => 'ts_rev_id' ],
1203 [ 'table' => 'user_newtalk', 'field' => 'user_id' ],
1204 [ 'table' => 'user_properties', 'field' => 'up_user' ],
1205 ];
1206
1207 foreach ( $sync as $s ) {
1208 if ( !$this->doTable( $s['table'] ) ) {
1209 continue;
1210 }
1211
1212 $info = $this->db->fieldInfo( $s['table'], $s['field'] );
1213 if ( $info === false ) {
1214 continue;
1215 }
1216 $fullName = "{$s['table']}.{$s['field']}";
1217 if ( $info->isUnsigned() ) {
1218 $this->output( "...$fullName is already unsigned int.\n" );
1219
1220 continue;
1221 }
1222
1223 $this->applyPatch(
1224 "patch-{$s['table']}-{$s['field']}-unsigned.sql",
1225 false,
1226 "Making $fullName into an unsigned int"
1227 );
1228 }
1229
1230 return true;
1231 }
1232
1233 protected function doRevisionPageRevIndexNonUnique() {
1234 if ( !$this->doTable( 'revision' ) ) {
1235 return true;
1236 } elseif ( !$this->db->indexExists( 'revision', 'rev_page_id' ) ) {
1237 $this->output( "...rev_page_id index not found on revision.\n" );
1238 return true;
1239 }
1240
1241 if ( !$this->db->indexUnique( 'revision', 'rev_page_id' ) ) {
1242 $this->output( "...rev_page_id index already non-unique.\n" );
1243 return true;
1244 }
1245
1246 return $this->applyPatch(
1247 'patch-revision-page-rev-index-nonunique.sql',
1248 false,
1249 'Making rev_page_id index non-unique'
1250 );
1251 }
1252
1253 protected function doExtendCommentLengths() {
1254 $table = $this->db->tableName( 'revision' );
1255 $res = $this->db->query( "SHOW COLUMNS FROM $table LIKE 'rev_comment'" );
1256 $row = $this->db->fetchObject( $res );
1257
1258 if ( $row && ( $row->Type !== "varbinary(767)" || $row->Default !== "" ) ) {
1259 $this->applyPatch(
1260 'patch-editsummary-length.sql',
1261 false,
1262 'Extending edit summary lengths (and setting defaults)'
1263 );
1264 } else {
1265 $this->output( "...comment fields are up to date.\n" );
1266 }
1267 }
1268
1269 public function getSchemaVars() {
1270 global $wgDBTableOptions;
1271
1272 $vars = [];
1273 $vars['wgDBTableOptions'] = str_replace( 'TYPE', 'ENGINE', $wgDBTableOptions );
1274 $vars['wgDBTableOptions'] = str_replace(
1275 'CHARSET=mysql4',
1276 'CHARSET=binary',
1277 $vars['wgDBTableOptions']
1278 );
1279
1280 return $vars;
1281 }
1282}
Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for use
$wgLegacySchemaConversion
If set to true, the MediaWiki 1.4 to 1.5 schema conversion will create stub reference rows in the tex...
$wgDBTableOptions
MySQL table options to use during installation or update.
wfTimestamp( $outputtype=TS_UNIX, $ts=0)
Get a timestamp string in one of various formats.
$IP
Definition WebStart.php:41
Class for handling database updates.
updateRowExists( $key)
Helper function: check if the given key is present in the updatelog table.
output( $str)
Output some text.
applyPatch( $path, $isFullPath=false, $msg=null)
Applies a SQL patch.
doTable( $name)
Returns whether updates should be executed on the database table $name.
MediaWiki exception.
MediaWikiServices is the service locator for the application scope of MediaWiki.
Mysql update list and mysql-specific update functions.
doWatchlistNull()
Make sure wl_notificationtimestamp can be NULL, and update old broken items.
doInterwikiUpdate()
Check that interwiki table exists; if it doesn't source it.
getSchemaVars()
Get appropriate schema variables in the current database connection.
doRestrictionsUpdate()
Adding page_restrictions table, obsoleting page.page_restrictions.
checkBin( $table, $field, $patchFile)
1.4 betas were missing the 'binary' marker from logging.log_title, which causes a collation mismatch ...
doIndexUpdate()
Check that proper indexes are in place.
getCoreUpdateList()
Get an array of updates to perform on the database.
doRevisionPageRevIndexNonUnique()
indexHasField( $table, $index, $field)
Check whether an index contain a field.
doPageRandomUpdate()
Set page_random field to a random value where it is equals to 0.
doWatchlistUpdate()
Check if we need to add talk page rows to the watchlist.
doUserNewTalkTimestampNotNull()
Look for duplicate user table entries and optionally prune them.
Definition userDupes.inc:35
$res
Definition database.txt:21
deferred txt A few of the database updates required by various functions here can be deferred until after the result page is displayed to the user For updating the view updating the linked to tables after a etc PHP does not yet have any way to tell the server to actually return and disconnect while still running these but it might have such a feature in the future We handle these by creating a deferred update object and putting those objects on a global list
Definition deferred.txt:11
This document is intended to provide useful advice for parties seeking to redistribute MediaWiki to end users It s targeted particularly at maintainers for Linux since it s been observed that distribution packages of MediaWiki often break We ve consistently had to recommend that users seeking support use official tarballs instead of their distribution s and this often solves whatever problem the user is having It would be nice if this could such as
const NS_TEMPLATE
Definition Defines.php:74
static configuration should be added through ResourceLoaderGetConfigVars instead & $vars
Definition hooks.txt:2278
do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow(e.g. with the RejectParserCacheValue hook) because MediaWiki won 't do it for you. & $defaults also a ContextSource after deleting those rows but within the same transaction $rows
Definition hooks.txt:2857
The index of the header message $result[1]=The index of the body text message $result[2 through n]=Parameters passed to body text message. Please note the header message cannot receive/use parameters. 'ImgAuthModifyHeaders':Executed just before a file is streamed to a user via img_auth.php, allowing headers to be modified beforehand. $title:LinkTarget object & $headers:HTTP headers(name=> value, names are case insensitive). Two headers get special handling:If-Modified-Since(value must be a valid HTTP date) and Range(must be of the form "bytes=(\d*-\d*)") will be honored when streaming the file. 'ImportHandleLogItemXMLTag':When parsing a XML tag in a log item. Return false to stop further processing of the tag $reader:XMLReader object $logInfo:Array of information 'ImportHandlePageXMLTag':When parsing a XML tag in a page. Return false to stop further processing of the tag $reader:XMLReader object & $pageInfo:Array of information 'ImportHandleRevisionXMLTag':When parsing a XML tag in a page revision. Return false to stop further processing of the tag $reader:XMLReader object $pageInfo:Array of page information $revisionInfo:Array of revision information 'ImportHandleToplevelXMLTag':When parsing a top level XML tag. Return false to stop further processing of the tag $reader:XMLReader object 'ImportHandleUnknownUser':When a user doesn 't exist locally, this hook is called to give extensions an opportunity to auto-create it. If the auto-creation is successful, return false. $name:User name 'ImportHandleUploadXMLTag':When parsing a XML tag in a file upload. Return false to stop further processing of the tag $reader:XMLReader object $revisionInfo:Array of information 'ImportLogInterwikiLink':Hook to change the interwiki link used in log entries and edit summaries for transwiki imports. & $fullInterwikiPrefix:Interwiki prefix, may contain colons. & $pageTitle:String that contains page title. 'ImportSources':Called when reading from the $wgImportSources configuration variable. Can be used to lazy-load the import sources list. & $importSources:The value of $wgImportSources. Modify as necessary. See the comment in DefaultSettings.php for the detail of how to structure this array. 'InfoAction':When building information to display on the action=info page. $context:IContextSource object & $pageInfo:Array of information 'InitializeArticleMaybeRedirect':MediaWiki check to see if title is a redirect. & $title:Title object for the current page & $request:WebRequest & $ignoreRedirect:boolean to skip redirect check & $target:Title/string of redirect target & $article:Article object 'InternalParseBeforeLinks':during Parser 's internalParse method before links but after nowiki/noinclude/includeonly/onlyinclude and other processings. & $parser:Parser object & $text:string containing partially parsed text & $stripState:Parser 's internal StripState object 'InternalParseBeforeSanitize':during Parser 's internalParse method just before the parser removes unwanted/dangerous HTML tags and after nowiki/noinclude/includeonly/onlyinclude and other processings. Ideal for syntax-extensions after template/parser function execution which respect nowiki and HTML-comments. & $parser:Parser object & $text:string containing partially parsed text & $stripState:Parser 's internal StripState object 'InterwikiLoadPrefix':When resolving if a given prefix is an interwiki or not. Return true without providing an interwiki to continue interwiki search. $prefix:interwiki prefix we are looking for. & $iwData:output array describing the interwiki with keys iw_url, iw_local, iw_trans and optionally iw_api and iw_wikiid. 'InvalidateEmailComplete':Called after a user 's email has been invalidated successfully. $user:user(object) whose email is being invalidated 'IRCLineURL':When constructing the URL to use in an IRC notification. Callee may modify $url and $query, URL will be constructed as $url . $query & $url:URL to index.php & $query:Query string $rc:RecentChange object that triggered url generation 'IsFileCacheable':Override the result of Article::isFileCacheable()(if true) & $article:article(object) being checked 'IsTrustedProxy':Override the result of IP::isTrustedProxy() & $ip:IP being check & $result:Change this value to override the result of IP::isTrustedProxy() 'IsUploadAllowedFromUrl':Override the result of UploadFromUrl::isAllowedUrl() $url:URL used to upload from & $allowed:Boolean indicating if uploading is allowed for given URL 'isValidEmailAddr':Override the result of Sanitizer::validateEmail(), for instance to return false if the domain name doesn 't match your organization. $addr:The e-mail address entered by the user & $result:Set this and return false to override the internal checks 'isValidPassword':Override the result of User::isValidPassword() $password:The password entered by the user & $result:Set this and return false to override the internal checks $user:User the password is being validated for 'Language::getMessagesFileName':$code:The language code or the language we 're looking for a messages file for & $file:The messages file path, you can override this to change the location. 'LanguageGetMagic':DEPRECATED since 1.16! Use $magicWords in a file listed in $wgExtensionMessagesFiles instead. Use this to define synonyms of magic words depending of the language & $magicExtensions:associative array of magic words synonyms $lang:language code(string) 'LanguageGetNamespaces':Provide custom ordering for namespaces or remove namespaces. Do not use this hook to add namespaces. Use CanonicalNamespaces for that. & $namespaces:Array of namespaces indexed by their numbers 'LanguageGetSpecialPageAliases':DEPRECATED! Use $specialPageAliases in a file listed in $wgExtensionMessagesFiles instead. Use to define aliases of special pages names depending of the language & $specialPageAliases:associative array of magic words synonyms $lang:language code(string) 'LanguageGetTranslatedLanguageNames':Provide translated language names. & $names:array of language code=> language name $code:language of the preferred translations 'LanguageLinks':Manipulate a page 's language links. This is called in various places to allow extensions to define the effective language links for a page. $title:The page 's Title. & $links:Array with elements of the form "language:title" in the order that they will be output. & $linkFlags:Associative array mapping prefixed links to arrays of flags. Currently unused, but planned to provide support for marking individual language links in the UI, e.g. for featured articles. 'LanguageSelector':Hook to change the language selector available on a page. $out:The output page. $cssClassName:CSS class name of the language selector. 'LinkBegin':DEPRECATED since 1.28! Use HtmlPageLinkRendererBegin instead. Used when generating internal and interwiki links in Linker::link(), before processing starts. Return false to skip default processing and return $ret. See documentation for Linker::link() for details on the expected meanings of parameters. $skin:the Skin object $target:the Title that the link is pointing to & $html:the contents that the< a > tag should have(raw HTML) $result
Definition hooks.txt:2042
this hook is for auditing only RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist & $tables
Definition hooks.txt:1035
static configuration should be added through ResourceLoaderGetConfigVars instead can be used to get the real title e g db for database replication lag or jobqueue for job queue size converted to pseudo seconds It is possible to add more fields and they will be returned to the user in the API response after the basic globals have been set but before ordinary actions take place or wrap services the preferred way to define a new service is the $wgServiceWiringFiles array $services
Definition hooks.txt:2335
Allows to change the fields on the form that will be generated $name
Definition hooks.txt:302
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency which acts as the top level factory for services in MediaWiki which can be used to gain access to default instances of various services MediaWikiServices however also allows new services to be defined and default services to be redefined Services are defined or redefined by providing a callback the instantiator that will return a new instance of the service When it will create an instance of MediaWikiServices and populate it with the services defined in the files listed by thereby bootstrapping the DI framework Per $wgServiceWiringFiles lists includes ServiceWiring php
Definition injection.txt:37
Basic database interface for live and lazy-loaded relation database handles.
Definition IDatabase.php:38
linkcache txt The LinkCache class maintains a list of article titles and the information about whether or not the article exists in the database This is used to mark up links when displaying a page If the same link appears more than once on any page then it only has to be looked up once In most cases link lookups are done in batches with the LinkBatch class or the equivalent in so the link cache is mostly useful for short snippets of parsed and for links in the navigation areas of the skin The link cache was formerly used to track links used in a document for the purposes of updating the link tables This application is now deprecated To create a you can use the following $titles
Definition linkcache.txt:17