Manual:DumpBackup.php/fr

Détails
Le fichier dumpBackup.php vide les données dans un fichier XML pour l'exportation ou la sauvegarde. Ces données au format XML sont le contenu du wiki (pages wiki avec toutes les révisions), mais sans les données relatives au site. DumpBackup.php ne crée pas de sauvegarde complète de la base de données du wiki, le vidage ne contient pas les comptes des utilisateurs, les images, les jounaux des modifications, les révisions supprimées, etc. Une fois que le vidage est terminé, vous pouvez importer le vidage XML.

General examples
Vous devez choisir un nom pour le vidage des données.

Par exemple l'utilisateur ici sauvegarde toutes ses révisions de l'historique dans un fichier appelé   :


 * Pour plus de détails sur cet exemple dump.xml, voir ci-dessous.

Vous pouvez restreindre le vidage des données à un espace de noms particulier. Dans cet exemple il n'y a que des modèles :

or templates with all of their revisions:

Pour include de multiples espaces de noms, faire :

Exemple d'utilisation d'un plugin :

 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

ou

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

L'option  peut être utilisée avec.

Pour   :

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

L'option   doit aussi être utilisée. Sinon aucun fichier ne sera inclus.

Exemple détaillé
Dans cet exemple, le texte en vert est le texte que vous entrez.


 * 1) Redirigez vers le répertoire de maintenance en utilisant la commande cd. L'emplacement de votre répertoire de maintenance peut être différent de celui de l'exemple.
 * 2) Saisissez php dumpBackup.php --full > dump.xml et cliquez sur Entrée.  Une longue liste de code est créée, similaire à l'exemple ci-dessous.

Le nouveau fichier XML sera créé dans le répertoire de maintenance (rafraîchissez éventuellement votre SCP pour voir ce fichier).

Options
De 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)

Ce script se connecte à la base de données en utilisant le nom d'utilisateur et le mot de passe définis par et, qui sont normalement déclarés dans. Bien que soit obsolète, il peut utiliser le nom d'utilisateur et le mot de passe initialisé dans ce fichier également. Habituellement $wgDBadminuser est un utilisateur avec davantage de privilèges que celui de, mais pour exécuter  il n'y a pas besoin de privilèges supplémentaires, donc les noms d'utilisateur et les mots de passe peuvent être les mêmes. Si les variables ne sont pas initialisées,  va échouer en essayant de se connecter à la base de données :

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

Messages d'erreur
Si vous n'êtes pas dans le bon répertoire, vous recevrez ce message :

 No input file specified.

Le script dumpBackup indique «  » lorsque l'évaluation du paramètre après « --report » donne 0 ou n'est pas un nombre. Le palliatif est d'exécuter dumpBackup sans l'option « --report » ; ensuite dumpBackup imprimera une ligne d'état chaque fois qu'il aura traité 100 pages.

Paramètres de configuration recommandés

 * doit être mis à 0 pour éviter d'insérer toutes les révisions dans l'objet cache. La plupart d'entre elles ne bénéficiera pas de l'enregistrement dans le cache parce que vos lecteurs n'iront pas voir au hasard d'anciennes révisions des pages de votre wiki.

Voir aussi

 * Dumps/Software dependencies
 * Exemples et scripts d'enveloppe
 * xmldumps-backup contient des scripts utilisés par la Fondation Wikimedia, les scripts Python possèdent un peu de documentation; voir aussi wikitech:Category:Dumps (certains exemples sur Dumps/Rerunning_a_job pour l'instant).
 * WikiFactory/Dumps de Wikia
 * Exemples et scripts d'enveloppe
 * xmldumps-backup contient des scripts utilisés par la Fondation Wikimedia, les scripts Python possèdent un peu de documentation; voir aussi wikitech:Category:Dumps (certains exemples sur Dumps/Rerunning_a_job pour l'instant).
 * WikiFactory/Dumps de Wikia