Add forgotten RELEASE-NOTES line

[lhc/web/wiklou.git] / maintenance / backupPrefetch.inc

diff --git a/maintenance/backupPrefetch.inc b/maintenance/backupPrefetch.inc
index c8af6a6..04352b9 100644 (file)
--- a/maintenance/backupPrefetch.inc
+++ b/maintenance/backupPrefetch.inc
@@ -1,42 +1,28 @@
 <?php
-
-// Some smart guy removed XMLReader's global constants from PHP 5.1
-// and replaced them with class constants. Breaking source compatibility
-// is SUPER awesome, and I love languages which do this constantly!
-$xmlReaderConstants = array(
-       "NONE",
-       "ELEMENT",
-       "ATTRIBUTE",
-       "TEXT",
-       "CDATA",
-       "ENTITY_REF",
-       "ENTITY",
-       "PI",
-       "COMMENT",
-       "DOC",
-       "DOC_TYPE",
-       "DOC_FRAGMENT",
-       "NOTATION",
-       "WHITESPACE",
-       "SIGNIFICANT_WHITESPACE",
-       "END_ELEMENT",
-       "END_ENTITY",
-       "XML_DECLARATION",
-       "LOADDTD",
-       "DEFAULTATTRS",
-       "VALIDATE",
-       "SUBST_ENTITIES" );
-foreach ( $xmlReaderConstants as $name ) {
-       $fullName = "XMLREADER_$name";
-       $newName = "XMLReader::$name";
-       if ( !defined( $fullName ) ) {
-               if ( defined( $newName ) ) {
-                       define( $fullName, constant( $newName ) );
-               } else {
-                       // broken or missing the extension...
-               }
-       }
-}
+/**
+ * Helper class for the --prefetch option of dumpTextPass.php
+ *
+ * Copyright © 2005 Brion Vibber <brion@pobox.com>
+ * http://www.mediawiki.org/
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ * @ingroup Maintenance
+ */
 
 /**
  * Readahead helper for making large MediaWiki data dumps;
@@ -51,7 +37,6 @@ foreach ( $xmlReaderConstants as $name ) {
  * - text contents are immutable and should not change once
  *   recorded, so the previous dump is a reliable source
  *
- * Requires the XMLReader PECL extension.
  * @ingroup Maintenance
  */
 class BaseDump {
@@ -60,10 +45,18 @@ class BaseDump {
        var $atPageEnd = false;
        var $lastPage = 0;
        var $lastRev = 0;
+       var $infiles = null;
 
        function BaseDump( $infile ) {
+               $this->infiles = explode( ';', $infile );
                $this->reader = new XMLReader();
-               $this->reader->open( $infile );
+               $infile = array_shift( $this->infiles );
+               if ( defined( 'LIBXML_PARSEHUGE' ) ) {
+                       $this->reader->open( $infile, null, LIBXML_PARSEHUGE );
+               }
+               else {
+                       $this->reader->open( $infile );
+               }
        }
 
        /**
@@ -116,7 +109,12 @@ class BaseDump {
                                $this->atPageEnd = false;
                        }
                } else {
-                       $this->atEnd = true;
+                       $this->close();
+                       if ( count( $this->infiles ) ) {
+                               $infile = array_shift( $this->infiles );
+                               $this->reader->open( $infile );
+                               $this->atEnd = false;
+                       }
                }
        }
 
@@ -135,6 +133,7 @@ class BaseDump {
 
        /**
         * @access private
+        * @return string
         */
        function nextText() {
                $this->skipTo( 'text' );
@@ -143,17 +142,20 @@ class BaseDump {
 
        /**
         * @access private
+        * @param $name string
+        * @param $parent string
+        * @return bool|null
         */
        function skipTo( $name, $parent = 'page' ) {
                if ( $this->atEnd ) {
                        return false;
                }
                while ( $this->reader->read() ) {
-                       if ( $this->reader->nodeType == XMLREADER_ELEMENT &&
+                       if ( $this->reader->nodeType == XMLReader::ELEMENT &&
                                $this->reader->name == $name ) {
                                return true;
                        }
-                       if ( $this->reader->nodeType == XMLREADER_END_ELEMENT &&
+                       if ( $this->reader->nodeType == XMLReader::END_ELEMENT &&
                                $this->reader->name == $parent ) {
                                $this->debug( "BaseDump::skipTo found </$parent> searching for <$name>" );
                                return false;
@@ -179,13 +181,13 @@ class BaseDump {
                }
                $buffer = "";
                while ( $this->reader->read() ) {
-                       switch( $this->reader->nodeType ) {
-                       case XMLREADER_TEXT:
-//                     case XMLREADER_WHITESPACE:
-                       case XMLREADER_SIGNIFICANT_WHITESPACE:
+                       switch ( $this->reader->nodeType ) {
+                       case XMLReader::TEXT:
+//                     case XMLReader::WHITESPACE:
+                       case XMLReader::SIGNIFICANT_WHITESPACE:
                                $buffer .= $this->reader->value;
                                break;
-                       case XMLREADER_END_ELEMENT:
+                       case XMLReader::END_ELEMENT:
                                return $buffer;
                        }
                }
@@ -194,6 +196,7 @@ class BaseDump {
 
        /**
         * @access private
+        * @return null
         */
        function close() {
                $this->reader->close();