(bug 43467) Add invert selection for ns in Special:Newpages
[lhc/web/wiklou.git] / includes / XmlTypeCheck.php
index a004ef4..b95dd6a 100644 (file)
@@ -1,4 +1,24 @@
 <?php
+/**
+ * XML syntax and type checker.
+ *
+ * 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
+ */
 
 class XmlTypeCheck {
        /**
@@ -6,7 +26,7 @@ class XmlTypeCheck {
         * well-formed XML. Note that this doesn't check schema validity.
         */
        public $wellFormed = false;
-       
+
        /**
         * Will be set to true if the optional element filter returned
         * a match at some point.
@@ -31,14 +51,19 @@ class XmlTypeCheck {
                $this->filterCallback = $filterCallback;
                $this->run( $file );
        }
-       
+
        /**
         * Get the root element. Simple accessor to $rootElement
+        *
+        * @return string
         */
        public function getRootElement() {
                return $this->rootElement;
        }
 
+       /**
+        * @param $fname
+        */
        private function run( $fname ) {
                $parser = xml_parser_create_ns( 'UTF-8' );
 
@@ -47,27 +72,37 @@ class XmlTypeCheck {
 
                xml_set_element_handler( $parser, array( $this, 'rootElementOpen' ), false );
 
-               $file = fopen( $fname, "rb" );
-               do {
-                       $chunk = fread( $file, 32768 );
-                       $ret = xml_parse( $parser, $chunk, feof( $file ) );
-                       if( $ret == 0 ) {
-                               // XML isn't well-formed!
+               if ( file_exists( $fname ) ) {
+                       $file = fopen( $fname, "rb" );
+                       if ( $file ) {
+                               do {
+                                       $chunk = fread( $file, 32768 );
+                                       $ret = xml_parse( $parser, $chunk, feof( $file ) );
+                                       if( $ret == 0 ) {
+                                               // XML isn't well-formed!
+                                               fclose( $file );
+                                               xml_parser_free( $parser );
+                                               return;
+                                       }
+                               } while( !feof( $file ) );
+
                                fclose( $file );
-                               xml_parser_free( $parser );
-                               return;
                        }
-               } while( !feof( $file ) );
+               }
 
                $this->wellFormed = true;
 
-               fclose( $file );
                xml_parser_free( $parser );
        }
 
+       /**
+        * @param $parser
+        * @param $name
+        * @param $attribs
+        */
        private function rootElementOpen( $parser, $name, $attribs ) {
                $this->rootElement = $name;
-               
+
                if( is_callable( $this->filterCallback ) ) {
                        xml_set_element_handler( $parser, array( $this, 'elementOpen' ), false );
                        $this->elementOpen( $parser, $name, $attribs );
@@ -76,7 +111,12 @@ class XmlTypeCheck {
                        xml_set_element_handler( $parser, false, false );
                }
        }
-       
+
+       /**
+        * @param $parser
+        * @param $name
+        * @param $attribs
+        */
        private function elementOpen( $parser, $name, $attribs ) {
                if( call_user_func( $this->filterCallback, $name, $attribs ) ) {
                        // Filter hit!