Extension:DataDump

From mediawiki.org
This page is a translated version of the page Extension:DataDump and the translation is 100% complete.
Manuel des extensions MediaWiki
DataDump
État de la version : stable
Implémentation Base de données , Page spéciale
Description Fournit la page spéciale pour générer/supprimer/télécharger des vidages
Maintenance Miraheze system administrators
Dernière version continuous updates
MediaWiki 1.36.0+
PHP 7.2+
Modifie la base
de données
Oui
Composer miraheze/data-dump
Tables data_dump
Licence Licence publique générale GNU v3.0 ou supérieur
Téléchargement

  • $wgDataDump

  • view-dump
  • view-image-dump
  • generate-dump
  • delete-dump

L'extension DataDump fournit des moyens aux utilisateurs pour générer, supprimer ou télécharger le vidage de leurs données (dump) sans impliquer les administrateurs système.

Pour signaler un problème ou un bogue, veuillez utiliser Miraheze Phabricator. Voir le tableau de travail.

Installation

  • Télécharger et placez le(s) fichier(s) dans un répertoire appelé DataDump dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :
    wfLoadExtension( 'DataDump' );
    
  • Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
  • Configurer si nécessaire.
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

paramètre par défaut commentaire
$wgDataDump [] Cette configuration définit comment les vidages sont générés et quels sont leurs types.
$wgDataDumpInfo "" Ce paramètre définit l'information affichée au début de Special:DataDump.
$wgDataDumpLimits ["memory": 0, "filesize": 0, "time": 0, "walltime": 0] Ce paramètre définit les ressources allouées pour exécuter les scripts.
$wgDataDumpDirectory false Ce paramètre défiit le répertoire où les dumps seront stockés.
$wgDataDumpFileBackend false Ce paramètre définit le serveur à utiliser ($wgFileBackends)

Exemple

Voici un exemple sur la maniètre de définir les paramètres. Vous pouvez l'adapter à vos propres besoins :

$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';

Notez que ${filename} est remplacé de maniètre interne dans l'extension, donc assurez-vous qu'il s'agit d'une simple chaîne de caractères et non d'une double.

Le paramètre de limite spécifie combien de dumps peuvent être générés pour ce wiki.

Voir aussi