Missing out call
[lhc/web/wiklou.git] / includes / Title.php
index 0c91eab..d08a2c4 100644 (file)
@@ -33,8 +33,8 @@ class Title {
         */
        static private $titleCache=array();
        static private $interwikiCache=array();
-       
-       
+
+
        /**
         * All member variables should be considered private
         * Please use the accessor functions
@@ -63,6 +63,8 @@ class Title {
        var $mDefaultNamespace;         # Namespace index when there is no namespace
                                        # Zero except in {{transclusion}} tags
        var $mWatched;                  # Is $wgUser watching this page? NULL if unfilled, accessed through userIsWatching()
+       var $mLength;              # The page length, 0 for special pages
+       var $mRedirect;            # Is the article at this title a redirect?
        /**#@-*/
 
 
@@ -83,6 +85,8 @@ class Title {
                $this->mWatched = NULL;
                $this->mLatestID = false;
                $this->mOldRestrictions = false;
+               $this->mLength = -1;
+               $this->mRedirect = NULL;
        }
 
        /**
@@ -204,7 +208,7 @@ class Title {
        }
 
        /**
-        * Make an array of titles from an array of IDs 
+        * Make an array of titles from an array of IDs
         */
        public static function newFromIDs( $ids ) {
                if ( !count( $ids ) ) {
@@ -221,6 +225,21 @@ class Title {
                return $titles;
        }
 
+       /**
+        * Make a Title object from a DB row
+        * @param Row $row (needs at least page_title,page_namespace)
+        */
+       public static function newFromRow( $row ) {
+               $t = self::makeTitle( $row->page_namespace, $row->page_title );
+
+               $t->mArticleID = isset($row->page_id) ? intval($row->page_id) : -1;
+               $t->mLength = isset($row->page_len) ? intval($row->page_len) : -1;
+               $t->mRedirect = isset($row->page_is_redirect) ? (bool)$row->page_is_redirect : NULL;
+               $t->mLatestID = isset($row->page_latest) ? $row->page_latest : false;
+
+               return $t;
+       }
+
        /**
         * Create a new Title from a namespace index and a DB key.
         * It's assumed that $ns and $title are *valid*, for instance when
@@ -431,7 +450,7 @@ class Title {
 
                return $s->iw_url;
        }
-       
+
        /**
         * Fetch interwiki prefix data from local cache in constant database
         *
@@ -835,7 +854,7 @@ class Title {
                                        $url = "{$wgScript}?title={$dbkey}&{$query}";
                                }
                        }
-                       
+
                        // FIXME: this causes breakage in various places when we
                        // actually expected a local URL and end up with dupe prefixes.
                        if ($wgRequest->getVal('action') == 'render') {
@@ -949,7 +968,7 @@ class Title {
                        return true;
 
                # Check regular protection levels
-               foreach( $wgRestrictionTypes as $type ){                
+               foreach( $wgRestrictionTypes as $type ){
                        if( $action == $type || $action == '' ) {
                                $r = $this->getRestrictions( $type );
                                foreach( $wgRestrictionLevels as $level ) {
@@ -1090,7 +1109,8 @@ class Title {
 
                        $intended = $user->mBlock->mAddress;
 
-                       $errors[] = array ( ($block->mAuto ? 'autoblockedtext' : 'blockedtext'), $link, $reason, $ip, $name, $blockid, $blockExpiry, $intended, $blockTimestamp );
+                       $errors[] = array( ($block->mAuto ? 'autoblockedtext' : 'blockedtext'), $link, $reason, $ip, $name, 
+                               $blockid, $blockExpiry, $intended, $blockTimestamp );
                }
 
                return $errors;
@@ -1113,6 +1133,7 @@ class Title {
 
                // Use getUserPermissionsErrors instead
                if ( !wfRunHooks( 'userCan', array( &$this, &$user, $action, &$result ) ) ) {
+                       wfProfileOut( __METHOD__ );
                        return $result ? array() : array( array( 'badaccess-group0' ) );
                }
 
@@ -1140,13 +1161,13 @@ class Title {
                if( NS_SPECIAL == $this->mNamespace ) {
                        $errors[] = array('ns-specialprotected');
                }
-               
+
                if ( $this->isNamespaceProtected() ) {
                        $ns = $this->getNamespace() == NS_MAIN
                                ? wfMsg( 'nstab-main' )
                                : $this->getNsText();
-                       $errors[] = (NS_MEDIAWIKI == $this->mNamespace 
-                               ? array('protectedinterface') 
+                       $errors[] = (NS_MEDIAWIKI == $this->mNamespace
+                               ? array('protectedinterface')
                                : array( 'namespaceprotected',  $ns ) );
                }
 
@@ -1163,7 +1184,7 @@ class Title {
                        && !preg_match('/^'.preg_quote($user->getName(), '/').'\//', $this->mTextform) ) {
                        $errors[] = array('customcssjsprotected');
                }
-               
+
                if ( $doExpensiveQueries && !$this->isCssJsSubpage() ) {
                        # We /could/ use the protection level on the source page, but it's fairly ugly
                        #  as we have to establish a precedence hierarchy for pages included by multiple
@@ -1186,7 +1207,7 @@ class Title {
                                }
                        }
                }
-               
+
                foreach( $this->getRestrictions($action) as $right ) {
                        // Backwards compatibility, rewrite sysop -> protect
                        if ( $right == 'sysop' ) {
@@ -1214,7 +1235,7 @@ class Title {
                        }
                }
 
-               if ($action == 'create') {                      
+               if ($action == 'create') {
                        $title_protection = $this->getTitleProtection();
 
                        if (is_array($title_protection)) {
@@ -1279,7 +1300,7 @@ class Title {
                }
 
                $dbr = wfGetDB( DB_SLAVE );
-               $res = $dbr->select( 'protected_titles', '*', 
+               $res = $dbr->select( 'protected_titles', '*',
                        array ('pt_namespace' => $this->getNamespace(), 'pt_title' => $this->getDBkey()) );
 
                if ($row = $dbr->fetchRow( $res )) {
@@ -1339,7 +1360,7 @@ class Title {
        public function deleteTitleProtection() {
                $dbw = wfGetDB( DB_MASTER );
 
-               $dbw->delete( 'protected_titles', 
+               $dbw->delete( 'protected_titles',
                        array ('pt_namespace' => $this->getNamespace(), 'pt_title' => $this->getDBkey()), __METHOD__ );
        }
 
@@ -1404,7 +1425,7 @@ class Title {
                } else {
                        global $wgWhitelistRead;
 
-                       /** 
+                       /**
                         * Always grant access to the login page.
                         * Even anons need to be able to log in.
                        */
@@ -1470,14 +1491,14 @@ class Title {
         */
        public function isSubpage() {
                global $wgNamespacesWithSubpages;
-               
+
                if( isset( $wgNamespacesWithSubpages[ $this->mNamespace ] ) ) {
                        return ( strpos( $this->getText(), '/' ) !== false && $wgNamespacesWithSubpages[ $this->mNamespace ] == true );
                } else {
                        return false;
                }
        }
-       
+
        /**
         * Could this page contain custom CSS or JavaScript, based
         * on the title?
@@ -1609,7 +1630,7 @@ class Title {
                $sources = $get_pages ? array() : false;
                $now = wfTimestampNow();
                $purgeExpired = false;
-               
+
                while( $row = $dbr->fetchObject( $res ) ) {
                        $expiry = Block::decodeExpiry( $row->pr_expiry );
                        if( $expiry > $now ) {
@@ -1700,7 +1721,7 @@ class Title {
 
                        while ($row = $dbr->fetchObject( $res ) ) {
                                # Cycle through all the restrictions.
-                               
+
                                // Don't take care of restrictions types that aren't in $wgRestrictionTypes
                                if( !in_array( $row->pr_type, $wgRestrictionTypes ) )
                                        continue;
@@ -1817,7 +1838,7 @@ class Title {
         * @return int the ID
         */
        public function getArticleID( $flags = 0 ) {
-               $linkCache =& LinkCache::singleton();
+               $linkCache = LinkCache::singleton();
                if ( $flags & GAID_FOR_UPDATE ) {
                        $oldUpdate = $linkCache->forUpdate( true );
                        $this->mArticleID = $linkCache->addLinkObj( $this );
@@ -1830,6 +1851,46 @@ class Title {
                return $this->mArticleID;
        }
 
+       /**
+        * Is this an article that is a redirect page?
+        * Uses link cache, adding it if necessary
+        * @param int $flags a bit field; may be GAID_FOR_UPDATE to select for update
+        * @return bool
+        */
+       public function isRedirect( $flags = 0 ) {
+               if( !is_null($this->mRedirect) )
+                       return $this->mRedirect;
+               # Zero for special pages.
+               # Also, calling getArticleID() loads the field from cache!
+               if( !$this->getArticleID($flags) || $this->getNamespace() == NS_SPECIAL ) {
+                       return false;
+               }
+               $linkCache = LinkCache::singleton();
+               $this->mRedirect = (bool)$linkCache->getGoodLinkFieldObj( $this, 'redirect' );
+
+               return $this->mRedirect;
+       }
+
+       /**
+        * What is the length of this page?
+        * Uses link cache, adding it if necessary
+        * @param int $flags a bit field; may be GAID_FOR_UPDATE to select for update
+        * @return bool
+        */
+       public function getLength( $flags = 0 ) {
+               if( $this->mLength != -1 )
+                       return $this->mLength;
+               # Zero for special pages.
+               # Also, calling getArticleID() loads the field from cache!
+               if( !$this->getArticleID($flags) || $this->getNamespace() == NS_SPECIAL ) {
+                       return 0;
+               }
+               $linkCache = LinkCache::singleton();
+               $this->mLength = intval( $linkCache->getGoodLinkFieldObj( $this, 'length' ) );
+
+               return $this->mLength;
+       }
+
        public function getLatestRevID() {
                if ($this->mLatestID !== false)
                        return $this->mLatestID;
@@ -1852,7 +1913,7 @@ class Title {
         * @param int $newid the new Article ID
         */
        public function resetArticleID( $newid ) {
-               $linkCache =& LinkCache::singleton();
+               $linkCache = LinkCache::singleton();
                $linkCache->clearBadLink( $this->getPrefixedDBkey() );
 
                if ( 0 == $newid ) { $this->mArticleID = -1; }
@@ -1941,7 +2002,7 @@ class Title {
 
                $this->mInterwiki = $this->mFragment = '';
                $this->mNamespace = $this->mDefaultNamespace; # Usually NS_MAIN
-               
+
                $dbkey = $this->mDbkeyform;
 
                # Strip Unicode bidi override characters.
@@ -1949,7 +2010,7 @@ class Title {
                # override chars get included in list displays.
                $dbkey = str_replace( "\xE2\x80\x8E", '', $dbkey ); // 200E LEFT-TO-RIGHT MARK
                $dbkey = str_replace( "\xE2\x80\x8F", '', $dbkey ); // 200F RIGHT-TO-LEFT MARK
-               
+
                # Clean up whitespace
                #
                $dbkey = preg_replace( '/[ _]+/', '_', $dbkey );
@@ -2056,7 +2117,7 @@ class Title {
                {
                        return false;
                }
-               
+
                /**
                 * Magic tilde sequences? Nu-uh!
                 */
@@ -2068,11 +2129,11 @@ class Title {
                 * Limit the size of titles to 255 bytes.
                 * This is typically the size of the underlying database field.
                 * We make an exception for special pages, which don't need to be stored
-                * in the database, and may edge over 255 bytes due to subpage syntax 
+                * in the database, and may edge over 255 bytes due to subpage syntax
                 * for long titles, e.g. [[Special:Block/Long name]]
                 */
                if ( ( $this->mNamespace != NS_SPECIAL && strlen( $dbkey ) > 255 ) ||
-                 strlen( $dbkey ) > 512 ) 
+                 strlen( $dbkey ) > 512 )
                {
                        return false;
                }
@@ -2101,18 +2162,18 @@ class Title {
                        return false;
                }
                // Allow IPv6 usernames to start with '::' by canonicalizing IPv6 titles.
-               // IP names are not allowed for accounts, and can only be referring to 
-               // edits from the IP. Given '::' abbreviations and caps/lowercaps, 
-               // there are numerous ways to present the same IP. Having sp:contribs scan 
-               // them all is silly and having some show the edits and others not is 
+               // IP names are not allowed for accounts, and can only be referring to
+               // edits from the IP. Given '::' abbreviations and caps/lowercaps,
+               // there are numerous ways to present the same IP. Having sp:contribs scan
+               // them all is silly and having some show the edits and others not is
                // inconsistent. Same for talk/userpages. Keep them normalized instead.
-               $dbkey = ($this->mNamespace == NS_USER || $this->mNamespace == NS_USER_TALK) ? 
+               $dbkey = ($this->mNamespace == NS_USER || $this->mNamespace == NS_USER_TALK) ?
                        IP::sanitizeIP( $dbkey ) : $dbkey;
                // Any remaining initial :s are illegal.
                if ( $dbkey !== '' && ':' == $dbkey{0} ) {
                        return false;
                }
-               
+
                # Fill fields
                $this->mDbkeyform = $dbkey;
                $this->mUrlform = wfUrlencode( $dbkey );
@@ -2125,7 +2186,7 @@ class Title {
        /**
         * Set the fragment for this title
         * This is kind of bad, since except for this rarely-used function, Title objects
-        * are immutable. The reason this is here is because it's better than setting the 
+        * are immutable. The reason this is here is because it's better than setting the
         * members directly, which is what Linker::formatComment was doing previously.
         *
         * @param string $fragment text
@@ -2164,7 +2225,7 @@ class Title {
         * @return array the Title objects linking here
         */
        public function getLinksTo( $options = '', $table = 'pagelinks', $prefix = 'pl' ) {
-               $linkCache =& LinkCache::singleton();
+               $linkCache = LinkCache::singleton();
 
                if ( $options ) {
                        $db = wfGetDB( DB_MASTER );
@@ -2173,7 +2234,7 @@ class Title {
                }
 
                $res = $db->select( array( 'page', $table ),
-                       array( 'page_namespace', 'page_title', 'page_id' ),
+                       array( 'page_namespace', 'page_title', 'page_id', 'page_len', 'page_is_redirect' ),
                        array(
                                "{$prefix}_from=page_id",
                                "{$prefix}_namespace" => $this->getNamespace(),
@@ -2185,7 +2246,7 @@ class Title {
                if ( $db->numRows( $res ) ) {
                        while ( $row = $db->fetchObject( $res ) ) {
                                if ( $titleObj = Title::makeTitle( $row->page_namespace, $row->page_title ) ) {
-                                       $linkCache->addGoodLinkObj( $row->page_id, $titleObj );
+                                       $linkCache->addGoodLinkObj( $row->page_id, $titleObj, $row->page_len, $row->page_is_redirect );
                                        $retVal[] = $titleObj;
                                }
                        }
@@ -2450,7 +2511,7 @@ class Title {
                        $newarticle = new Article( $nt );
                        $wgMessageCache->replace( $nt->getDBkey(), $newarticle->getContent() );
                }
-               
+
                global $wgUser;
                wfRunHooks( 'TitleMoveComplete', array( &$this, &$nt, &$wgUser, $pageid, $redirid ) );
                return true;
@@ -2542,7 +2603,7 @@ class Title {
                } else {
                        $this->resetArticleID( 0 );
                }
-               
+
                # Log the move
                $log = new LogPage( 'move' );
                $log->addEntry( 'move_redir', $this, $reason, array( 1 => $nt->getPrefixedText() ) );
@@ -2683,7 +2744,7 @@ class Title {
                # Return true if there was no history
                return $row === false;
        }
-       
+
        /**
         * Can this title be added to a user's watchlist?
         *
@@ -2793,6 +2854,7 @@ class Title {
 
        /**
         * Get the number of revisions between the given revision IDs.
+        * Used for diffs and other things that really need it.
         *
         * @param integer $old  Revision ID.
         * @param integer $new  Revision ID.
@@ -2803,7 +2865,9 @@ class Title {
                return $dbr->selectField( 'revision', 'count(*)',
                        'rev_page = ' . intval( $this->getArticleId() ) .
                        ' AND rev_id > ' . intval( $old ) .
-                       ' AND rev_id < ' . intval( $new ) );
+                       ' AND rev_id < ' . intval( $new ),
+                       __METHOD__,
+                       array( 'USE INDEX' => 'PRIMARY' ) );
        }
 
        /**
@@ -2818,7 +2882,7 @@ class Title {
                        && $this->getNamespace() == $title->getNamespace()
                        && $this->getDBkey() === $title->getDBkey();
        }
-       
+
        /**
         * Return a string representation of this title
         *
@@ -2856,7 +2920,7 @@ class Title {
 
        /**
         * Update page_touched timestamps and send squid purge messages for
-        * pages linking to this title. May be sent to the job queue depending 
+        * pages linking to this title. May be sent to the job queue depending
         * on the number of links. Typically called on create and delete.
         */
        public function touchLinks() {
@@ -2875,7 +2939,7 @@ class Title {
        public function getTouched() {
                $dbr = wfGetDB( DB_SLAVE );
                $touched = $dbr->selectField( 'page', 'page_touched',
-                       array( 
+                       array(
                                'page_namespace' => $this->getNamespace(),
                                'page_title' => $this->getDBkey()
                        ), __METHOD__
@@ -2968,7 +3032,7 @@ class Title {
        }
 
        /**
-        * If the Title refers to a special page alias which is not the local default, 
+        * If the Title refers to a special page alias which is not the local default,
         * returns a new Title which points to the local default. Otherwise, returns $this.
         */
        public function fixSpecialName() {
@@ -2994,5 +3058,16 @@ class Title {
        public function isContentPage() {
                return MWNamespace::isContent( $this->getNamespace() );
        }
-       
+
+       public function getRedirectsHere() {
+               $redirs = array();
+               $dbr = wfGetDB( DB_SLAVE );
+               list($page,$redirect) = $dbr->tableNamesN( 'page', 'redirect' );
+               $result = $dbr->query( "SELECT page_title, page_namespace FROM $page JOIN $redirect ON page_id = rd_from WHERE rd_title = "
+                       . $dbr->addQuotes( $this->getDBKey() ) . " AND rd_namespace = " . $this->getNamespace(), __METHOD__ );
+               while( $row = $dbr->fetchObject( $result ) ) {
+                       $redirs[] = self::newFromRow( $row );
+               }
+               return $redirs;
+       }
 }