Manual:update.php
Jump to navigation
Jump to search
| MediaWiki ファイル: update.php | |
|---|---|
| 場所: | maintenance/ |
| ソース コード: | master • 1.36.0 • 1.35.2 • 1.31.14 |
| クラス: | UpdateMediaWiki |
詳細
update.php は MediaWiki データベース スキーマが新しいバージョンの MediaWiki に対応させるためのアップデートが必要かどうかを確認します。
MediaWiki のアップグレードや、スキーマのアップデートを必要とする拡張機能のインストールまたはアップデートを行った際には、update.php を実行すべきです。
スキーマのアップデートを必要とする拡張機能のほとんどは説明文書の中でそのことに言及しています。
ブラウザーで
自分のサーバーのコマンド ラインへのアクセス権がない場合は、更新スクリプトを実行するためにウェブ アップデーターを使用してください。
コマンドラインで
コマンドラインや SSH シェルなどから:
- 現在のディレクトリを
maintenanceに変更します - 更新スクリプトを実行します:
$ php update.php
 警告: | update.php may exit with errors, leaving the database in an inconsistent state. Always backup the database before running the script! |
This maintenance script can be disabled via $wgAllowSchemaUpdates. People with extremely large and busy wikis may need to do upgrades with care, but if you're not sure if that applies to you, then it probably doesn't.
Use the following on Vagrant instances (from within your vagrant ssh).
$ mwscript update.php
パラメーター
This script offers several parameters (generic, script dependent and script specific) which may be required in some wiki environments.
Generic maintenance parameters
--help- used to get a prompt of all available script parameters (generic, script dependent and script specific) together with short explanations of their usage. These are less often used parameters.
--wiki wikiId- update wiki family if database name depends on virtual host, where wikiId - database name (e.g. enwiki, dewiki ...)
スクリプト固有のパラメーター
--quick- skip countdown sequence
--nopurge- do not purge objectcache table. Normally
update.phppurges the objectcache table (generally contains the parser cache and the messages cache), msg_resource and msg_resource_links (these are used for ResourceLoader message caching and are cleared in 1.21 and later) tables in the database, if you don't want to purge this table, use the--nopurgeoption. --doshared- Update shared tables as well.
--force- Run this script even if it is disabled by configuration options.
--conf- Specifies the config file (the LocalSettings.php file for the specific wiki). Used for wiki families.
--noschema- All changes to the table structure or table additions are skipped. Only data changes are made.
--schema- No schema changes are made to the database, but the schema changes are saved to a separate SQL file that can be run.
Allows "update.php" to be run when $wgAllowSchemaUpdates is set to false. This is useful for non-WMF environments where strict DB permissions allow database updates (which "update.php" performs), but no schema changes (such as adding or dropping tables or indices which "update.php" also performs).
--skip-compat-checks- Skips compatibility checks
--skip-external-dependencies- when using composer.local.json to let Composer install extensions and their dependencies, you may see an error message saying that there is a mismatch between the installed and required version (e.g. "mediawiki/semantic-breadcrumb-links: 1.3.0 installed, ~1.3 required"). You can use this parameter to ignore the message and run update.php regardless.
| 警告: | 開発者のみが使用することを推奨します。 |
Extensions can install/update their schemas using LoadExtensionSchemaUpdates hook.
関連項目
- For detailed instruction on using
update.php, see Manual:アップグレード, Manual:Upgrading#Command_line