5 * Copyright © 2003, 2005, 2006 Brion Vibber <brion@pobox.com>
6 * https://www.mediawiki.org/
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21 * http://www.gnu.org/copyleft/gpl.html
25 use MediaWiki\MediaWikiServices
;
26 use MediaWiki\Revision\RevisionRecord
;
27 use MediaWiki\Revision\RevisionStore
;
28 use MediaWiki\Revision\SlotRecord
;
29 use MediaWiki\Revision\SuppressedDataException
;
30 use MediaWiki\Storage\SqlBlobStore
;
31 use Wikimedia\Assert\Assert
;
38 /** Output serialized revision content. */
39 const WRITE_CONTENT
= 0;
41 /** Only output subs for revision content. */
45 * Only output subs for revision content, indicating that the content has been
46 * deleted/suppressed. For internal use only.
48 const WRITE_STUB_DELETED
= 2;
51 * @var string[] the schema versions supported for output
54 public static $supportedSchemas = [
55 XML_DUMP_SCHEMA_VERSION_10
,
56 XML_DUMP_SCHEMA_VERSION_11
60 * @var string which schema version the generated XML should comply to.
61 * One of the values from self::$supportedSchemas, using the SCHEMA_VERSION_XX
64 private $schemaVersion;
67 * Title of the currently processed page
71 private $currentTitle = null;
74 * @var int Whether to output revision content or just stubs. WRITE_CONTENT or WRITE_STUB.
79 * XmlDumpWriter constructor.
81 * @param int $contentMode WRITE_CONTENT or WRITE_STUB.
82 * @param string $schemaVersion which schema version the generated XML should comply to.
83 * One of the values from self::$supportedSchemas, using the XML_DUMP_SCHEMA_VERSION_XX
86 public function __construct(
87 $contentMode = self
::WRITE_CONTENT
,
88 $schemaVersion = XML_DUMP_SCHEMA_VERSION_11
91 in_array( $contentMode, [ self
::WRITE_CONTENT
, self
::WRITE_STUB
] ),
93 'must be one of the following constants: WRITE_CONTENT or WRITE_STUB.'
97 in_array( $schemaVersion, self
::$supportedSchemas ),
99 'must be one of the following schema versions: '
100 . implode( ',', self
::$supportedSchemas )
103 $this->contentMode
= $contentMode;
104 $this->schemaVersion
= $schemaVersion;
108 * Opens the XML output stream's root "<mediawiki>" element.
109 * This does not include an xml directive, so is safe to include
110 * as a subelement in a larger XML stream. Namespace and XML Schema
111 * references are included.
113 * Output will be encoded in UTF-8.
117 function openStream() {
118 $ver = $this->schemaVersion
;
119 return Xml
::element( 'mediawiki', [
120 'xmlns' => "http://www.mediawiki.org/xml/export-$ver/",
121 'xmlns:xsi' => "http://www.w3.org/2001/XMLSchema-instance",
123 * When a new version of the schema is created, it needs staging on mediawiki.org.
124 * This requires a change in the operations/mediawiki-config git repo.
126 * Create a changeset like https://gerrit.wikimedia.org/r/#/c/149643/ in which
127 * you copy in the new xsd file.
129 * After it is reviewed, merged and deployed (sync-docroot), the index.html needs purging.
130 * echo "https://www.mediawiki.org/xml/index.html" | mwscript purgeList.php --wiki=aawiki
132 'xsi:schemaLocation' => "http://www.mediawiki.org/xml/export-$ver/ " .
133 "http://www.mediawiki.org/xml/export-$ver.xsd",
135 'xml:lang' => MediaWikiServices
::getInstance()->getContentLanguage()->getHtmlCode() ],
144 function siteInfo() {
150 $this->caseSetting(),
151 $this->namespaces() ];
152 return " <siteinfo>\n " .
153 implode( "\n ", $info ) .
160 function sitename() {
162 return Xml
::element( 'sitename', [], $wgSitename );
170 return Xml
::element( 'dbname', [], $wgDBname );
176 function generator() {
178 return Xml
::element( 'generator', [], "MediaWiki $wgVersion" );
184 function homelink() {
185 return Xml
::element( 'base', [], Title
::newMainPage()->getCanonicalURL() );
191 function caseSetting() {
192 global $wgCapitalLinks;
193 // "case-insensitive" option is reserved for future
194 $sensitivity = $wgCapitalLinks ?
'first-letter' : 'case-sensitive';
195 return Xml
::element( 'case', [], $sensitivity );
201 function namespaces() {
202 $spaces = "<namespaces>\n";
203 $nsInfo = MediaWikiServices
::getInstance()->getNamespaceInfo();
205 MediaWikiServices
::getInstance()->getContentLanguage()->getFormattedNamespaces()
209 Xml
::element( 'namespace',
212 'case' => $nsInfo->isCapitalized( $ns )
213 ?
'first-letter' : 'case-sensitive',
216 $spaces .= " </namespaces>";
221 * Closes the output stream with the closing root element.
222 * Call when finished dumping things.
226 function closeStream() {
227 return "</mediawiki>\n";
231 * Opens a "<page>" section on the output stream, with data
232 * from the given database row.
237 public function openPage( $row ) {
239 $this->currentTitle
= Title
::newFromRow( $row );
240 $canonicalTitle = self
::canonicalTitle( $this->currentTitle
);
241 $out .= ' ' . Xml
::elementClean( 'title', [], $canonicalTitle ) . "\n";
242 $out .= ' ' . Xml
::element( 'ns', [], strval( $row->page_namespace
) ) . "\n";
243 $out .= ' ' . Xml
::element( 'id', [], strval( $row->page_id
) ) . "\n";
244 if ( $row->page_is_redirect
) {
245 $page = WikiPage
::factory( $this->currentTitle
);
246 $redirect = $page->getRedirectTarget();
247 if ( $redirect instanceof Title
&& $redirect->isValidRedirectTarget() ) {
249 $out .= Xml
::element( 'redirect', [ 'title' => self
::canonicalTitle( $redirect ) ] );
254 if ( $row->page_restrictions
!= '' ) {
255 $out .= ' ' . Xml
::element( 'restrictions', [],
256 strval( $row->page_restrictions
) ) . "\n";
259 Hooks
::run( 'XmlDumpWriterOpenPage', [ $this, &$out, $row, $this->currentTitle
] );
265 * Closes a "<page>" section on the output stream.
270 function closePage() {
271 if ( $this->currentTitle
!== null ) {
272 $linkCache = MediaWikiServices
::getInstance()->getLinkCache();
273 // In rare cases, link cache has the same key for some pages which
274 // might be read as part of the same batch. T220424 and T220316
275 $linkCache->clearLink( $this->currentTitle
);
281 * @return RevisionStore
283 private function getRevisionStore() {
284 return MediaWikiServices
::getInstance()->getRevisionStore();
288 * @return SqlBlobStore
290 private function getBlobStore() {
291 return MediaWikiServices
::getInstance()->getBlobStore();
295 * Dumps a "<revision>" section on the output stream, with
296 * data filled in from the given database row.
299 * @param null|object[] $slotRows
303 * @throws MWException
306 function writeRevision( $row, $slotRows = null ) {
307 $rev = $this->getRevisionStore()->newRevisionFromRowAndSlots(
314 $out = " <revision>\n";
315 $out .= " " . Xml
::element( 'id', null, strval( $rev->getId() ) ) . "\n";
317 if ( $rev->getParentId() ) {
318 $out .= " " . Xml
::element( 'parentid', null, strval( $rev->getParentId() ) ) . "\n";
321 $out .= $this->writeTimestamp( $rev->getTimestamp() );
323 if ( $rev->isDeleted( Revision
::DELETED_USER
) ) {
324 $out .= " " . Xml
::element( 'contributor', [ 'deleted' => 'deleted' ] ) . "\n";
326 // empty values get written out as uid 0, see T224221
327 $user = $rev->getUser();
328 $out .= $this->writeContributor(
329 $user ?
$user->getId() : 0,
330 $user ?
$user->getName() : ''
334 if ( $rev->isMinor() ) {
335 $out .= " <minor/>\n";
337 if ( $rev->isDeleted( Revision
::DELETED_COMMENT
) ) {
338 $out .= " " . Xml
::element( 'comment', [ 'deleted' => 'deleted' ] ) . "\n";
341 . Xml
::elementClean( 'comment', [], strval( $rev->getComment()->text
) )
345 $contentMode = $rev->isDeleted( Revision
::DELETED_TEXT
) ? self
::WRITE_STUB_DELETED
346 : $this->contentMode
;
348 foreach ( $rev->getSlots()->getSlots() as $slot ) {
349 $out .= $this->writeSlot( $slot, $contentMode );
352 if ( $rev->isDeleted( Revision
::DELETED_TEXT
) ) {
353 $out .= " <sha1/>\n";
355 $out .= " " . Xml
::element( 'sha1', null, strval( $rev->getSha1() ) ) . "\n";
358 // Avoid PHP 7.1 warning from passing $this by reference
360 $text = $rev->getContent( SlotRecord
::MAIN
, RevisionRecord
::RAW
);
361 Hooks
::run( 'XmlDumpWriterWriteRevision', [ &$writer, &$out, $row, $text, $rev ] );
363 $out .= " </revision>\n";
369 * @param SlotRecord $slot
370 * @param int $contentMode see the WRITE_XXX constants
374 private function writeSlot( SlotRecord
$slot, $contentMode ) {
375 $isMain = $slot->getRole() === SlotRecord
::MAIN
;
376 $isV11 = $this->schemaVersion
>= XML_DUMP_SCHEMA_VERSION_11
;
378 if ( !$isV11 && !$isMain ) {
379 // ignore extra slots
387 // non-main slots are wrapped into an additional element.
388 $out .= ' ' . Xml
::openElement( 'content' ) . "\n";
390 $out .= $indent . Xml
::element( 'role', null, strval( $slot->getRole() ) ) . "\n";
394 $out .= $indent . Xml
::element( 'origin', null, strval( $slot->getOrigin() ) ) . "\n";
397 $contentModel = $slot->getModel();
398 $contentHandler = ContentHandler
::getForModelID( $contentModel );
399 $contentFormat = $contentHandler->getDefaultFormat();
401 // XXX: The content format is only relevant when actually outputting serialized content.
402 // It should probably be an attribute on the text tag.
403 $out .= $indent . Xml
::element( 'model', null, strval( $contentModel ) ) . "\n";
404 $out .= $indent . Xml
::element( 'format', null, strval( $contentFormat ) ) . "\n";
407 'xml:space' => 'preserve',
408 'bytes' => $slot->getSize(),
412 $textAttributes['sha1'] = $slot->getSha1();
415 if ( $contentMode === self
::WRITE_CONTENT
) {
418 $out .= $this->writeText( $slot->getContent(), $textAttributes, $indent );
419 } catch ( SuppressedDataException
$ex ) {
420 // NOTE: this shouldn't happen, since the caller is supposed to have checked
421 // for suppressed content!
422 // write <text> placeholder tag
423 $textAttributes['deleted'] = 'deleted';
424 $out .= $indent . Xml
::element( 'text', $textAttributes ) . "\n";
426 catch ( Exception
$ex ) {
427 if ( $ex instanceof MWException ||
$ex instanceof RuntimeException
) {
428 // there's no provision in the schema for an attribute that will let
429 // the user know this element was unavailable due to error; an empty
430 // tag is the best we can do
431 $out .= $indent . Xml
::element( 'text' ) . "\n";
433 'failed to load content slot ' . $slot->getRole() . ' for revision '
434 . $slot->getRevision() . "\n"
440 } elseif ( $contentMode === self
::WRITE_STUB_DELETED
) {
441 // write <text> placeholder tag
442 $textAttributes['deleted'] = 'deleted';
443 $out .= $indent . Xml
::element( 'text', $textAttributes ) . "\n";
445 // write <text> stub tag
447 $textAttributes['location'] = $slot->getAddress();
450 // Output the numerical text ID if possible, for backwards compatibility.
451 // Note that this is currently the ONLY reason we have a BlobStore here at all.
452 // When removing this line, check whether the BlobStore has become unused.
453 $textId = $this->getBlobStore()->getTextIdFromAddress( $slot->getAddress() );
455 $textAttributes['id'] = $textId;
456 } elseif ( !$isV11 ) {
457 throw new InvalidArgumentException(
458 'Cannot produce stubs for non-text-table content blobs with schema version '
459 . $this->schemaVersion
463 $out .= $indent . Xml
::element( 'text', $textAttributes ) . "\n";
467 $out .= ' ' . Xml
::closeElement( 'content' ) . "\n";
474 * @param Content $content
475 * @param string[] $textAttributes
476 * @param string $indent
480 private function writeText( Content
$content, $textAttributes, $indent ) {
483 $contentHandler = $content->getContentHandler();
484 $contentFormat = $contentHandler->getDefaultFormat();
486 if ( $content instanceof TextContent
) {
487 // HACK: For text based models, bypass the serialization step. This allows extensions (like Flow)
488 // that use incompatible combinations of serialization format and content model.
489 $data = $content->getNativeData();
491 $data = $content->serialize( $contentFormat );
494 $data = $contentHandler->exportTransform( $data, $contentFormat );
495 $textAttributes['bytes'] = $size = strlen( $data ); // make sure to use the actual size
496 $out .= $indent . Xml
::elementClean( 'text', $textAttributes, strval( $data ) ) . "\n";
502 * Dumps a "<logitem>" section on the output stream, with
503 * data filled in from the given database row.
509 function writeLogItem( $row ) {
510 $out = " <logitem>\n";
511 $out .= " " . Xml
::element( 'id', null, strval( $row->log_id
) ) . "\n";
513 $out .= $this->writeTimestamp( $row->log_timestamp
, " " );
515 if ( $row->log_deleted
& LogPage
::DELETED_USER
) {
516 $out .= " " . Xml
::element( 'contributor', [ 'deleted' => 'deleted' ] ) . "\n";
518 $out .= $this->writeContributor( $row->log_user
, $row->user_name
, " " );
521 if ( $row->log_deleted
& LogPage
::DELETED_COMMENT
) {
522 $out .= " " . Xml
::element( 'comment', [ 'deleted' => 'deleted' ] ) . "\n";
524 $comment = CommentStore
::getStore()->getComment( 'log_comment', $row )->text
;
525 if ( $comment != '' ) {
526 $out .= " " . Xml
::elementClean( 'comment', null, strval( $comment ) ) . "\n";
530 $out .= " " . Xml
::element( 'type', null, strval( $row->log_type
) ) . "\n";
531 $out .= " " . Xml
::element( 'action', null, strval( $row->log_action
) ) . "\n";
533 if ( $row->log_deleted
& LogPage
::DELETED_ACTION
) {
534 $out .= " " . Xml
::element( 'text', [ 'deleted' => 'deleted' ] ) . "\n";
536 $title = Title
::makeTitle( $row->log_namespace
, $row->log_title
);
537 $out .= " " . Xml
::elementClean( 'logtitle', null, self
::canonicalTitle( $title ) ) . "\n";
538 $out .= " " . Xml
::elementClean( 'params',
539 [ 'xml:space' => 'preserve' ],
540 strval( $row->log_params
) ) . "\n";
543 $out .= " </logitem>\n";
549 * @param string $timestamp
550 * @param string $indent Default to six spaces
553 function writeTimestamp( $timestamp, $indent = " " ) {
554 $ts = wfTimestamp( TS_ISO_8601
, $timestamp );
555 return $indent . Xml
::element( 'timestamp', null, $ts ) . "\n";
560 * @param string $text
561 * @param string $indent Default to six spaces
564 function writeContributor( $id, $text, $indent = " " ) {
565 $out = $indent . "<contributor>\n";
566 if ( $id ||
!IP
::isValid( $text ) ) {
567 $out .= $indent . " " . Xml
::elementClean( 'username', null, strval( $text ) ) . "\n";
568 $out .= $indent . " " . Xml
::element( 'id', null, strval( $id ) ) . "\n";
570 $out .= $indent . " " . Xml
::elementClean( 'ip', null, strval( $text ) ) . "\n";
572 $out .= $indent . "</contributor>\n";
577 * Warning! This data is potentially inconsistent. :(
579 * @param bool $dumpContents
582 function writeUploads( $row, $dumpContents = false ) {
583 if ( $row->page_namespace
== NS_FILE
) {
584 $img = MediaWikiServices
::getInstance()->getRepoGroup()->getLocalRepo()
585 ->newFile( $row->page_title
);
586 if ( $img && $img->exists() ) {
588 foreach ( array_reverse( $img->getHistory() ) as $ver ) {
589 $out .= $this->writeUpload( $ver, $dumpContents );
591 $out .= $this->writeUpload( $img, $dumpContents );
600 * @param bool $dumpContents
603 function writeUpload( $file, $dumpContents = false ) {
604 if ( $file->isOld() ) {
606 Xml
::element( 'archivename', null, $file->getArchiveName() ) . "\n";
610 if ( $dumpContents ) {
611 $be = $file->getRepo()->getBackend();
612 # Dump file as base64
613 # Uses only XML-safe characters, so does not need escaping
614 # @todo Too bad this loads the contents into memory (script might swap)
615 $contents = ' <contents encoding="base64">' .
616 chunk_split( base64_encode(
617 $be->getFileContents( [ 'src' => $file->getPath() ] ) ) ) .
622 if ( $file->isDeleted( File
::DELETED_COMMENT
) ) {
623 $comment = Xml
::element( 'comment', [ 'deleted' => 'deleted' ] );
625 $comment = Xml
::elementClean( 'comment', null, strval( $file->getDescription() ) );
627 return " <upload>\n" .
628 $this->writeTimestamp( $file->getTimestamp() ) .
629 $this->writeContributor( $file->getUser( 'id' ), $file->getUser( 'text' ) ) .
630 " " . $comment . "\n" .
631 " " . Xml
::element( 'filename', null, $file->getName() ) . "\n" .
633 " " . Xml
::element( 'src', null, $file->getCanonicalUrl() ) . "\n" .
634 " " . Xml
::element( 'size', null, $file->getSize() ) . "\n" .
635 " " . Xml
::element( 'sha1base36', null, $file->getSha1() ) . "\n" .
636 " " . Xml
::element( 'rel', null, $file->getRel() ) . "\n" .
642 * Return prefixed text form of title, but using the content language's
643 * canonical namespace. This skips any special-casing such as gendered
644 * user namespaces -- which while useful, are not yet listed in the
645 * XML "<siteinfo>" data so are unsafe in export.
647 * @param Title $title
651 public static function canonicalTitle( Title
$title ) {
652 if ( $title->isExternal() ) {
653 return $title->getPrefixedText();
656 $prefix = MediaWikiServices
::getInstance()->getContentLanguage()->
657 getFormattedNsText( $title->getNamespace() );
659 // @todo Emit some kind of warning to the user if $title->getNamespace() !==
660 // NS_MAIN and $prefix === '' (viz. pages in an unregistered namespace)
662 if ( $prefix !== '' ) {
666 return $prefix . $title->getText();