Manual:DumpBackup.php/ja

詳細
dumpBackup.phpはエキスポートもしくはバックアップのために XMLファイルを作成します. XMLダンプはwikiコンテンツ (各ページのすべての版) を含みますが、サイト関連データは含みません. DumpBack.php はウィキ データベースのフルバックアップは行わず、利用者アカウント、アップロードファイル、編集記録、削除された版などは含まれません. ダンプを作成した後、XMLをインポートできます.

例


一般的な例
ダンプファイルの名前を決める必要があります.

例えば、すべての変更履歴 ( --full) を  に保存する場合:


 * 例として使用しているdump.xmlの詳細は下の詳細な例を参照してください. 

データダンプは 名前空間 ひとつに制限可能です. 最新の版のテンプレートのみの場合:

すべての版のテンプレートの場合 :

複数の名前空間を含めるには :

プラグインの使用例:

 php dumpBackup.php \ --plugin=AbstractFilter:extensions/ActiveAbstract/AbstractFilter.php \ --current \ --output=gzip:/dumps/abstract.xml.gz \ --filter=namespace:NS_MAIN \ --filter=noredirect \ --filter=abstract \ --quiet

または

 php dumpBackup.php \ --plugin=MathMLFilter:../extensions/MathSearch/maintenance/MathMLFilter.php \ --current \ --filter=namespace:NS_MAIN \ --filter=mathml \ --quiet

The  option can be used with.

To  :

 php dumpBackup.php \ --full \ --include-files \ --uploads \ --output=gzip:/dumps/abstract.xml.gz \ --quiet

 オプションも使用する必要があります. そうでないと、ファイルが含まれません.



詳細な例
この例で、 緑色の文字 が入力した文字です


 * 1) cdコマンドを使用してmaintenanceフォルダに移動します. maintenanceフォルダはご使用の環境により変化します.
 * 2) php dumpBackup.php --full > dump.xml と入力して、Enterキーを押します. 次のような長いリストが表示されます.

新しいxmlファイルがmaintenanceフォルダに作成されます (xmlファイルを表示するにはSCPを更新する必要がある場合があります).

オプション
MediaWiki 以降:

 This script dumps the wiki page or logging database into an XML interchange wrapper format for export or backup.

XML output is sent to stdout; progress reports are sent to stderr.

Usage: php dumpBackup.php [ ] Actions: --full     Dump all revisions of every page. --current  Dump only the latest revision of every page. --logs     Dump all log events. --stable   Stable versions of pages? --pagelist= Where is a list of page titles to be dumped --revrange Dump specified range of revisions, requires revstart and revend options. Options: --quiet    Don't dump status reports to stderr. --report=n Report position and speed after every n pages processed. (Default: 100) --server=h Force reading from MySQL server h  --start=n   Start from page_id or log_id n  --end=n     Stop before page_id or log_id n (exclusive) --revstart=n Start from rev_id n  --revend=n    Stop before rev_id n (exclusive) --skip-header Don't output the header --skip-footer Don't output the footer --stub     Don't perform old_text lookups; for 2-pass dump --uploads  Include upload records without files --include-files Include files within the XML stream --conf= Use the specified configuration file (LocalSettings.php)

--wiki= Only back up the specified

Fancy stuff: (Works? Add examples please.) --plugin= [: ]  Load a dump plugin class --output= :     Begin a filtered output stream; s: file, gzip, bzip2, 7zip --filter= [: ] Add a filter on an output branch --7ziplevel=<0-10>         Level of 7zip compression (0 - no compression is default)

このスクリプトは通常で設定されたとを使用してデータベースに接続します. 通常$wgDBadminuserはより強い権限を持つユーザーですが、 を実行するために追加の権限は必要ないため、ユーザー名とパスワードは同じ場合があります. もし変数が設定されていない場合、 はデータベースへの接続に失敗します.

 $ php dumpBackup.php --full DB connection error: Unknown error

注記
XMLファイルは標準出力(stdout)に出力され、進捗状況は標準エラー出力(stderr)に出力されます. これらは既定の出力とエラー出力です. このスクリプトをシェルから呼び出すと、両方の出力は既定通りシェルに送信され、"データ"の出力とエラーが画面に表示されます.



エラー メッセージ
もしカレントディレクトリが間違っている場合は、次のメッセージが表示されます.

 No input file specified.

"--report"の後ろの変数が0もしくは数字でない場合、" "と表示されます. 解決策として、"--report"オプションなしでdumpBackupを実行します. その場合、100ページごとに進捗状況が出力されます.



推奨される環境設定

 * すべての版がオブジェクトキャッシュに挿入されないように、 を 0 に設定する必要があります. wikiの読者は通常、ランダムに古い版を読むことはないので、それらがキャッシュに保存される必要性は低いです.



関連項目

 * Dumps/Software dependencies
 * 例とラッパースクリプト
 * xmldumps-backup contains scripts used by the Wikimedia Foundation, python scripts have some documentation; see also wikitech:Category:Dumps (some examples on Dumps/Rerunning_a_job for now).
 * Wikia's WikiFactory/Dumps
 * 例とラッパースクリプト
 * xmldumps-backup contains scripts used by the Wikimedia Foundation, python scripts have some documentation; see also wikitech:Category:Dumps (some examples on Dumps/Rerunning_a_job for now).
 * Wikia's WikiFactory/Dumps