Extension:DataDump

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
Auteur(s)	Paladox, Universal Omega
Maintenance	Miraheze system administrators
Dernière version	continuous updates
MediaWiki	>= 1.43.0
PHP	7.4+
Modifie la base de données	Oui
Composer	miraheze/data-dump
Tables data_dump
Paramètres $wgDataDumpDisableGenerate $wgDataDumpAllowRetries $wgDataDumpLimits $wgDataDumpDirectory $wgDataDumpFileBackend $wgDataDump
Droits ajoutés generate-dump delete-dump view-dump
Accroches utilisées LoadExtensionSchemaUpdates
Licence	Licence publique générale GNU v3.0 ou ultérieur
Téléchargement	GitHub: page du projet URL du dépôt git historique des validations Note : Aucune mise à jour de localisation n'est fournie par translatewiki.net .

DataDump permet aux utilisateurs de demander et de générer des vidages (dump) de la base de données. Les autres types de vidages, comme les images, peuvent se configurer dans l'extension. Cela permet un vidage facile sans nécessiter l'intervention d'un administrateur du 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.
• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

Paramètre	Valeur par défaut	Commentaire
$wgDataDump	[]	définit comment les vidages sont générés et quels sont leurs types.
$wgDataDumpDirectory	false	définit le répertoire où les dumps seront stockés.
$wgDataDumpDisableGenerate	false	indique si DataDump doit être désactivé ou non.
$wgDataDumpFileBackend	false	définit le serveur à utiliser ($wgFileBackends)
$wgDataDumpInfo	""	définit l'information affichée au début de Special:DataDump.
$wgDataDumpLimits	["memory": 0, "filesize": 0, "time": 0, "walltime": 0]	définit les ressources allouées pour exécuter les scripts.

Droits

DataDump fournit trois privilèges. Cela vous permet une certaine granularité pour configurer DataDump.

Vous n'êtes pas limité à utiliser ces autorisations uniquement pour restreindre qui peut télécharger, afficher ou supprimer les vidages. Vous pouvez également utiliser d'autres droits disponibles sur le wiki.

Droit	Commentaire
generate-dump	Permet aux utilisateurs de générer des vidages de la base de données
view-dump	Permet aux utilisateurs d'explorer les vidages.
delete-dump	Permet aux utilisateurs de supprimer les vidages

Exemple

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

$wgDataDumpDirectory = "/var/backups/${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',
        ],
    ],
    'zip' => [
        'file_ending' => '.zip',
        'generate' => [
            'type' => 'script',
            'script' => '/usr/bin/zip',
            'options' => [
                '-r',
                "${wgDataDumpDirectory}" . '${filename}',
                "$IP/images/"
            ],
        ],
        'limit' => 1,
        'permissions' => [
            'view' => 'view-dump',
            'generate' => 'generate-dump',
            'delete' => '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.

Résolution des problèmes

Si vous rencontrez des problèmes avec les vidages de données en échec, regardez le journal de la file d'attente des tâches . Vous pouvez chercher dans DataDumpGenerateJob pour identifier le moment où la file d'attente des tâches exécute votre vidage.

Emplacement du binaire PHP

Si le fichier de votre journal contient quelque chose de semblable à : [exec] Possibly missing executable file: '/usr/bin/php', alors vérifiez que $wgPhpCli est initialisé à une valeur correcte pour votre environnement. Vous pouvez utiliser whereis php pour la double vérification.

Outils de compression

Si le fichier de votre journal contient quelque chose de semblable à : [exec] Possibly missing executable file: '/usr/bin/zip', alors vérifiez que l'outil de compression pour votre tâche est effectivement installé sur l'hôte.

Voir aussi

• Manuel:Faire la sauvegarde d'un wiki
• Extension:DumpsOnDemand