Extension:DataDump/zh

MediaWiki扩展手冊

DataDump 發佈狀態： 穩定版本
实现	数据库 , 特殊页面
描述	Provides the Special page to generate/delete/download dumps
维护者	Miraheze system administrators
最新版本	continuous updates
MediaWiki	1.36.0+
PHP	7.2+
数据库更改	是
Composer	miraheze/datadump
表	data_dump
许可协议	GNU通用公眾授權條款3.0或更新版本
下載	GitHub: 项目页面 git存储库URL [帮助 ] 提交历史 注意： 无法由translatewiki.net 提供本地化更新。
參數 $wgDataDump
添加的权限 view-dump view-image-dump generate-dump delete-dump
使用的钩子 LoadExtensionSchemaUpdates
Public wikis using	163 (Ranked 433rd)

The DataDump extension provides means for users to generate, delete or download their dump without the involvement of sysadmins.

For reporting an issue or a bug, please use Miraheze Phabricator. See here for the workboard.

Installation

• 下载文件，并将其放置在您extensions/文件夹中的DataDump目录内。
• 将下列代码放置在您的LocalSettings.php 的底部：

  wfLoadExtension( 'DataDump' );
  

• 运行更新脚本，它将自动创建此扩展必须依赖的数据库表。
• Configure as required.
•  完成 – 在您的wiki上导航至Special:Version，以验证已成功安装扩展。

Configuration

parameter	default	comment
$wgDataDump	[]	This config defines how dumps are generated and which types of dumps there are.
$wgDataDumpInfo	""	This config defines the information displayed atop Special:DataDump.
$wgDataDumpLimits	["memory": 0, "filesize": 0, "time": 0, "walltime": 0]	This config defines resources allocated to running scripts.
$wgDataDumpDirectory	false	This config defines the directory where to store the dumps.
$wgDataDumpFileBackend	false	This config defines backend to use ($wgFileBackends)

Example

This is an example on how to setup the configuration. You can tailor it to your specific needs:

$wgDataDumpDirectory = "<path>${wgDBname}/";

$wgDataDump = [
    'xml' => [
        'file_ending' => '.xml.gz',
        'generate' => [
            'type' => 'mwscript',
            'script' => "$IP/maintenance/dumpBackup.php",
            'options' => [
                '--full',
                '--output',
                "gzip:${wgDataDumpDirectory}" . '${filename}',
            ],
        ],
        'limit' => 1,
        'permissions' => [
            'view' => 'view-dump',
            'generate' => 'generate-dump',
            'delete' => 'delete-dump',
        ],
    ],
    'image' => [
        'file_ending' => '.zip',
        'generate' => [
            'type' => 'script',
            'script' => '/usr/bin/zip',
            'options' => [
                '-r',
                '<path>${filename}',
                "<path>${wgDBname}/"
            ],
        ],
        'limit' => 1,
        'permissions' => [
            'view' => 'view-dump',
            'generate' => 'view-image-dump',
            'delete' => 'delete-dump',
        ],
    ],
];

$wgAvailableRights[] = 'view-dump';
$wgAvailableRights[] = 'view-image-dump';
$wgAvailableRights[] = 'generate-dump';
$wgAvailableRights[] = 'delete-dump';

Note that ${filename} is replaced internally in the extension so make sure that it is always in a single string not in a double string.

The limit parameter specifies how many dumps can be generated for that wiki.

See also

• 手册:备份一个维基
• Extension:DumpsOnDemand