MediaWiki  1.32.5
PostgresUpdater.php
Go to the documentation of this file.
1 <?php
24 use Wikimedia\Rdbms\DatabasePostgres;
25 
32 class PostgresUpdater extends DatabaseUpdater {
33 
37  protected $db;
38 
44  protected function getCoreUpdateList() {
45  return [
46  # rename tables 1.7.3
47  # r15791 Change reserved word table names "user" and "text"
48  [ 'renameTable', 'user', 'mwuser' ],
49  [ 'renameTable', 'text', 'pagecontent' ],
50  [ 'renameIndex', 'mwuser', 'user_pkey', 'mwuser_pkey' ],
51  [ 'renameIndex', 'mwuser', 'user_user_name_key', 'mwuser_user_name_key' ],
52  [ 'renameIndex', 'pagecontent', 'text_pkey', 'pagecontent_pkey' ],
53 
54  # renamed sequences
55  [ 'renameSequence', 'ipblocks_ipb_id_val', 'ipblocks_ipb_id_seq' ],
56  [ 'renameSequence', 'rev_rev_id_val', 'revision_rev_id_seq' ],
57  [ 'renameSequence', 'text_old_id_val', 'text_old_id_seq' ],
58  [ 'renameSequence', 'rc_rc_id_seq', 'recentchanges_rc_id_seq' ],
59  [ 'renameSequence', 'log_log_id_seq', 'logging_log_id_seq' ],
60  [ 'renameSequence', 'pr_id_val', 'page_restrictions_pr_id_seq' ],
61  [ 'renameSequence', 'us_id_seq', 'uploadstash_us_id_seq' ],
62 
63  # since r58263
64  [ 'renameSequence', 'category_id_seq', 'category_cat_id_seq' ],
65 
66  # new sequences if not renamed above
67  [ 'addSequence', 'logging', false, 'logging_log_id_seq' ],
68  [ 'addSequence', 'page_restrictions', false, 'page_restrictions_pr_id_seq' ],
69  [ 'addSequence', 'filearchive', 'fa_id', 'filearchive_fa_id_seq' ],
70  [ 'addSequence', 'archive', false, 'archive_ar_id_seq' ],
71  [ 'addSequence', 'externallinks', false, 'externallinks_el_id_seq' ],
72  [ 'addSequence', 'watchlist', false, 'watchlist_wl_id_seq' ],
73  [ 'addSequence', 'change_tag', false, 'change_tag_ct_id_seq' ],
74  [ 'addSequence', 'tag_summary', false, 'tag_summary_ts_id_seq' ],
75 
76  # new tables
77  [ 'addTable', 'category', 'patch-category.sql' ],
78  [ 'addTable', 'page', 'patch-page.sql' ],
79  [ 'addTable', 'querycachetwo', 'patch-querycachetwo.sql' ],
80  [ 'addTable', 'page_props', 'patch-page_props.sql' ],
81  [ 'addTable', 'page_restrictions', 'patch-page_restrictions.sql' ],
82  [ 'addTable', 'profiling', 'patch-profiling.sql' ],
83  [ 'addTable', 'protected_titles', 'patch-protected_titles.sql' ],
84  [ 'addTable', 'redirect', 'patch-redirect.sql' ],
85  [ 'addTable', 'updatelog', 'patch-updatelog.sql' ],
86  [ 'addTable', 'change_tag', 'patch-change_tag.sql' ],
87  [ 'addTable', 'tag_summary', 'patch-tag_summary.sql' ],
88  [ 'addTable', 'valid_tag', 'patch-valid_tag.sql' ],
89  [ 'addTable', 'user_properties', 'patch-user_properties.sql' ],
90  [ 'addTable', 'log_search', 'patch-log_search.sql' ],
91  [ 'addTable', 'l10n_cache', 'patch-l10n_cache.sql' ],
92  [ 'addTable', 'iwlinks', 'patch-iwlinks.sql' ],
93  [ 'addTable', 'module_deps', 'patch-module_deps.sql' ],
94  [ 'addTable', 'uploadstash', 'patch-uploadstash.sql' ],
95  [ 'addTable', 'user_former_groups', 'patch-user_former_groups.sql' ],
96  [ 'addTable', 'sites', 'patch-sites.sql' ],
97  [ 'addTable', 'bot_passwords', 'patch-bot_passwords.sql' ],
98 
99  # Needed before new field
100  [ 'convertArchive2' ],
101 
102  # new fields
103  [ 'addPgField', 'updatelog', 'ul_value', 'TEXT' ],
104  [ 'addPgField', 'archive', 'ar_deleted', 'SMALLINT NOT NULL DEFAULT 0' ],
105  [ 'addPgField', 'archive', 'ar_len', 'INTEGER' ],
106  [ 'addPgField', 'archive', 'ar_page_id', 'INTEGER' ],
107  [ 'addPgField', 'archive', 'ar_parent_id', 'INTEGER' ],
108  [ 'addPgField', 'archive', 'ar_content_model', 'TEXT' ],
109  [ 'addPgField', 'archive', 'ar_content_format', 'TEXT' ],
110  [ 'addPgField', 'categorylinks', 'cl_sortkey_prefix', "TEXT NOT NULL DEFAULT ''" ],
111  [ 'addPgField', 'categorylinks', 'cl_collation', "TEXT NOT NULL DEFAULT 0" ],
112  [ 'addPgField', 'categorylinks', 'cl_type', "TEXT NOT NULL DEFAULT 'page'" ],
113  [ 'addPgField', 'image', 'img_sha1', "TEXT NOT NULL DEFAULT ''" ],
114  [ 'addPgField', 'ipblocks', 'ipb_allow_usertalk', 'SMALLINT NOT NULL DEFAULT 0' ],
115  [ 'addPgField', 'ipblocks', 'ipb_anon_only', 'SMALLINT NOT NULL DEFAULT 0' ],
116  [ 'addPgField', 'ipblocks', 'ipb_by_text', "TEXT NOT NULL DEFAULT ''" ],
117  [ 'addPgField', 'ipblocks', 'ipb_block_email', 'SMALLINT NOT NULL DEFAULT 0' ],
118  [ 'addPgField', 'ipblocks', 'ipb_create_account', 'SMALLINT NOT NULL DEFAULT 1' ],
119  [ 'addPgField', 'ipblocks', 'ipb_deleted', 'SMALLINT NOT NULL DEFAULT 0' ],
120  [ 'addPgField', 'ipblocks', 'ipb_enable_autoblock', 'SMALLINT NOT NULL DEFAULT 1' ],
121  [ 'addPgField', 'ipblocks', 'ipb_parent_block_id',
122  'INTEGER DEFAULT NULL REFERENCES ipblocks(ipb_id) ' .
123  'ON DELETE SET NULL DEFERRABLE INITIALLY DEFERRED' ],
124  [ 'addPgField', 'filearchive', 'fa_deleted', 'SMALLINT NOT NULL DEFAULT 0' ],
125  [ 'addPgField', 'filearchive', 'fa_sha1', "TEXT NOT NULL DEFAULT ''" ],
126  [ 'addPgField', 'logging', 'log_deleted', 'SMALLINT NOT NULL DEFAULT 0' ],
127  [ 'addPgField', 'logging', 'log_id',
128  "INTEGER NOT NULL PRIMARY KEY DEFAULT nextval('logging_log_id_seq')" ],
129  [ 'addPgField', 'logging', 'log_params', 'TEXT' ],
130  [ 'addPgField', 'mwuser', 'user_editcount', 'INTEGER' ],
131  [ 'addPgField', 'mwuser', 'user_newpass_time', 'TIMESTAMPTZ' ],
132  [ 'addPgField', 'oldimage', 'oi_deleted', 'SMALLINT NOT NULL DEFAULT 0' ],
133  [ 'addPgField', 'oldimage', 'oi_major_mime', "TEXT NOT NULL DEFAULT 'unknown'" ],
134  [ 'addPgField', 'oldimage', 'oi_media_type', 'TEXT' ],
135  [ 'addPgField', 'oldimage', 'oi_metadata', "BYTEA NOT NULL DEFAULT ''" ],
136  [ 'addPgField', 'oldimage', 'oi_minor_mime', "TEXT NOT NULL DEFAULT 'unknown'" ],
137  [ 'addPgField', 'oldimage', 'oi_sha1', "TEXT NOT NULL DEFAULT ''" ],
138  [ 'addPgField', 'page', 'page_content_model', 'TEXT' ],
139  [ 'addPgField', 'page_restrictions', 'pr_id',
140  "INTEGER NOT NULL UNIQUE DEFAULT nextval('page_restrictions_pr_id_seq')" ],
141  [ 'addPgField', 'profiling', 'pf_memory', 'NUMERIC(18,10) NOT NULL DEFAULT 0' ],
142  [ 'addPgField', 'recentchanges', 'rc_deleted', 'SMALLINT NOT NULL DEFAULT 0' ],
143  [ 'addPgField', 'recentchanges', 'rc_log_action', 'TEXT' ],
144  [ 'addPgField', 'recentchanges', 'rc_log_type', 'TEXT' ],
145  [ 'addPgField', 'recentchanges', 'rc_logid', 'INTEGER NOT NULL DEFAULT 0' ],
146  [ 'addPgField', 'recentchanges', 'rc_new_len', 'INTEGER' ],
147  [ 'addPgField', 'recentchanges', 'rc_old_len', 'INTEGER' ],
148  [ 'addPgField', 'recentchanges', 'rc_params', 'TEXT' ],
149  [ 'addPgField', 'redirect', 'rd_interwiki', 'TEXT NULL' ],
150  [ 'addPgField', 'redirect', 'rd_fragment', 'TEXT NULL' ],
151  [ 'addPgField', 'revision', 'rev_deleted', 'SMALLINT NOT NULL DEFAULT 0' ],
152  [ 'addPgField', 'revision', 'rev_len', 'INTEGER' ],
153  [ 'addPgField', 'revision', 'rev_parent_id', 'INTEGER DEFAULT NULL' ],
154  [ 'addPgField', 'revision', 'rev_content_model', 'TEXT' ],
155  [ 'addPgField', 'revision', 'rev_content_format', 'TEXT' ],
156  [ 'addPgField', 'site_stats', 'ss_active_users', "INTEGER DEFAULT '-1'" ],
157  [ 'addPgField', 'user_newtalk', 'user_last_timestamp', 'TIMESTAMPTZ' ],
158  [ 'addPgField', 'logging', 'log_user_text', "TEXT NOT NULL DEFAULT ''" ],
159  [ 'addPgField', 'logging', 'log_page', 'INTEGER' ],
160  [ 'addPgField', 'interwiki', 'iw_api', "TEXT NOT NULL DEFAULT ''" ],
161  [ 'addPgField', 'interwiki', 'iw_wikiid', "TEXT NOT NULL DEFAULT ''" ],
162  [ 'addPgField', 'revision', 'rev_sha1', "TEXT NOT NULL DEFAULT ''" ],
163  [ 'addPgField', 'archive', 'ar_sha1', "TEXT NOT NULL DEFAULT ''" ],
164  [ 'addPgField', 'uploadstash', 'us_chunk_inx', "INTEGER NULL" ],
165  [ 'addPgField', 'job', 'job_timestamp', "TIMESTAMPTZ" ],
166  [ 'addPgField', 'job', 'job_random', "INTEGER NOT NULL DEFAULT 0" ],
167  [ 'addPgField', 'job', 'job_attempts', "INTEGER NOT NULL DEFAULT 0" ],
168  [ 'addPgField', 'job', 'job_token', "TEXT NOT NULL DEFAULT ''" ],
169  [ 'addPgField', 'job', 'job_token_timestamp', "TIMESTAMPTZ" ],
170  [ 'addPgField', 'job', 'job_sha1', "TEXT NOT NULL DEFAULT ''" ],
171  [ 'addPgField', 'archive', 'ar_id',
172  "INTEGER NOT NULL PRIMARY KEY DEFAULT nextval('archive_ar_id_seq')" ],
173  [ 'addPgField', 'externallinks', 'el_id',
174  "INTEGER NOT NULL PRIMARY KEY DEFAULT nextval('externallinks_el_id_seq')" ],
175  [ 'addPgField', 'uploadstash', 'us_props', "BYTEA" ],
176 
177  # type changes
178  [ 'changeField', 'archive', 'ar_deleted', 'smallint', '' ],
179  [ 'changeField', 'archive', 'ar_minor_edit', 'smallint',
180  'ar_minor_edit::smallint DEFAULT 0' ],
181  [ 'changeField', 'filearchive', 'fa_deleted', 'smallint', '' ],
182  [ 'changeField', 'filearchive', 'fa_height', 'integer', '' ],
183  [ 'changeField', 'filearchive', 'fa_metadata', 'bytea', "decode(fa_metadata,'escape')" ],
184  [ 'changeField', 'filearchive', 'fa_size', 'integer', '' ],
185  [ 'changeField', 'filearchive', 'fa_width', 'integer', '' ],
186  [ 'changeField', 'filearchive', 'fa_storage_group', 'text', '' ],
187  [ 'changeField', 'filearchive', 'fa_storage_key', 'text', '' ],
188  [ 'changeField', 'image', 'img_metadata', 'bytea', "decode(img_metadata,'escape')" ],
189  [ 'changeField', 'image', 'img_size', 'integer', '' ],
190  [ 'changeField', 'image', 'img_width', 'integer', '' ],
191  [ 'changeField', 'image', 'img_height', 'integer', '' ],
192  [ 'changeField', 'interwiki', 'iw_local', 'smallint', 'iw_local::smallint' ],
193  [ 'changeField', 'interwiki', 'iw_trans', 'smallint', 'iw_trans::smallint DEFAULT 0' ],
194  [ 'changeField', 'ipblocks', 'ipb_auto', 'smallint', 'ipb_auto::smallint DEFAULT 0' ],
195  [ 'changeField', 'ipblocks', 'ipb_anon_only', 'smallint',
196  "CASE WHEN ipb_anon_only=' ' THEN 0 ELSE ipb_anon_only::smallint END DEFAULT 0" ],
197  [ 'changeField', 'ipblocks', 'ipb_create_account', 'smallint',
198  "CASE WHEN ipb_create_account=' ' THEN 0 ELSE ipb_create_account::smallint END DEFAULT 1" ],
199  [ 'changeField', 'ipblocks', 'ipb_enable_autoblock', 'smallint',
200  "CASE WHEN ipb_enable_autoblock=' ' THEN 0 ELSE ipb_enable_autoblock::smallint END DEFAULT 1" ],
201  [ 'changeField', 'ipblocks', 'ipb_block_email', 'smallint',
202  "CASE WHEN ipb_block_email=' ' THEN 0 ELSE ipb_block_email::smallint END DEFAULT 0" ],
203  [ 'changeField', 'ipblocks', 'ipb_address', 'text', 'ipb_address::text' ],
204  [ 'changeField', 'ipblocks', 'ipb_deleted', 'smallint', 'ipb_deleted::smallint DEFAULT 0' ],
205  [ 'changeField', 'mwuser', 'user_token', 'text', '' ],
206  [ 'changeField', 'mwuser', 'user_email_token', 'text', '' ],
207  [ 'changeField', 'objectcache', 'keyname', 'text', '' ],
208  [ 'changeField', 'oldimage', 'oi_height', 'integer', '' ],
209  [ 'changeField', 'oldimage', 'oi_metadata', 'bytea', "decode(img_metadata,'escape')" ],
210  [ 'changeField', 'oldimage', 'oi_size', 'integer', '' ],
211  [ 'changeField', 'oldimage', 'oi_width', 'integer', '' ],
212  [ 'changeField', 'page', 'page_is_redirect', 'smallint',
213  'page_is_redirect::smallint DEFAULT 0' ],
214  [ 'changeField', 'page', 'page_is_new', 'smallint', 'page_is_new::smallint DEFAULT 0' ],
215  [ 'changeField', 'querycache', 'qc_value', 'integer', '' ],
216  [ 'changeField', 'querycachetwo', 'qcc_value', 'integer', '' ],
217  [ 'changeField', 'recentchanges', 'rc_bot', 'smallint', 'rc_bot::smallint DEFAULT 0' ],
218  [ 'changeField', 'recentchanges', 'rc_deleted', 'smallint', '' ],
219  [ 'changeField', 'recentchanges', 'rc_minor', 'smallint', 'rc_minor::smallint DEFAULT 0' ],
220  [ 'changeField', 'recentchanges', 'rc_new', 'smallint', 'rc_new::smallint DEFAULT 0' ],
221  [ 'changeField', 'recentchanges', 'rc_type', 'smallint', 'rc_type::smallint DEFAULT 0' ],
222  [ 'changeField', 'recentchanges', 'rc_patrolled', 'smallint',
223  'rc_patrolled::smallint DEFAULT 0' ],
224  [ 'changeField', 'revision', 'rev_deleted', 'smallint', 'rev_deleted::smallint DEFAULT 0' ],
225  [ 'changeField', 'revision', 'rev_minor_edit', 'smallint',
226  'rev_minor_edit::smallint DEFAULT 0' ],
227  [ 'changeField', 'templatelinks', 'tl_namespace', 'smallint', 'tl_namespace::smallint' ],
228  [ 'changeField', 'user_newtalk', 'user_ip', 'text', 'host(user_ip)' ],
229  [ 'changeField', 'uploadstash', 'us_image_bits', 'smallint', '' ],
230  [ 'changeField', 'profiling', 'pf_time', 'float', '' ],
231  [ 'changeField', 'profiling', 'pf_memory', 'float', '' ],
232 
233  # null changes
234  [ 'changeNullableField', 'oldimage', 'oi_bits', 'NULL' ],
235  [ 'changeNullableField', 'oldimage', 'oi_timestamp', 'NULL' ],
236  [ 'changeNullableField', 'oldimage', 'oi_major_mime', 'NULL' ],
237  [ 'changeNullableField', 'oldimage', 'oi_minor_mime', 'NULL' ],
238  [ 'changeNullableField', 'image', 'img_metadata', 'NOT NULL' ],
239  [ 'changeNullableField', 'filearchive', 'fa_metadata', 'NOT NULL' ],
240  [ 'changeNullableField', 'recentchanges', 'rc_cur_id', 'NULL' ],
241  [ 'changeNullableField', 'recentchanges', 'rc_cur_time', 'NULL' ],
242 
243  [ 'checkOiDeleted' ],
244 
245  # New indexes
246  [ 'addPgIndex', 'archive', 'archive_user_text', '(ar_user_text)' ],
247  [ 'addPgIndex', 'image', 'img_sha1', '(img_sha1)' ],
248  [ 'addPgIndex', 'ipblocks', 'ipb_parent_block_id', '(ipb_parent_block_id)' ],
249  [ 'addPgIndex', 'oldimage', 'oi_sha1', '(oi_sha1)' ],
250  [ 'addPgIndex', 'page', 'page_mediawiki_title', '(page_title) WHERE page_namespace = 8' ],
251  [ 'addPgIndex', 'pagelinks', 'pagelinks_title', '(pl_title)' ],
252  [ 'addPgIndex', 'page_props', 'pp_propname_page', '(pp_propname, pp_page)' ],
253  [ 'addPgIndex', 'revision', 'rev_text_id_idx', '(rev_text_id)' ],
254  [ 'addPgIndex', 'recentchanges', 'rc_timestamp_bot', '(rc_timestamp) WHERE rc_bot = 0' ],
255  [ 'addPgIndex', 'templatelinks', 'templatelinks_from', '(tl_from)' ],
256  [ 'addPgIndex', 'watchlist', 'wl_user', '(wl_user)' ],
257  [ 'addPgIndex', 'watchlist', 'wl_user_notificationtimestamp',
258  '(wl_user, wl_notificationtimestamp)' ],
259  [ 'addPgIndex', 'logging', 'logging_user_type_time',
260  '(log_user, log_type, log_timestamp)' ],
261  [ 'addPgIndex', 'logging', 'logging_page_id_time', '(log_page,log_timestamp)' ],
262  [ 'addPgIndex', 'iwlinks', 'iwl_prefix_from_title', '(iwl_prefix, iwl_from, iwl_title)' ],
263  [ 'addPgIndex', 'iwlinks', 'iwl_prefix_title_from', '(iwl_prefix, iwl_title, iwl_from)' ],
264  [ 'addPgIndex', 'job', 'job_timestamp_idx', '(job_timestamp)' ],
265  [ 'addPgIndex', 'job', 'job_sha1', '(job_sha1)' ],
266  [ 'addPgIndex', 'job', 'job_cmd_token', '(job_cmd, job_token, job_random)' ],
267  [ 'addPgIndex', 'job', 'job_cmd_token_id', '(job_cmd, job_token, job_id)' ],
268  [ 'addPgIndex', 'filearchive', 'fa_sha1', '(fa_sha1)' ],
269  [ 'addPgIndex', 'logging', 'logging_user_text_type_time',
270  '(log_user_text, log_type, log_timestamp)' ],
271  [ 'addPgIndex', 'logging', 'logging_user_text_time', '(log_user_text, log_timestamp)' ],
272 
273  [ 'checkIndex', 'pagelink_unique', [
274  [ 'pl_from', 'int4_ops', 'btree', 0 ],
275  [ 'pl_namespace', 'int2_ops', 'btree', 0 ],
276  [ 'pl_title', 'text_ops', 'btree', 0 ],
277  ],
278  'CREATE UNIQUE INDEX pagelink_unique ON pagelinks (pl_from,pl_namespace,pl_title)' ],
279  [ 'checkIndex', 'cl_sortkey', [
280  [ 'cl_to', 'text_ops', 'btree', 0 ],
281  [ 'cl_sortkey', 'text_ops', 'btree', 0 ],
282  [ 'cl_from', 'int4_ops', 'btree', 0 ],
283  ],
284  'CREATE INDEX cl_sortkey ON "categorylinks" ' .
285  'USING "btree" ("cl_to", "cl_sortkey", "cl_from")' ],
286  [ 'checkIndex', 'iwl_prefix_title_from', [
287  [ 'iwl_prefix', 'text_ops', 'btree', 0 ],
288  [ 'iwl_title', 'text_ops', 'btree', 0 ],
289  [ 'iwl_from', 'int4_ops', 'btree', 0 ],
290  ],
291  'CREATE INDEX iwl_prefix_title_from ON "iwlinks" ' .
292  'USING "btree" ("iwl_prefix", "iwl_title", "iwl_from")' ],
293  [ 'checkIndex', 'logging_times', [
294  [ 'log_timestamp', 'timestamptz_ops', 'btree', 0 ],
295  ],
296  'CREATE INDEX "logging_times" ON "logging" USING "btree" ("log_timestamp")' ],
297  [ 'dropPgIndex', 'oldimage', 'oi_name' ],
298  [ 'checkIndex', 'oi_name_archive_name', [
299  [ 'oi_name', 'text_ops', 'btree', 0 ],
300  [ 'oi_archive_name', 'text_ops', 'btree', 0 ],
301  ],
302  'CREATE INDEX "oi_name_archive_name" ON "oldimage" ' .
303  'USING "btree" ("oi_name", "oi_archive_name")' ],
304  [ 'checkIndex', 'oi_name_timestamp', [
305  [ 'oi_name', 'text_ops', 'btree', 0 ],
306  [ 'oi_timestamp', 'timestamptz_ops', 'btree', 0 ],
307  ],
308  'CREATE INDEX "oi_name_timestamp" ON "oldimage" ' .
309  'USING "btree" ("oi_name", "oi_timestamp")' ],
310  [ 'checkIndex', 'page_main_title', [
311  [ 'page_title', 'text_pattern_ops', 'btree', 0 ],
312  ],
313  'CREATE INDEX "page_main_title" ON "page" ' .
314  'USING "btree" ("page_title" "text_pattern_ops") WHERE ("page_namespace" = 0)' ],
315  [ 'checkIndex', 'page_mediawiki_title', [
316  [ 'page_title', 'text_pattern_ops', 'btree', 0 ],
317  ],
318  'CREATE INDEX "page_mediawiki_title" ON "page" ' .
319  'USING "btree" ("page_title" "text_pattern_ops") WHERE ("page_namespace" = 8)' ],
320  [ 'checkIndex', 'page_project_title', [
321  [ 'page_title', 'text_pattern_ops', 'btree', 0 ],
322  ],
323  'CREATE INDEX "page_project_title" ON "page" ' .
324  'USING "btree" ("page_title" "text_pattern_ops") ' .
325  'WHERE ("page_namespace" = 4)' ],
326  [ 'checkIndex', 'page_talk_title', [
327  [ 'page_title', 'text_pattern_ops', 'btree', 0 ],
328  ],
329  'CREATE INDEX "page_talk_title" ON "page" ' .
330  'USING "btree" ("page_title" "text_pattern_ops") ' .
331  'WHERE ("page_namespace" = 1)' ],
332  [ 'checkIndex', 'page_user_title', [
333  [ 'page_title', 'text_pattern_ops', 'btree', 0 ],
334  ],
335  'CREATE INDEX "page_user_title" ON "page" ' .
336  'USING "btree" ("page_title" "text_pattern_ops") WHERE ' .
337  '("page_namespace" = 2)' ],
338  [ 'checkIndex', 'page_utalk_title', [
339  [ 'page_title', 'text_pattern_ops', 'btree', 0 ],
340  ],
341  'CREATE INDEX "page_utalk_title" ON "page" ' .
342  'USING "btree" ("page_title" "text_pattern_ops") ' .
343  'WHERE ("page_namespace" = 3)' ],
344  [ 'checkIndex', 'ts2_page_text', [
345  [ 'textvector', 'tsvector_ops', 'gist', 0 ],
346  ],
347  'CREATE INDEX "ts2_page_text" ON "pagecontent" USING "gist" ("textvector")' ],
348  [ 'checkIndex', 'ts2_page_title', [
349  [ 'titlevector', 'tsvector_ops', 'gist', 0 ],
350  ],
351  'CREATE INDEX "ts2_page_title" ON "page" USING "gist" ("titlevector")' ],
352 
353  [ 'checkOiNameConstraint' ],
354  [ 'checkPageDeletedTrigger' ],
355  [ 'checkRevUserFkey' ],
356  [ 'dropPgIndex', 'ipblocks', 'ipb_address' ],
357  [ 'checkIndex', 'ipb_address_unique', [
358  [ 'ipb_address', 'text_ops', 'btree', 0 ],
359  [ 'ipb_user', 'int4_ops', 'btree', 0 ],
360  [ 'ipb_auto', 'int2_ops', 'btree', 0 ],
361  [ 'ipb_anon_only', 'int2_ops', 'btree', 0 ],
362  ],
363  'CREATE UNIQUE INDEX ipb_address_unique ' .
364  'ON ipblocks (ipb_address,ipb_user,ipb_auto,ipb_anon_only)' ],
365 
366  [ 'checkIwlPrefix' ],
367 
368  # All FK columns should be deferred
369  [ 'changeFkeyDeferrable', 'archive', 'ar_user', 'mwuser(user_id) ON DELETE SET NULL' ],
370  [ 'changeFkeyDeferrable', 'categorylinks', 'cl_from', 'page(page_id) ON DELETE CASCADE' ],
371  [ 'changeFkeyDeferrable', 'externallinks', 'el_from', 'page(page_id) ON DELETE CASCADE' ],
372  [ 'changeFkeyDeferrable', 'filearchive', 'fa_deleted_user',
373  'mwuser(user_id) ON DELETE SET NULL' ],
374  [ 'changeFkeyDeferrable', 'filearchive', 'fa_user', 'mwuser(user_id) ON DELETE SET NULL' ],
375  [ 'changeFkeyDeferrable', 'image', 'img_user', 'mwuser(user_id) ON DELETE SET NULL' ],
376  [ 'changeFkeyDeferrable', 'imagelinks', 'il_from', 'page(page_id) ON DELETE CASCADE' ],
377  [ 'changeFkeyDeferrable', 'ipblocks', 'ipb_by', 'mwuser(user_id) ON DELETE CASCADE' ],
378  [ 'changeFkeyDeferrable', 'ipblocks', 'ipb_user', 'mwuser(user_id) ON DELETE SET NULL' ],
379  [ 'changeFkeyDeferrable', 'ipblocks', 'ipb_parent_block_id',
380  'ipblocks(ipb_id) ON DELETE SET NULL' ],
381  [ 'changeFkeyDeferrable', 'langlinks', 'll_from', 'page(page_id) ON DELETE CASCADE' ],
382  [ 'changeFkeyDeferrable', 'logging', 'log_user', 'mwuser(user_id) ON DELETE SET NULL' ],
383  [ 'changeFkeyDeferrable', 'oldimage', 'oi_name',
384  'image(img_name) ON DELETE CASCADE ON UPDATE CASCADE' ],
385  [ 'changeFkeyDeferrable', 'oldimage', 'oi_user', 'mwuser(user_id) ON DELETE SET NULL' ],
386  [ 'changeFkeyDeferrable', 'pagelinks', 'pl_from', 'page(page_id) ON DELETE CASCADE' ],
387  [ 'changeFkeyDeferrable', 'page_props', 'pp_page', 'page (page_id) ON DELETE CASCADE' ],
388  [ 'changeFkeyDeferrable', 'page_restrictions', 'pr_page',
389  'page(page_id) ON DELETE CASCADE' ],
390  [ 'changeFkeyDeferrable', 'protected_titles', 'pt_user',
391  'mwuser(user_id) ON DELETE SET NULL' ],
392  [ 'changeFkeyDeferrable', 'recentchanges', 'rc_user',
393  'mwuser(user_id) ON DELETE SET NULL' ],
394  [ 'changeFkeyDeferrable', 'redirect', 'rd_from', 'page(page_id) ON DELETE CASCADE' ],
395  [ 'changeFkeyDeferrable', 'revision', 'rev_page', 'page (page_id) ON DELETE CASCADE' ],
396  [ 'changeFkeyDeferrable', 'revision', 'rev_user', 'mwuser(user_id) ON DELETE RESTRICT' ],
397  [ 'changeFkeyDeferrable', 'templatelinks', 'tl_from', 'page(page_id) ON DELETE CASCADE' ],
398  [ 'changeFkeyDeferrable', 'user_groups', 'ug_user', 'mwuser(user_id) ON DELETE CASCADE' ],
399  [ 'changeFkeyDeferrable', 'user_newtalk', 'user_id', 'mwuser(user_id) ON DELETE CASCADE' ],
400  [ 'changeFkeyDeferrable', 'user_properties', 'up_user',
401  'mwuser(user_id) ON DELETE CASCADE' ],
402  [ 'changeFkeyDeferrable', 'watchlist', 'wl_user', 'mwuser(user_id) ON DELETE CASCADE' ],
403 
404  # r81574
405  [ 'addInterwikiType' ],
406  # end
407  [ 'tsearchFixes' ],
408 
409  // 1.23
410  [ 'addPgField', 'recentchanges', 'rc_source', "TEXT NOT NULL DEFAULT ''" ],
411  [ 'addPgField', 'page', 'page_links_updated', "TIMESTAMPTZ NULL" ],
412  [ 'addPgField', 'mwuser', 'user_password_expires', 'TIMESTAMPTZ NULL' ],
413  [ 'changeFieldPurgeTable', 'l10n_cache', 'lc_value', 'bytea',
414  "replace(lc_value,'\','\\\\')::bytea" ],
415  // 1.23.9
416  [ 'rebuildTextSearch' ],
417 
418  // 1.24
419  [ 'addPgField', 'page_props', 'pp_sortkey', 'float NULL' ],
420  [ 'addPgIndex', 'page_props', 'pp_propname_sortkey_page',
421  '( pp_propname, pp_sortkey, pp_page ) WHERE ( pp_sortkey IS NOT NULL )' ],
422  [ 'addPgField', 'page', 'page_lang', 'TEXT default NULL' ],
423  [ 'addPgField', 'pagelinks', 'pl_from_namespace', 'INTEGER NOT NULL DEFAULT 0' ],
424  [ 'addPgField', 'templatelinks', 'tl_from_namespace', 'INTEGER NOT NULL DEFAULT 0' ],
425  [ 'addPgField', 'imagelinks', 'il_from_namespace', 'INTEGER NOT NULL DEFAULT 0' ],
426 
427  // 1.25
428  [ 'dropTable', 'hitcounter' ],
429  [ 'dropField', 'site_stats', 'ss_total_views', 'patch-drop-ss_total_views.sql' ],
430  [ 'dropField', 'page', 'page_counter', 'patch-drop-page_counter.sql' ],
431  [ 'dropFkey', 'recentchanges', 'rc_cur_id' ],
432 
433  // 1.27
434  [ 'dropTable', 'msg_resource_links' ],
435  [ 'dropTable', 'msg_resource' ],
436  [
437  'addPgField', 'watchlist', 'wl_id',
438  "INTEGER NOT NULL PRIMARY KEY DEFAULT nextval('watchlist_wl_id_seq')"
439  ],
440 
441  // 1.28
442  [ 'addPgIndex', 'recentchanges', 'rc_name_type_patrolled_timestamp',
443  '( rc_namespace, rc_type, rc_patrolled, rc_timestamp )' ],
444  [ 'addPgField', 'change_tag', 'ct_id',
445  "INTEGER NOT NULL PRIMARY KEY DEFAULT nextval('change_tag_ct_id_seq')" ],
446  [ 'addPgField', 'tag_summary', 'ts_id',
447  "INTEGER NOT NULL PRIMARY KEY DEFAULT nextval('tag_summary_ts_id_seq')" ],
448 
449  // 1.29
450  [ 'addPgField', 'externallinks', 'el_index_60', "BYTEA NOT NULL DEFAULT ''" ],
451  [ 'addPgIndex', 'externallinks', 'el_index_60', '( el_index_60, el_id )' ],
452  [ 'addPgIndex', 'externallinks', 'el_from_index_60', '( el_from, el_index_60, el_id )' ],
453  [ 'addPgField', 'user_groups', 'ug_expiry', "TIMESTAMPTZ NULL" ],
454  [ 'addPgIndex', 'user_groups', 'user_groups_expiry', '( ug_expiry )' ],
455 
456  // 1.30
457  [ 'addPgEnumValue', 'media_type', '3D' ],
458  [ 'setDefault', 'revision', 'rev_comment', '' ],
459  [ 'changeNullableField', 'revision', 'rev_comment', 'NOT NULL', true ],
460  [ 'setDefault', 'archive', 'ar_comment', '' ],
461  [ 'changeNullableField', 'archive', 'ar_comment', 'NOT NULL', true ],
462  [ 'addPgField', 'archive', 'ar_comment_id', 'INTEGER NOT NULL DEFAULT 0' ],
463  [ 'setDefault', 'ipblocks', 'ipb_reason', '' ],
464  [ 'addPgField', 'ipblocks', 'ipb_reason_id', 'INTEGER NOT NULL DEFAULT 0' ],
465  [ 'setDefault', 'image', 'img_description', '' ],
466  [ 'setDefault', 'oldimage', 'oi_description', '' ],
467  [ 'changeNullableField', 'oldimage', 'oi_description', 'NOT NULL', true ],
468  [ 'addPgField', 'oldimage', 'oi_description_id', 'INTEGER NOT NULL DEFAULT 0' ],
469  [ 'setDefault', 'filearchive', 'fa_deleted_reason', '' ],
470  [ 'changeNullableField', 'filearchive', 'fa_deleted_reason', 'NOT NULL', true ],
471  [ 'addPgField', 'filearchive', 'fa_deleted_reason_id', 'INTEGER NOT NULL DEFAULT 0' ],
472  [ 'setDefault', 'filearchive', 'fa_description', '' ],
473  [ 'addPgField', 'filearchive', 'fa_description_id', 'INTEGER NOT NULL DEFAULT 0' ],
474  [ 'setDefault', 'recentchanges', 'rc_comment', '' ],
475  [ 'changeNullableField', 'recentchanges', 'rc_comment', 'NOT NULL', true ],
476  [ 'addPgField', 'recentchanges', 'rc_comment_id', 'INTEGER NOT NULL DEFAULT 0' ],
477  [ 'setDefault', 'logging', 'log_comment', '' ],
478  [ 'changeNullableField', 'logging', 'log_comment', 'NOT NULL', true ],
479  [ 'addPgField', 'logging', 'log_comment_id', 'INTEGER NOT NULL DEFAULT 0' ],
480  [ 'setDefault', 'protected_titles', 'pt_reason', '' ],
481  [ 'changeNullableField', 'protected_titles', 'pt_reason', 'NOT NULL', true ],
482  [ 'addPgField', 'protected_titles', 'pt_reason_id', 'INTEGER NOT NULL DEFAULT 0' ],
483  [ 'addTable', 'comment', 'patch-comment-table.sql' ],
484  [ 'addTable', 'revision_comment_temp', 'patch-revision_comment_temp-table.sql' ],
485  // image_comment_temp is no longer needed when upgrading to MW 1.31 or newer,
486  // as it is dropped later in the update process as part of 'migrateImageCommentTemp'.
487  // File kept on disk and the updater entry here for historical purposes.
488  // [ 'addTable', 'image_comment_temp', 'patch-image_comment_temp-table.sql' ],
489 
490  // This field was added in 1.31, but is put here so it can be used by 'migrateComments'
491  [ 'addPgField', 'image', 'img_description_id', 'INTEGER NOT NULL DEFAULT 0' ],
492 
493  [ 'migrateComments' ],
494  [ 'addIndex', 'site_stats', 'site_stats_pkey', 'patch-site_stats-pk.sql' ],
495  [ 'addTable', 'ip_changes', 'patch-ip_changes.sql' ],
496 
497  // 1.31
498  [ 'addTable', 'slots', 'patch-slots-table.sql' ],
499  [ 'dropPgIndex', 'slots', 'slot_role_inherited' ],
500  [ 'dropPgField', 'slots', 'slot_inherited' ],
501  [ 'addPgField', 'slots', 'slot_origin', 'INTEGER NOT NULL' ],
502  [
503  'addPgIndex',
504  'slots',
505  'slot_revision_origin_role',
506  '( slot_revision_id, slot_origin, slot_role_id )',
507  ],
508  [ 'addTable', 'content', 'patch-content-table.sql' ],
509  [ 'addTable', 'content_models', 'patch-content_models-table.sql' ],
510  [ 'addTable', 'slot_roles', 'patch-slot_roles-table.sql' ],
511  [ 'migrateArchiveText' ],
512  [ 'addTable', 'actor', 'patch-actor-table.sql' ],
513  [ 'addTable', 'revision_actor_temp', 'patch-revision_actor_temp-table.sql' ],
514  [ 'setDefault', 'revision', 'rev_user', 0 ],
515  [ 'setDefault', 'revision', 'rev_user_text', '' ],
516  [ 'setDefault', 'archive', 'ar_user', 0 ],
517  [ 'changeNullableField', 'archive', 'ar_user', 'NOT NULL', true ],
518  [ 'setDefault', 'archive', 'ar_user_text', '' ],
519  [ 'addPgField', 'archive', 'ar_actor', 'INTEGER NOT NULL DEFAULT 0' ],
520  [ 'addPgIndex', 'archive', 'archive_actor', '( ar_actor )' ],
521  [ 'setDefault', 'ipblocks', 'ipb_by', 0 ],
522  [ 'addPgField', 'ipblocks', 'ipb_by_actor', 'INTEGER NOT NULL DEFAULT 0' ],
523  [ 'setDefault', 'image', 'img_user', 0 ],
524  [ 'changeNullableField', 'image', 'img_user', 'NOT NULL', true ],
525  [ 'setDefault', 'image', 'img_user_text', '' ],
526  [ 'addPgField', 'image', 'img_actor', 'INTEGER NOT NULL DEFAULT 0' ],
527  [ 'setDefault', 'oldimage', 'oi_user', 0 ],
528  [ 'changeNullableField', 'oldimage', 'oi_user', 'NOT NULL', true ],
529  [ 'setDefault', 'oldimage', 'oi_user_text', '' ],
530  [ 'addPgField', 'oldimage', 'oi_actor', 'INTEGER NOT NULL DEFAULT 0' ],
531  [ 'setDefault', 'filearchive', 'fa_user', 0 ],
532  [ 'changeNullableField', 'filearchive', 'fa_user', 'NOT NULL', true ],
533  [ 'setDefault', 'filearchive', 'fa_user_text', '' ],
534  [ 'addPgField', 'filearchive', 'fa_actor', 'INTEGER NOT NULL DEFAULT 0' ],
535  [ 'setDefault', 'recentchanges', 'rc_user', 0 ],
536  [ 'changeNullableField', 'recentchanges', 'rc_user', 'NOT NULL', true ],
537  [ 'setDefault', 'recentchanges', 'rc_user_text', '' ],
538  [ 'addPgField', 'recentchanges', 'rc_actor', 'INTEGER NOT NULL DEFAULT 0' ],
539  [ 'setDefault', 'logging', 'log_user', 0 ],
540  [ 'changeNullableField', 'logging', 'log_user', 'NOT NULL', true ],
541  [ 'addPgField', 'logging', 'log_actor', 'INTEGER NOT NULL DEFAULT 0' ],
542  [ 'addPgIndex', 'logging', 'logging_actor_time_backwards', '( log_timestamp, log_actor )' ],
543  [ 'addPgIndex', 'logging', 'logging_actor_type_time', '( log_actor, log_type, log_timestamp )' ],
544  [ 'addPgIndex', 'logging', 'logging_actor_time', '( log_actor, log_timestamp )' ],
545  [ 'migrateActors' ],
546  [ 'modifyTable', 'site_stats', 'patch-site_stats-modify.sql' ],
547  [ 'populateArchiveRevId' ],
548  [ 'dropPgIndex', 'recentchanges', 'rc_namespace_title' ],
549  [
550  'addPgIndex',
551  'recentchanges',
552  'rc_namespace_title_timestamp', '( rc_namespace, rc_title, rc_timestamp )'
553  ],
554  [ 'setSequenceOwner', 'mwuser', 'user_id', 'user_user_id_seq' ],
555  [ 'setSequenceOwner', 'actor', 'actor_id', 'actor_actor_id_seq' ],
556  [ 'setSequenceOwner', 'page', 'page_id', 'page_page_id_seq' ],
557  [ 'setSequenceOwner', 'revision', 'rev_id', 'revision_rev_id_seq' ],
558  [ 'setSequenceOwner', 'ip_changes', 'ipc_rev_id', 'ip_changes_ipc_rev_id_seq' ],
559  [ 'setSequenceOwner', 'pagecontent', 'old_id', 'text_old_id_seq' ],
560  [ 'setSequenceOwner', 'comment', 'comment_id', 'comment_comment_id_seq' ],
561  [ 'setSequenceOwner', 'page_restrictions', 'pr_id', 'page_restrictions_pr_id_seq' ],
562  [ 'setSequenceOwner', 'archive', 'ar_id', 'archive_ar_id_seq' ],
563  [ 'setSequenceOwner', 'content', 'content_id', 'content_content_id_seq' ],
564  [ 'setSequenceOwner', 'slot_roles', 'role_id', 'slot_roles_role_id_seq' ],
565  [ 'setSequenceOwner', 'content_models', 'model_id', 'content_models_model_id_seq' ],
566  [ 'setSequenceOwner', 'externallinks', 'el_id', 'externallinks_el_id_seq' ],
567  [ 'setSequenceOwner', 'ipblocks', 'ipb_id', 'ipblocks_ipb_id_seq' ],
568  [ 'setSequenceOwner', 'filearchive', 'fa_id', 'filearchive_fa_id_seq' ],
569  [ 'setSequenceOwner', 'uploadstash', 'us_id', 'uploadstash_us_id_seq' ],
570  [ 'setSequenceOwner', 'recentchanges', 'rc_id', 'recentchanges_rc_id_seq' ],
571  [ 'setSequenceOwner', 'watchlist', 'wl_id', 'watchlist_wl_id_seq' ],
572  [ 'setSequenceOwner', 'logging', 'log_id', 'logging_log_id_seq' ],
573  [ 'setSequenceOwner', 'job', 'job_id', 'job_job_id_seq' ],
574  [ 'setSequenceOwner', 'category', 'cat_id', 'category_cat_id_seq' ],
575  [ 'setSequenceOwner', 'change_tag', 'ct_id', 'change_tag_ct_id_seq' ],
576  [ 'setSequenceOwner', 'tag_summary', 'ts_id', 'tag_summary_ts_id_seq' ],
577  [ 'setSequenceOwner', 'sites', 'site_id', 'sites_site_id_seq' ],
578 
579  // 1.32
580  [ 'addTable', 'change_tag_def', 'patch-change_tag_def.sql' ],
581  [ 'populateExternallinksIndex60' ],
582  [ 'dropDefault', 'externallinks', 'el_index_60' ],
583  [ 'runMaintenance', DeduplicateArchiveRevId::class, 'maintenance/deduplicateArchiveRevId.php' ],
584  [ 'addPgField', 'change_tag', 'ct_tag_id', 'INTEGER NULL' ],
585  [
586  'addPgIndex',
587  'change_tag',
588  'change_tag_tag_id_id',
589  '( ct_tag_id, ct_rc_id, ct_rev_id, ct_log_id )'
590  ],
591  [ 'addPgIndex', 'archive', 'ar_revid_uniq', '(ar_rev_id)', 'unique' ],
592  [ 'dropPgIndex', 'archive', 'ar_revid' ], // Probably doesn't exist, but do it anyway.
593  [ 'populateContentTables' ],
594  [ 'addPgIndex', 'logging', 'log_type_action', '( log_type, log_action, log_timestamp )' ],
595  [ 'dropPgIndex', 'page_props', 'page_props_propname' ],
596  [ 'addIndex', 'interwiki', 'interwiki_pkey', 'patch-interwiki-pk.sql' ],
597  [ 'addIndex', 'protected_titles', 'protected_titles_pkey', 'patch-protected_titles-pk.sql' ],
598  [ 'addIndex', 'site_identifiers', 'site_identifiers_pkey', 'patch-site_identifiers-pk.sql' ],
599  [ 'addPgIndex', 'recentchanges', 'rc_this_oldid', '(rc_this_oldid)' ],
600  [ 'dropTable', 'transcache' ],
601  [ 'runMaintenance', PopulateChangeTagDef::class, 'maintenance/populateChangeTagDef.php' ],
602  [ 'addIndex', 'change_tag', 'change_tag_rc_tag_id',
603  'patch-change_tag-change_tag_rc_tag_id.sql' ],
604  [ 'addPgField', 'ipblocks', 'ipb_sitewide', 'SMALLINT NOT NULL DEFAULT 1' ],
605  [ 'addTable', 'ipblocks_restrictions', 'patch-ipblocks_restrictions-table.sql' ],
606  [ 'migrateImageCommentTemp' ],
607  [ 'dropPgField', 'category', 'cat_hidden' ],
608  [ 'dropPgField', 'site_stats', 'ss_admins' ],
609  [ 'dropPgField', 'recentchanges', 'rc_cur_time' ],
610  ];
611  }
612 
613  protected function getOldGlobalUpdates() {
614  global $wgExtNewTables, $wgExtPGNewFields, $wgExtPGAlteredFields, $wgExtNewIndexes;
615 
616  $updates = [];
617 
618  # Add missing extension tables
619  foreach ( $wgExtNewTables as $tableRecord ) {
620  $updates[] = [
621  'addTable', $tableRecord[0], $tableRecord[1], true
622  ];
623  }
624 
625  # Add missing extension fields
626  foreach ( $wgExtPGNewFields as $fieldRecord ) {
627  $updates[] = [
628  'addPgField', $fieldRecord[0], $fieldRecord[1],
629  $fieldRecord[2]
630  ];
631  }
632 
633  # Change altered columns
634  foreach ( $wgExtPGAlteredFields as $fieldRecord ) {
635  $updates[] = [
636  'changeField', $fieldRecord[0], $fieldRecord[1],
637  $fieldRecord[2]
638  ];
639  }
640 
641  # Add missing extension indexes
642  foreach ( $wgExtNewIndexes as $fieldRecord ) {
643  $updates[] = [
644  'addPgExtIndex', $fieldRecord[0], $fieldRecord[1],
645  $fieldRecord[2]
646  ];
647  }
648 
649  return $updates;
650  }
651 
652  protected function describeTable( $table ) {
653  $q = <<<END
654 SELECT attname, attnum FROM pg_namespace, pg_class, pg_attribute
655  WHERE pg_class.relnamespace = pg_namespace.oid
656  AND attrelid=pg_class.oid AND attnum > 0
657  AND relname=%s AND nspname=%s
658 END;
659  $res = $this->db->query( sprintf( $q,
660  $this->db->addQuotes( $table ),
661  $this->db->addQuotes( $this->db->getCoreSchema() ) ) );
662  if ( !$res ) {
663  return null;
664  }
665 
666  $cols = [];
667  foreach ( $res as $r ) {
668  $cols[] = [
669  "name" => $r[0],
670  "ord" => $r[1],
671  ];
672  }
673 
674  return $cols;
675  }
676 
677  function describeIndex( $idx ) {
678  // first fetch the key (which is a list of columns ords) and
679  // the table the index applies to (an oid)
680  $q = <<<END
681 SELECT indkey, indrelid FROM pg_namespace, pg_class, pg_index
682  WHERE nspname=%s
683  AND pg_class.relnamespace = pg_namespace.oid
684  AND relname=%s
685  AND indexrelid=pg_class.oid
686 END;
687  $res = $this->db->query(
688  sprintf(
689  $q,
690  $this->db->addQuotes( $this->db->getCoreSchema() ),
691  $this->db->addQuotes( $idx )
692  )
693  );
694  if ( !$res ) {
695  return null;
696  }
697  $r = $this->db->fetchRow( $res );
698  if ( !$r ) {
699  return null;
700  }
701 
702  $indkey = $r[0];
703  $relid = intval( $r[1] );
704  $indkeys = explode( ' ', $indkey );
705 
706  $colnames = [];
707  foreach ( $indkeys as $rid ) {
708  $query = <<<END
709 SELECT attname FROM pg_class, pg_attribute
710  WHERE attrelid=$relid
711  AND attnum=%d
712  AND attrelid=pg_class.oid
713 END;
714  $r2 = $this->db->query( sprintf( $query, $rid ) );
715  if ( !$r2 ) {
716  return null;
717  }
718  $row2 = $this->db->fetchRow( $r2 );
719  if ( !$row2 ) {
720  return null;
721  }
722  $colnames[] = $row2[0];
723  }
724 
725  return $colnames;
726  }
727 
728  function fkeyDeltype( $fkey ) {
729  $q = <<<END
730 SELECT confdeltype FROM pg_constraint, pg_namespace
731  WHERE connamespace=pg_namespace.oid
732  AND nspname=%s
733  AND conname=%s;
734 END;
735  $r = $this->db->query(
736  sprintf(
737  $q,
738  $this->db->addQuotes( $this->db->getCoreSchema() ),
739  $this->db->addQuotes( $fkey )
740  )
741  );
742  $row = $this->db->fetchRow( $r );
743  if ( !$row ) {
744  return null;
745  }
746 
747  return $row[0];
748  }
749 
750  function ruleDef( $table, $rule ) {
751  $q = <<<END
752 SELECT definition FROM pg_rules
753  WHERE schemaname = %s
754  AND tablename = %s
755  AND rulename = %s
756 END;
757  $r = $this->db->query(
758  sprintf(
759  $q,
760  $this->db->addQuotes( $this->db->getCoreSchema() ),
761  $this->db->addQuotes( $table ),
762  $this->db->addQuotes( $rule )
763  )
764  );
765  $row = $this->db->fetchRow( $r );
766  if ( !$row ) {
767  return null;
768  }
769  $d = $row[0];
770 
771  return $d;
772  }
773 
774  protected function addSequence( $table, $pkey, $ns ) {
775  if ( !$this->db->sequenceExists( $ns ) ) {
776  $this->output( "Creating sequence $ns\n" );
777  if ( $pkey !== false ) {
778  $this->db->query( "CREATE SEQUENCE $ns OWNED BY $table.$pkey" );
779  $this->setDefault( $table, $pkey, '"nextval"(\'"' . $ns . '"\'::"regclass")' );
780  } else {
781  $this->db->query( "CREATE SEQUENCE $ns" );
782  }
783  }
784  }
785 
786  protected function dropSequence( $table, $ns ) {
787  if ( $this->db->sequenceExists( $ns ) ) {
788  $this->output( "Dropping sequence $ns\n" );
789  $this->db->query( "DROP SEQUENCE $ns CASCADE" );
790  }
791  }
792 
793  protected function renameSequence( $old, $new ) {
794  if ( $this->db->sequenceExists( $new ) ) {
795  $this->output( "...sequence $new already exists.\n" );
796 
797  return;
798  }
799  if ( $this->db->sequenceExists( $old ) ) {
800  $this->output( "Renaming sequence $old to $new\n" );
801  $this->db->query( "ALTER SEQUENCE $old RENAME TO $new" );
802  }
803  }
804 
805  protected function setSequenceOwner( $table, $pkey, $seq ) {
806  if ( $this->db->sequenceExists( $seq ) ) {
807  $this->output( "Setting sequence $seq owner to $table.$pkey\n" );
808  $this->db->query( "ALTER SEQUENCE $seq OWNED BY $table.$pkey" );
809  }
810  }
811 
812  protected function renameTable( $old, $new, $patch = false ) {
813  if ( $this->db->tableExists( $old ) ) {
814  $this->output( "Renaming table $old to $new\n" );
815  $old = $this->db->realTableName( $old, "quoted" );
816  $new = $this->db->realTableName( $new, "quoted" );
817  $this->db->query( "ALTER TABLE $old RENAME TO $new" );
818  if ( $patch !== false ) {
819  $this->applyPatch( $patch );
820  }
821  }
822  }
823 
824  protected function renameIndex(
825  $table, $old, $new, $skipBothIndexExistWarning = false, $a = false, $b = false
826  ) {
827  // First requirement: the table must exist
828  if ( !$this->db->tableExists( $table, __METHOD__ ) ) {
829  $this->output( "...skipping: '$table' table doesn't exist yet.\n" );
830 
831  return;
832  }
833 
834  // Second requirement: the new index must be missing
835  if ( $this->db->indexExists( $table, $new, __METHOD__ ) ) {
836  $this->output( "...index $new already set on $table table.\n" );
837  if ( !$skipBothIndexExistWarning
838  && $this->db->indexExists( $table, $old, __METHOD__ )
839  ) {
840  $this->output( "...WARNING: $old still exists, despite it has been " .
841  "renamed into $new (which also exists).\n" .
842  " $old should be manually removed if not needed anymore.\n" );
843  }
844 
845  return;
846  }
847 
848  // Third requirement: the old index must exist
849  if ( !$this->db->indexExists( $table, $old, __METHOD__ ) ) {
850  $this->output( "...skipping: index $old doesn't exist.\n" );
851 
852  return;
853  }
854 
855  $this->db->query( "ALTER INDEX $old RENAME TO $new" );
856  }
857 
858  protected function dropPgField( $table, $field ) {
859  $fi = $this->db->fieldInfo( $table, $field );
860  if ( is_null( $fi ) ) {
861  $this->output( "...$table table does not contain $field field.\n" );
862 
863  return;
864  } else {
865  $this->output( "Dropping column '$table.$field'\n" );
866  $this->db->query( "ALTER TABLE $table DROP COLUMN $field" );
867  }
868  }
869 
870  protected function addPgField( $table, $field, $type ) {
871  $fi = $this->db->fieldInfo( $table, $field );
872  if ( !is_null( $fi ) ) {
873  $this->output( "...column '$table.$field' already exists\n" );
874 
875  return;
876  } else {
877  $this->output( "Adding column '$table.$field'\n" );
878  $this->db->query( "ALTER TABLE $table ADD $field $type" );
879  }
880  }
881 
882  protected function changeField( $table, $field, $newtype, $default ) {
883  $fi = $this->db->fieldInfo( $table, $field );
884  if ( is_null( $fi ) ) {
885  $this->output( "...ERROR: expected column $table.$field to exist\n" );
886  exit( 1 );
887  }
888 
889  if ( $fi->type() === $newtype ) {
890  $this->output( "...column '$table.$field' is already of type '$newtype'\n" );
891  } else {
892  $this->output( "Changing column type of '$table.$field' from '{$fi->type()}' to '$newtype'\n" );
893  $sql = "ALTER TABLE $table ALTER $field TYPE $newtype";
894  if ( strlen( $default ) ) {
895  $res = [];
896  if ( preg_match( '/DEFAULT (.+)/', $default, $res ) ) {
897  $sqldef = "ALTER TABLE $table ALTER $field SET DEFAULT $res[1]";
898  $this->db->query( $sqldef );
899  $default = preg_replace( '/\s*DEFAULT .+/', '', $default );
900  }
901  $sql .= " USING $default";
902  }
903  $this->db->query( $sql );
904  }
905  }
906 
907  protected function changeFieldPurgeTable( $table, $field, $newtype, $default ) {
908  # # For a cache table, empty it if the field needs to be changed, because the old contents
909  # # may be corrupted. If the column is already the desired type, refrain from purging.
910  $fi = $this->db->fieldInfo( $table, $field );
911  if ( is_null( $fi ) ) {
912  $this->output( "...ERROR: expected column $table.$field to exist\n" );
913  exit( 1 );
914  }
915 
916  if ( $fi->type() === $newtype ) {
917  $this->output( "...column '$table.$field' is already of type '$newtype'\n" );
918  } else {
919  $this->output( "Purging data from cache table '$table'\n" );
920  $this->db->query( "DELETE from $table" );
921  $this->output( "Changing column type of '$table.$field' from '{$fi->type()}' to '$newtype'\n" );
922  $sql = "ALTER TABLE $table ALTER $field TYPE $newtype";
923  if ( strlen( $default ) ) {
924  $res = [];
925  if ( preg_match( '/DEFAULT (.+)/', $default, $res ) ) {
926  $sqldef = "ALTER TABLE $table ALTER $field SET DEFAULT $res[1]";
927  $this->db->query( $sqldef );
928  $default = preg_replace( '/\s*DEFAULT .+/', '', $default );
929  }
930  $sql .= " USING $default";
931  }
932  $this->db->query( $sql );
933  }
934  }
935 
936  protected function setDefault( $table, $field, $default ) {
937  $info = $this->db->fieldInfo( $table, $field );
938  if ( $info->defaultValue() !== $default ) {
939  $this->output( "Changing '$table.$field' default value\n" );
940  $this->db->query( "ALTER TABLE $table ALTER $field SET DEFAULT "
941  . $this->db->addQuotes( $default ) );
942  }
943  }
944 
951  protected function dropDefault( $table, $field ) {
952  $info = $this->db->fieldInfo( $table, $field );
953  if ( $info->defaultValue() !== false ) {
954  $this->output( "Removing '$table.$field' default value\n" );
955  $this->db->query( "ALTER TABLE $table ALTER $field DROP DEFAULT" );
956  }
957  }
958 
959  protected function changeNullableField( $table, $field, $null, $update = false ) {
960  $fi = $this->db->fieldInfo( $table, $field );
961  if ( is_null( $fi ) ) {
962  return;
963  }
964  if ( $fi->isNullable() ) {
965  # # It's NULL - does it need to be NOT NULL?
966  if ( 'NOT NULL' === $null ) {
967  $this->output( "Changing '$table.$field' to not allow NULLs\n" );
968  if ( $update ) {
969  $this->db->query( "UPDATE $table SET $field = DEFAULT WHERE $field IS NULL" );
970  }
971  $this->db->query( "ALTER TABLE $table ALTER $field SET NOT NULL" );
972  } else {
973  $this->output( "...column '$table.$field' is already set as NULL\n" );
974  }
975  } else {
976  # # It's NOT NULL - does it need to be NULL?
977  if ( 'NULL' === $null ) {
978  $this->output( "Changing '$table.$field' to allow NULLs\n" );
979  $this->db->query( "ALTER TABLE $table ALTER $field DROP NOT NULL" );
980  } else {
981  $this->output( "...column '$table.$field' is already set as NOT NULL\n" );
982  }
983  }
984  }
985 
986  public function addPgIndex( $table, $index, $type, $unique = false ) {
987  if ( $this->db->indexExists( $table, $index ) ) {
988  $this->output( "...index '$index' on table '$table' already exists\n" );
989  } else {
990  $this->output( "Creating index '$index' on table '$table' $type\n" );
991  $unique = $unique ? 'UNIQUE' : '';
992  $this->db->query( "CREATE $unique INDEX $index ON $table $type" );
993  }
994  }
995 
996  public function addPgExtIndex( $table, $index, $type ) {
997  if ( $this->db->indexExists( $table, $index ) ) {
998  $this->output( "...index '$index' on table '$table' already exists\n" );
999  } else {
1000  if ( preg_match( '/^\(/', $type ) ) {
1001  $this->output( "Creating index '$index' on table '$table'\n" );
1002  $this->db->query( "CREATE INDEX $index ON $table $type" );
1003  } else {
1004  $this->applyPatch( $type, true, "Creating index '$index' on table '$table'" );
1005  }
1006  }
1007  }
1008 
1015  public function addPgEnumValue( $type, $value ) {
1016  $row = $this->db->selectRow(
1017  [
1018  't' => 'pg_catalog.pg_type',
1019  'n' => 'pg_catalog.pg_namespace',
1020  'e' => 'pg_catalog.pg_enum',
1021  ],
1022  [ 't.typname', 't.typtype', 'e.enumlabel' ],
1023  [
1024  't.typname' => $type,
1025  'n.nspname' => $this->db->getCoreSchema(),
1026  ],
1027  __METHOD__,
1028  [],
1029  [
1030  'n' => [ 'JOIN', 't.typnamespace = n.oid' ],
1031  'e' => [ 'LEFT JOIN', [ 'e.enumtypid = t.oid', 'e.enumlabel' => $value ] ],
1032  ]
1033  );
1034 
1035  if ( !$row ) {
1036  $this->output( "...Type $type does not exist, skipping modify enum.\n" );
1037  } elseif ( $row->typtype !== 'e' ) {
1038  $this->output( "...Type $type does not seem to be an enum, skipping modify enum.\n" );
1039  } elseif ( $row->enumlabel === $value ) {
1040  $this->output( "...Enum type $type already contains value '$value'.\n" );
1041  } else {
1042  $this->output( "...Adding value '$value' to enum type $type.\n" );
1043  $etype = $this->db->addIdentifierQuotes( $type );
1044  $evalue = $this->db->addQuotes( $value );
1045  $this->db->query( "ALTER TYPE $etype ADD VALUE $evalue" );
1046  }
1047  }
1048 
1049  protected function dropFkey( $table, $field ) {
1050  $fi = $this->db->fieldInfo( $table, $field );
1051  if ( is_null( $fi ) ) {
1052  $this->output( "WARNING! Column '$table.$field' does not exist but it should! " .
1053  "Please report this.\n" );
1054  return;
1055  }
1056  $conname = $fi->conname();
1057  if ( $fi->conname() ) {
1058  $this->output( "Dropping foreign key constraint on '$table.$field'\n" );
1059  $conclause = "CONSTRAINT \"$conname\"";
1060  $command = "ALTER TABLE $table DROP CONSTRAINT $conname";
1061  $this->db->query( $command );
1062  } else {
1063  $this->output( "...foreign key constraint on '$table.$field' already does not exist\n" );
1064  };
1065  }
1066 
1067  protected function changeFkeyDeferrable( $table, $field, $clause ) {
1068  $fi = $this->db->fieldInfo( $table, $field );
1069  if ( is_null( $fi ) ) {
1070  $this->output( "WARNING! Column '$table.$field' does not exist but it should! " .
1071  "Please report this.\n" );
1072 
1073  return;
1074  }
1075  if ( $fi->is_deferred() && $fi->is_deferrable() ) {
1076  return;
1077  }
1078  $this->output( "Altering column '$table.$field' to be DEFERRABLE INITIALLY DEFERRED\n" );
1079  $conname = $fi->conname();
1080  if ( $fi->conname() ) {
1081  $conclause = "CONSTRAINT \"$conname\"";
1082  $command = "ALTER TABLE $table DROP CONSTRAINT $conname";
1083  $this->db->query( $command );
1084  } else {
1085  $this->output( "Column '$table.$field' does not have a foreign key " .
1086  "constraint, will be added\n" );
1087  $conclause = "";
1088  }
1089  $command =
1090  "ALTER TABLE $table ADD $conclause " .
1091  "FOREIGN KEY ($field) REFERENCES $clause DEFERRABLE INITIALLY DEFERRED";
1092  $this->db->query( $command );
1093  }
1094 
1095  protected function convertArchive2() {
1096  if ( $this->db->tableExists( "archive2" ) ) {
1097  if ( $this->db->ruleExists( 'archive', 'archive_insert' ) ) {
1098  $this->output( "Dropping rule 'archive_insert'\n" );
1099  $this->db->query( 'DROP RULE archive_insert ON archive' );
1100  }
1101  if ( $this->db->ruleExists( 'archive', 'archive_delete' ) ) {
1102  $this->output( "Dropping rule 'archive_delete'\n" );
1103  $this->db->query( 'DROP RULE archive_delete ON archive' );
1104  }
1105  $this->applyPatch(
1106  'patch-remove-archive2.sql',
1107  false,
1108  "Converting 'archive2' back to normal archive table"
1109  );
1110  } else {
1111  $this->output( "...obsolete table 'archive2' does not exist\n" );
1112  }
1113  }
1114 
1115  protected function checkOiDeleted() {
1116  if ( $this->db->fieldInfo( 'oldimage', 'oi_deleted' )->type() !== 'smallint' ) {
1117  $this->output( "Changing 'oldimage.oi_deleted' to type 'smallint'\n" );
1118  $this->db->query( "ALTER TABLE oldimage ALTER oi_deleted DROP DEFAULT" );
1119  $this->db->query(
1120  "ALTER TABLE oldimage ALTER oi_deleted TYPE SMALLINT USING (oi_deleted::smallint)" );
1121  $this->db->query( "ALTER TABLE oldimage ALTER oi_deleted SET DEFAULT 0" );
1122  } else {
1123  $this->output( "...column 'oldimage.oi_deleted' is already of type 'smallint'\n" );
1124  }
1125  }
1126 
1127  protected function checkOiNameConstraint() {
1128  if ( $this->db->hasConstraint( "oldimage_oi_name_fkey_cascaded" ) ) {
1129  $this->output( "...table 'oldimage' has correct cascading delete/update " .
1130  "foreign key to image\n" );
1131  } else {
1132  if ( $this->db->hasConstraint( "oldimage_oi_name_fkey" ) ) {
1133  $this->db->query(
1134  "ALTER TABLE oldimage DROP CONSTRAINT oldimage_oi_name_fkey" );
1135  }
1136  if ( $this->db->hasConstraint( "oldimage_oi_name_fkey_cascade" ) ) {
1137  $this->db->query(
1138  "ALTER TABLE oldimage DROP CONSTRAINT oldimage_oi_name_fkey_cascade" );
1139  }
1140  $this->output( "Making foreign key on table 'oldimage' (to image) a cascade delete/update\n" );
1141  $this->db->query(
1142  "ALTER TABLE oldimage ADD CONSTRAINT oldimage_oi_name_fkey_cascaded " .
1143  "FOREIGN KEY (oi_name) REFERENCES image(img_name) " .
1144  "ON DELETE CASCADE ON UPDATE CASCADE" );
1145  }
1146  }
1147 
1148  protected function checkPageDeletedTrigger() {
1149  if ( !$this->db->triggerExists( 'page', 'page_deleted' ) ) {
1150  $this->applyPatch(
1151  'patch-page_deleted.sql',
1152  false,
1153  "Adding function and trigger 'page_deleted' to table 'page'"
1154  );
1155  } else {
1156  $this->output( "...table 'page' has 'page_deleted' trigger\n" );
1157  }
1158  }
1159 
1160  protected function dropPgIndex( $table, $index ) {
1161  if ( $this->db->indexExists( $table, $index ) ) {
1162  $this->output( "Dropping obsolete index '$index'\n" );
1163  $this->db->query( "DROP INDEX \"" . $index . "\"" );
1164  }
1165  }
1166 
1167  protected function checkIndex( $index, $should_be, $good_def ) {
1168  $pu = $this->db->indexAttributes( $index );
1169  if ( !empty( $pu ) && $pu != $should_be ) {
1170  $this->output( "Dropping obsolete version of index '$index'\n" );
1171  $this->db->query( "DROP INDEX \"" . $index . "\"" );
1172  $pu = [];
1173  } else {
1174  $this->output( "...no need to drop index '$index'\n" );
1175  }
1176 
1177  if ( empty( $pu ) ) {
1178  $this->output( "Creating index '$index'\n" );
1179  $this->db->query( $good_def );
1180  } else {
1181  $this->output( "...index '$index' exists\n" );
1182  }
1183  }
1184 
1185  protected function checkRevUserFkey() {
1186  if ( $this->fkeyDeltype( 'revision_rev_user_fkey' ) == 'r' ) {
1187  $this->output( "...constraint 'revision_rev_user_fkey' is ON DELETE RESTRICT\n" );
1188  } else {
1189  $this->applyPatch(
1190  'patch-revision_rev_user_fkey.sql',
1191  false,
1192  "Changing constraint 'revision_rev_user_fkey' to ON DELETE RESTRICT"
1193  );
1194  }
1195  }
1196 
1197  protected function checkIwlPrefix() {
1198  if ( $this->db->indexExists( 'iwlinks', 'iwl_prefix' ) ) {
1199  $this->applyPatch(
1200  'patch-rename-iwl_prefix.sql',
1201  false,
1202  "Replacing index 'iwl_prefix' with 'iwl_prefix_title_from'"
1203  );
1204  }
1205  }
1206 
1207  protected function addInterwikiType() {
1208  $this->applyPatch( 'patch-add_interwiki.sql', false, "Refreshing add_interwiki()" );
1209  }
1210 
1211  protected function tsearchFixes() {
1212  # Tweak the page_title tsearch2 trigger to filter out slashes
1213  # This is create or replace, so harmless to call if not needed
1214  $this->applyPatch( 'patch-ts2pagetitle.sql', false, "Refreshing ts2_page_title()" );
1215 
1216  # If the server is 8.3 or higher, rewrite the tsearch2 triggers
1217  # in case they have the old 'default' versions
1218  # Gather version numbers in case we need them
1219  if ( $this->db->getServerVersion() >= 8.3 ) {
1220  $this->applyPatch( 'patch-tsearch2funcs.sql', false, "Rewriting tsearch2 triggers" );
1221  }
1222  }
1223 
1224  protected function rebuildTextSearch() {
1225  if ( $this->updateRowExists( 'patch-textsearch_bug66650.sql' ) ) {
1226  $this->output( "...T68650 already fixed or not applicable.\n" );
1227  return;
1228  };
1229  $this->applyPatch( 'patch-textsearch_bug66650.sql', false,
1230  'Rebuilding text search for T68650' );
1231  }
1232 }
DatabaseUpdater\output
output( $str)
Output some text.
Definition: DatabaseUpdater.php:215
PostgresUpdater\rebuildTextSearch
rebuildTextSearch()
Definition: PostgresUpdater.php:1224
PostgresUpdater\renameIndex
renameIndex( $table, $old, $new, $skipBothIndexExistWarning=false, $a=false, $b=false)
Rename an index from an existing table.
Definition: PostgresUpdater.php:824
PostgresUpdater\checkOiNameConstraint
checkOiNameConstraint()
Definition: PostgresUpdater.php:1127
PostgresUpdater\changeNullableField
changeNullableField( $table, $field, $null, $update=false)
Definition: PostgresUpdater.php:959
PostgresUpdater\getCoreUpdateList
getCoreUpdateList()
Definition: PostgresUpdater.php:44
PostgresUpdater\setDefault
setDefault( $table, $field, $default)
Definition: PostgresUpdater.php:936
PostgresUpdater\addPgEnumValue
addPgEnumValue( $type, $value)
Add a value to an existing PostgreSQL enum type.
Definition: PostgresUpdater.php:1015
DatabaseUpdater\applyPatch
applyPatch( $path, $isFullPath=false, $msg=null)
Applies a SQL patch.
Definition: DatabaseUpdater.php:668
false
processing should stop and the error should be shown to the user * false
Definition: hooks.txt:187
DatabaseUpdater
Class for handling database updates.
Definition: DatabaseUpdater.php:36
PostgresUpdater\convertArchive2
convertArchive2()
Definition: PostgresUpdater.php:1095
PostgresUpdater\dropFkey
dropFkey( $table, $field)
Definition: PostgresUpdater.php:1049
PostgresUpdater\checkPageDeletedTrigger
checkPageDeletedTrigger()
Definition: PostgresUpdater.php:1148
PostgresUpdater\describeIndex
describeIndex( $idx)
Definition: PostgresUpdater.php:677
PostgresUpdater\$db
DatabasePostgres $db
Definition: PostgresUpdater.php:37
PostgresUpdater\renameTable
renameTable( $old, $new, $patch=false)
Definition: PostgresUpdater.php:812
PostgresUpdater\fkeyDeltype
fkeyDeltype( $fkey)
Definition: PostgresUpdater.php:728
Wikimedia\Rdbms\DatabasePostgres
Definition: DatabasePostgres.php:33
$res
$res
Definition: database.txt:21
PostgresUpdater\checkIwlPrefix
checkIwlPrefix()
Definition: PostgresUpdater.php:1197
PostgresUpdater\changeField
changeField( $table, $field, $newtype, $default)
Definition: PostgresUpdater.php:882
php
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:35
DatabaseUpdater\$updates
array $updates
Array of updates to perform on the database.
Definition: DatabaseUpdater.php:44
PostgresUpdater\changeFieldPurgeTable
changeFieldPurgeTable( $table, $field, $newtype, $default)
Definition: PostgresUpdater.php:907
PostgresUpdater\addPgExtIndex
addPgExtIndex( $table, $index, $type)
Definition: PostgresUpdater.php:996
$query
null for the wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify $query
Definition: hooks.txt:1627
FROM
as see the revision history and available at free of to any person obtaining a copy of this software and associated documentation to deal in the Software without including without limitation the rights to and or sell copies of the and to permit persons to whom the Software is furnished to do subject to the following WITHOUT WARRANTY OF ANY EXPRESS OR INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY DAMAGES OR OTHER WHETHER IN AN ACTION OF TORT OR ARISING FROM
Definition: MIT-LICENSE.txt:10
PostgresUpdater\describeTable
describeTable( $table)
Definition: PostgresUpdater.php:652
PostgresUpdater\ruleDef
ruleDef( $table, $rule)
Definition: PostgresUpdater.php:750
PostgresUpdater\addPgIndex
addPgIndex( $table, $index, $type, $unique=false)
Definition: PostgresUpdater.php:986
use
as see the revision history and available at free of to any person obtaining a copy of this software and associated documentation to deal in the Software without including without limitation the rights to use
Definition: MIT-LICENSE.txt:10
PostgresUpdater\checkRevUserFkey
checkRevUserFkey()
Definition: PostgresUpdater.php:1185
DatabaseUpdater\updateRowExists
updateRowExists( $key)
Helper function: check if the given key is present in the updatelog table.
Definition: DatabaseUpdater.php:505
$command
$command
Definition: cdb.php:65
$value
$value
Definition: styleTest.css.php:49
PostgresUpdater
Class for handling updates to Postgres databases.
Definition: PostgresUpdater.php:32
PostgresUpdater\checkIndex
checkIndex( $index, $should_be, $good_def)
Definition: PostgresUpdater.php:1167
PostgresUpdater\changeFkeyDeferrable
changeFkeyDeferrable( $table, $field, $clause)
Definition: PostgresUpdater.php:1067
PostgresUpdater\renameSequence
renameSequence( $old, $new)
Definition: PostgresUpdater.php:793
PostgresUpdater\dropDefault
dropDefault( $table, $field)
Drop a default value from a field.
Definition: PostgresUpdater.php:951
PostgresUpdater\setSequenceOwner
setSequenceOwner( $table, $pkey, $seq)
Definition: PostgresUpdater.php:805
PostgresUpdater\addInterwikiType
addInterwikiType()
Definition: PostgresUpdater.php:1207
PostgresUpdater\dropSequence
dropSequence( $table, $ns)
Definition: PostgresUpdater.php:786
PostgresUpdater\addSequence
addSequence( $table, $pkey, $ns)
Definition: PostgresUpdater.php:774
as
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
Definition: distributors.txt:9
PostgresUpdater\tsearchFixes
tsearchFixes()
Definition: PostgresUpdater.php:1211
true
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return true
Definition: hooks.txt:2044
PostgresUpdater\addPgField
addPgField( $table, $field, $type)
Definition: PostgresUpdater.php:870
PostgresUpdater\dropPgField
dropPgField( $table, $field)
Definition: PostgresUpdater.php:858
class
you have access to all of the normal MediaWiki so you can get a DB use the etc For full docs on the Maintenance class
Definition: maintenance.txt:52
definition
Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for and distribution as defined by Sections through of this document Licensor shall mean the copyright owner or entity authorized by the copyright owner that is granting the License Legal Entity shall mean the union of the acting entity and all other entities that control are controlled by or are under common control with that entity For the purposes of this definition control direct or to cause the direction or management of such whether by contract or including but not limited to software source documentation and configuration files Object form shall mean any form resulting from mechanical transformation or translation of a Source including but not limited to compiled object generated and conversions to other media types Work shall mean the work of whether in Source or Object made available under the as indicated by a copyright notice that is included in or attached to the whether in Source or Object that is based or other modifications as a an original work of authorship For the purposes of this Derivative Works shall not include works that remain separable or merely the Work and Derivative Works thereof Contribution shall mean any work of including the original version of the Work and any modifications or additions to that Work or Derivative Works that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner For the purposes of this definition
Definition: APACHE-LICENSE-2.0.txt:49
PostgresUpdater\checkOiDeleted
checkOiDeleted()
Definition: PostgresUpdater.php:1115
PostgresUpdater\getOldGlobalUpdates
getOldGlobalUpdates()
Before 1.17, we used to handle updates via stuff like $wgExtNewTables/Fields/Indexes.
Definition: PostgresUpdater.php:613
PostgresUpdater\dropPgIndex
dropPgIndex( $table, $index)
Definition: PostgresUpdater.php:1160
$type
$type
Definition: testCompression.php:48