Manuel:Revision.php

This page is a translated version of the page Manual:Revision.php and the translation is 97% complete.
Outdated translations are marked like this.
Version de MediaWiki :
1.36
Gerrit change 684071

La classe Revision représente une révision MediaWiki.

Cette classe a été déclarée obsolète dans MediaWiki 1.31, en faveur de RevisionRecord (doc), RevisionStore (doc) et SqlBlobStore (doc). Elle a été complètement supprimée dans MediaWiki 1.37. Voir Manuel:Revision.php/Migration .

Créer un nouvel objet Revision

Pour instancier Revision, appelez l'une des méthodes statiques d'usine :

  • loadFromId( $db, $id ) - charge une révision de page à partir d'un numéro d'identification de révision donné.
  • loadFromPageId( $db, $pageid, $id = 0 ) - charge soit la version actuelle, soit une révision spécifiée attachée à une page donnée.
  • loadFromTimestamp( $db, $title, $timestamp ) - charge la révision correspondant au titre et à l'horodatage donnés.
  • loadFromTitle( $db, $title, $id = 0 ) - charge soit la révision actuelle, ou une révision spécifiée attachée à une page donnée.
  • newFromArchiveRow( $row, $overrides = array() ) - crée un objet de révision fictif à partir d'une ligne de table d'archives.
  • newFromId( $id, $flags = 0 ) - charge une révision de page à partir d'un numéro d'identification de révision donné.
  • newFromPageId( $pageId, $revId = 0, $flags = 0 ) - charge soit la révision actuelle, soit une révision spécifiée attachée à un identifiant de page donné.
  • newFromRow( $row )
  • newFromTitle( $title, $id = 0, $flags = 0 ) - charge soit la révision courante, ou une révision spécifiée attachée à un titre donné.
  • newNullRevision( $dbw, $pageId, $summary, $minor ) - crée une nouvelle revision nulle à insérer dans l'historique d'une page.

Méthodes

  • getContent( $audience = self::FOR_PUBLIC, User $user = null ) - récupère le contenu de la révision si il est disponible pour le public spécifié. Si le public spécifié n'a pas la possibilité de voir cette révision, null sera renvoyé.
  • getText( $audience = Revision::FOR_PUBLIC, User $user = null ) (obsolète depuis v. 1.21) voir la Migration dans le manuel du gestionnaire de contenu.
  • base36Sha1( $text ) c'est juste wfBaseConvert( sha1( $text ), 16, 36, 31 )

Accesseurs

  • getRecentChange() - obtenir l'objet RC appartenant à la révision actuelle, s'il existe.
  • getNext() - obtenir la révision suivante pour ce titre.
  • getPrevious() - obtenir la révision précédente pour ce titre.
  • getTitle() - renvoie le titre de la page associée à cette entrée, ou null.

Audience

Une valeur parmi :

  • Revision::FOR_PUBLIC - à afficher pour tous les utilisateurs
  • Revision::FOR_THIS_USER - à afficher pour $wgUser
  • Revision::RAW - récupérer le texte quelque soit les droits d'accès