Manual:Maintenance scripts/ja

メンテナンススクリプトは管理、取り込み、維持、レポート、アップグレードなどさまざまな仕事を行うときに使われます. スクリプトはPHPで書かれており、MediaWikiをインストールしたディレクトリ配下の  にあります.

数十種のスクリプトがありますが、どれだけ一般的に役立ちどれだけの品質を持っているかはさまざまです. スクリプトを使う前には説明文書をしっかり読んでください. もし説明文書がなければ、スクリプトを実行する際さらに注意を払ってください.

設定
で設定した利用者に必要な権限がない場合、 と   の設定変数は必ず指定し、 のようにデータベースの構造を変更を必要とするメンテナンススクリプトを実行できるようにしてください. あるいは、 --dbuser と --dbpass のパラメーターを使ってこれらの値をスクリプトに渡すこともできます. これら変数の値はMediaWikiのインストールでどのデータベースエンジンを使うよう指定したかによって変わります. 設定しない場合、 で設定したユーザが使われます.

MySQL
セキュリティ上の理由から、MediaWikiの主たるデータベースアカウントが持つべきではないデータベース権限を必要とするメンテナンススクリプトがあります. '管理者'の権限を持つ別のデータベースアカウントを、MediaWikiデータベースだけのためにつくっておくべきです（もしまだ存在しないのであれば）. MediaWikiで使うデータベースの名前が  であれば、以下のSQLによりlocalhostにおいて管理者権限で実行できるそのような利用者を作成できます.

アカウントが既に存在するなら、そのアカウント名を  に設定してください. 他の設定変数と同じように、 も  に設定すべきです. のパスワードは  設定変数に必ず設定してください.

PostgreSQL
PostgreSQL は、MySQL とは異なるセキュリティ モデルを使用しており、MediaWiki インストレーションの日常的な操作に使用される同じ PostgreSQL サーバー アカウントを、メンテナンス スクリプトの実行にも使用する必要があります. これは、メンテナンス スクリプトによって作成された新しいテーブルの所有者が正しく設定されていることを確認するために必要です. You don't need to set  or   at all.

スクリプトの実行
The maintenance scripts must then be run from the command line. Users who do not access the server directly from its terminal will usually establish a connection through ssh. For Linux/Unix users this is by using the ssh client in a shell. For Windows users, one can use the SSH command line tool introduced in Windows 10 or alternatively use a third-party tool such as PuTTY shown below or use Windows Subsystem for Linux.

Required program for Windows users: PuTTY or any terminal emulator


 * Step 1: Download and run PuTTY, a terminal emulator.
 * Step 2: In PuTTy, under the Host Name (or IP address) enter the IP Address of your web hosting site (Contact your website provider if necessary) and click Open.


 * Step 3: A command screen will pop up. At the login as: line enter the FTP user name.


 * Step 4: Enter the FTP password.


 * Step 5: Change the current directory to the maintenance subdirectory. You can type  to see what folder you are currently in. The maintenance folder is in the root mediawiki folder.


 * Step 6: Execute the maintenance script that needs to be run:


 * If you get an error (for example: php.exe is no valid Win32 application), try the following:


 * Windows ではコマンドは以下の通りです:

標準のコマンドラインオプション
にあるほとんどすべてのPHPスクリプトでは以下に示す標準オプションが使えます.
 * --help
 * ヘルプ メッセージを表示します


 * --conf &lt;path&gt;
 * LocalSettings.php の場所. 指定しない場合は既定値（スクリプトの親ディレクトリ）が設定されます.


 * --dbuser &lt;username&gt;
 * LocalSettings.php で指定したものとは異なるデータベースアカウントを指定します. データベース接続を必要としないスクリプトや、バックエンドデータベースとしてSQLiteを指定した場合、この指定は無視されます.


 * --dbpass &lt;password&gt;
 * LocalSettings.php で指定したものとは異なるデータベースアカウントのパスワードを指定します. データベース接続を必要としないスクリプトや、バックエンドデータベースとしてSQLiteを指定した場合、この指定は無視されます.


 * --globals
 * デバッグのため処理の最後にグローバル変数の内容を出力します.


 * --memory-limit &lt;value&gt;
 * スクリプトが使えるメモリの上限値を設定します. 標準の php.ini で使える略記法（1024K、20M、1Gなど）を使った値を指定できます.  を指定すると制限なくメモリが使えます（指定しない場合の既定値）.   を指定すると設定を変更しません.


 * --quiet
 * エラーではない内容は出力しない.


 * --wiki &lt;id&gt;
 * ウィキファームのウィキID. IDは  または   の形で指定します. LocalSettings.php は   と   の定数に設定された値を使って実行されます.


 * --profiler
 * プロファイラーの出力書式（通常はtext）.


 * --mwdebug
 * あらかじめ用意されたMediaWiki開発者用設定を有効にする.

シンボリックリンクを使ったMediaWikiのインストール
MediaWikiのphpファイルが主となるインストールからのシンボリックリンクとなっていた場合、メンテナンススクリプトへのパスを LocalSettings.php ファイルに指定する必要があります. 例えば、

php maintenance/importImages.php --conf /var/wwwdata/website.org/wiki/LocalSettings.php /tmp/wikiimages .jpg .png .svg

そうしないとこのようなエラーが表示されるでしょう.

A copy of your installation's LocalSettings.php must exist and be readable in the source directory.

共有設定を使ったMediaWikiインストール（ファミリー型）
多言語用ウィキファミリーとしてMediaWikiをインストールし、設定（LocalSettings.php）を共通部分と言語個別部分に分ける場合があります（参照）. このとき、共通部分は /w ディレクトリの外に配置し、相対リンク（ ）を使ってアクセスします. この場合、メンテナンススクリプトを /w/maintenance ディレクトリで実行してもうまく動作しません. そうではなく、/w ディレクトリで以下のように実行してください.

シェルでアクセスできない場合
多くの共有ホストでは、シェルを使ってアクセスすることができません. その場合、 と の拡張機能を使ってウェブからメンテナンススクリプトを実行できるようにするといいでしょう.

メンテナンススクリプトの一覧
Instead of this probably-outdated list,


 * https://doc.wikimedia.org/mediawiki-core/master/php/ - View its generated documentation summary. (Files > File List > maintenance in the tabs or left-hand navigation sidebar)
 * https://doc.wikimedia.org/mediawiki-core/master/php/ - View its generated documentation summary. (Files > File List > maintenance in the tabs or left-hand navigation sidebar)

Here is the list of files included in the  subdirectory located at the root of a MediaWiki installation. You can contribute to this manual by keeping this list up to date, adding a description of these files' specific purpose and of how an administrator should use them (command line examples, etc.). Be aware that these were created and named on an ad hoc basis so have some usability issues.

関連項目

 * maintenance/README
 * maintenance/README
 * maintenance/README
 * maintenance/README
 * maintenance/README