/** */
require_once( 'normal/UtfNormal.php' );
-$wgTitleInterwikiCache = array();
-$wgTitleCache = array();
-
define ( 'GAID_FOR_UPDATE', 1 );
# Title::newFromTitle maintains a cache to avoid
* @package MediaWiki
*/
class Title {
+ /**
+ * Static cache variables
+ */
+ static private $titleCache=array();
+ static private $interwikiCache=array();
+
+
/**
* All member variables should be considered private
* Please use the accessor functions
*/
/**#@+
- * @access private
+ * @private
*/
var $mTextform; # Text form (spaces not underscores) of the main part
var $mArticleID; # Article ID, fetched from the link cache on demand
var $mLatestID; # ID of most recent revision
var $mRestrictions; # Array of groups allowed to edit this article
- # Only null or "sysop" are supported
+ # Only null or "sysop" are supported
var $mRestrictionsLoaded; # Boolean for initialisation on demand
var $mPrefixedText; # Text form including namespace/interwiki, initialised on demand
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()
+ # Zero except in {{transclusion}} tags
+ var $mWatched; # Is $wgUser watching this page? NULL if unfilled, accessed through userIsWatching()
/**#@-*/
/**
* Constructor
- * @access private
+ * @private
*/
/* private */ function Title() {
$this->mInterwiki = $this->mUrlform =
* @access public
*/
function newFromText( $text, $defaultNamespace = NS_MAIN ) {
- global $wgTitleCache;
$fname = 'Title::newFromText';
- wfProfileIn( $fname );
if( is_object( $text ) ) {
- wfDebugDieBacktrace( 'Title::newFromText given an object' );
+ throw new MWException( 'Title::newFromText given an object' );
}
/**
*
* In theory these are value objects and won't get changed...
*/
- if( $defaultNamespace == NS_MAIN && isset( $wgTitleCache[$text] ) ) {
- wfProfileOut( $fname );
- return $wgTitleCache[$text];
+ if( $defaultNamespace == NS_MAIN && isset( Title::$titleCache[$text] ) ) {
+ return Title::$titleCache[$text];
}
/**
if( $defaultNamespace == NS_MAIN ) {
if( $cachedcount >= MW_TITLECACHE_MAX ) {
# Avoid memory leaks on mass operations...
- $wgTitleCache = array();
+ Title::$titleCache = array();
$cachedcount=0;
}
$cachedcount++;
- $wgTitleCache[$text] =& $t;
+ Title::$titleCache[$text] =& $t;
}
- wfProfileOut( $fname );
return $t;
} else {
- wfProfileOut( $fname );
$ret = NULL;
return $ret;
}
return $title;
}
+ /**
+ * Make an array of titles from an array of IDs
+ */
+ function newFromIDs( $ids ) {
+ $dbr =& wfGetDB( DB_SLAVE );
+ $res = $dbr->select( 'page', array( 'page_namespace', 'page_title' ),
+ 'page_id IN (' . $dbr->makeList( $ids ) . ')', __METHOD__ );
+
+ $titles = array();
+ while ( $row = $dbr->fetchObject( $res ) ) {
+ $titles[] = Title::makeTitle( $row->page_namespace, $row->page_title );
+ }
+ return $titles;
+ }
+
/**
* Create a new Title from a namespace index and a DB key.
* It's assumed that $ns and $title are *valid*, for instance when
*/
/* static */ function indexTitle( $ns, $title ) {
global $wgContLang;
- require_once( 'SearchEngine.php' );
$lc = SearchEngine::legalSearchChars() . '&#;';
$t = $wgContLang->stripForSearch( $title );
* @access public
*/
function getInterwikiLink( $key ) {
- global $wgMemc, $wgDBname, $wgInterwikiExpiry, $wgTitleInterwikiCache;
+ global $wgMemc, $wgDBname, $wgInterwikiExpiry;
global $wgInterwikiCache;
$fname = 'Title::getInterwikiLink';
- wfProfileIn( $fname );
-
$key = strtolower( $key );
$k = $wgDBname.':interwiki:'.$key;
- if( array_key_exists( $k, $wgTitleInterwikiCache ) ) {
- wfProfileOut( $fname );
- return $wgTitleInterwikiCache[$k]->iw_url;
+ if( array_key_exists( $k, Title::$interwikiCache ) ) {
+ return Title::$interwikiCache[$k]->iw_url;
}
if ($wgInterwikiCache) {
- wfProfileOut( $fname );
return Title::getInterwikiCached( $key );
}
$s = $wgMemc->get( $k );
# Ignore old keys with no iw_local
if( $s && isset( $s->iw_local ) && isset($s->iw_trans)) {
- $wgTitleInterwikiCache[$k] = $s;
- wfProfileOut( $fname );
+ Title::$interwikiCache[$k] = $s;
return $s->iw_url;
}
array( 'iw_url', 'iw_local', 'iw_trans' ),
array( 'iw_prefix' => $key ), $fname );
if( !$res ) {
- wfProfileOut( $fname );
return '';
}
$s->iw_trans = 0;
}
$wgMemc->set( $k, $s, $wgInterwikiExpiry );
- $wgTitleInterwikiCache[$k] = $s;
+ Title::$interwikiCache[$k] = $s;
- wfProfileOut( $fname );
return $s->iw_url;
}
*/
function getInterwikiCached( $key ) {
global $wgDBname, $wgInterwikiCache, $wgInterwikiScopes, $wgInterwikiFallbackSite;
- global $wgTitleInterwikiCache;
static $db, $site;
if (!$db)
$site = $wgInterwikiFallbackSite;
}
$value = dba_fetch("{$wgDBname}:{$key}", $db);
- if ($value=='' and $wgInterwikiScopes>=3) {
+ if ($value=='' and $wgInterwikiScopes>=3) {
/* try site-level */
$value = dba_fetch("_{$site}:{$key}", $db);
}
- if ($value=='' and $wgInterwikiScopes>=2) {
+ if ($value=='' and $wgInterwikiScopes>=2) {
/* try globals */
$value = dba_fetch("__global:{$key}", $db);
}
$s->iw_url=$url;
$s->iw_local=(int)$local;
}
- $wgTitleInterwikiCache[$wgDBname.':interwiki:'.$key] = $s;
+ Title::$interwikiCache[$wgDBname.':interwiki:'.$key] = $s;
return $s->iw_url;
}
/**
* @access public
*/
function isLocal() {
- global $wgTitleInterwikiCache, $wgDBname;
+ global $wgDBname;
if ( $this->mInterwiki != '' ) {
# Make sure key is loaded into cache
$this->getInterwikiLink( $this->mInterwiki );
$k = $wgDBname.':interwiki:' . $this->mInterwiki;
- return (bool)($wgTitleInterwikiCache[$k]->iw_local);
+ return (bool)(Title::$interwikiCache[$k]->iw_local);
} else {
return true;
}
* @access public
*/
function isTrans() {
- global $wgTitleInterwikiCache, $wgDBname;
+ global $wgDBname;
- if ($this->mInterwiki == '' || !$this->isLocal())
+ if ($this->mInterwiki == '')
return false;
# Make sure key is loaded into cache
$this->getInterwikiLink( $this->mInterwiki );
$k = $wgDBname.':interwiki:' . $this->mInterwiki;
- return (bool)($wgTitleInterwikiCache[$k]->iw_trans);
+ return (bool)(Title::$interwikiCache[$k]->iw_trans);
}
/**
return $wgContLang->getNsText( Namespace::getSubject( $this->mNamespace ) );
}
+ /**
+ * Get the namespace text of the talk page
+ * @return string
+ */
+ function getTalkNsText() {
+ global $wgContLang;
+ return( $wgContLang->getNsText( Namespace::getTalk( $this->mNamespace ) ) );
+ }
+
+ /**
+ * Could this title have a corresponding talk page?
+ * @return bool
+ */
+ function canTalk() {
+ return( Namespace::canTalk( $this->mNamespace ) );
+ }
+
/**
* Get the interwiki prefix (or null string)
* @return string
* @access public
*/
function getPrefixedText() {
- global $wgContLang;
if ( empty( $this->mPrefixedText ) ) { // FIXME: bad usage of empty() ?
$s = $this->prefix( $this->mTextform );
$s = str_replace( '_', ' ', $s );
* @access public
*/
function getFullText() {
- global $wgContLang;
$text = $this->getPrefixedText();
if( '' != $this->mFragment ) {
$text .= '#' . $this->mFragment;
return $text;
}
+ /**
+ * Get the base name, i.e. the leftmost parts before the /
+ * @return string Base name
+ */
+ function getBaseText() {
+ global $wgNamespacesWithSubpages;
+ if( isset( $wgNamespacesWithSubpages[ $this->mNamespace ] ) && $wgNamespacesWithSubpages[ $this->mNamespace ] ) {
+ $parts = explode( '/', $this->getText() );
+ # Don't discard the real title if there's no subpage involved
+ if( count( $parts ) > 1 )
+ unset( $parts[ count( $parts ) - 1 ] );
+ return implode( '/', $parts );
+ } else {
+ return $this->getText();
+ }
+ }
+
+ /**
+ * Get the lowest-level subpage name, i.e. the rightmost part after /
+ * @return string Subpage name
+ */
+ function getSubpageText() {
+ global $wgNamespacesWithSubpages;
+ if( isset( $wgNamespacesWithSubpages[ $this->mNamespace ] ) && $wgNamespacesWithSubpages[ $this->mNamespace ] ) {
+ $parts = explode( '/', $this->mTextform );
+ return( $parts[ count( $parts ) - 1 ] );
+ } else {
+ return( $this->mTextform );
+ }
+ }
+
+ /**
+ * Get a URL-encoded form of the subpage text
+ * @return string URL-encoded subpage name
+ */
+ function getSubpageUrlForm() {
+ $text = $this->getSubpageText();
+ $text = wfUrlencode( str_replace( ' ', '_', $text ) );
+ $text = str_replace( '%28', '(', str_replace( '%29', ')', $text ) ); # Clean up the URL; per below, this might not be safe
+ return( $text );
+ }
+
/**
* Get a URL-encoded title (not an actual URL) including interwiki
* @return string the URL-encoded form
}
$url .= $query;
}
- if ( '' != $this->mFragment ) {
- $url .= '#' . $this->mFragment;
- }
}
+
+ # Finally, add the fragment.
+ if ( '' != $this->mFragment ) {
+ $url .= '#' . $this->mFragment;
+ }
+
wfRunHooks( 'GetFullURL', array( &$this, &$url, $query ) );
return $url;
}
if ( $this->isExternal() ) {
$url = $this->getFullURL();
+ if ( $query ) {
+ // This is currently only used for edit section links in the
+ // context of interwiki transclusion. In theory we should
+ // append the query to the end of any existing query string,
+ // but interwiki transclusion is already broken in that case.
+ $url .= "?$query";
+ }
} else {
$dbkey = wfUrlencode( $this->getPrefixedDBkey() );
if ( $query == '' ) {
* @access public
*/
function getEditURL() {
- global $wgServer, $wgScript;
-
if ( '' != $this->mInterwiki ) { return ''; }
$s = $this->getLocalURL( 'action=edit' );
*/
function isExternal() { return ( '' != $this->mInterwiki ); }
+ /**
+ * Is this page "semi-protected" - the *only* protection is autoconfirm?
+ *
+ * @param string Action to check (default: edit)
+ * @return bool
+ */
+ function isSemiProtected( $action = 'edit' ) {
+ $restrictions = $this->getRestrictions( $action );
+ # We do a full compare because this could be an array
+ foreach( $restrictions as $restriction ) {
+ if( strtolower( $restriction ) != 'autoconfirmed' ) {
+ return( false );
+ }
+ }
+ return( true );
+ }
+
/**
* Does the title correspond to a protected article?
* @param string $what the action the page is protected from,
* Can $wgUser perform $action this page?
* @param string $action action that permission needs to be checked for
* @return boolean
- * @access private
+ * @private
*/
function userCan($action) {
$fname = 'Title::userCan';
wfProfileIn( $fname );
global $wgUser;
+
+ $result = null;
+ wfRunHooks( 'userCan', array( &$this, &$wgUser, $action, &$result ) );
+ if ( $result !== null ) {
+ wfProfileOut( $fname );
+ return $result;
+ }
+
if( NS_SPECIAL == $this->mNamespace ) {
wfProfileOut( $fname );
return false;
return false;
}
- # protect global styles and js
- if ( NS_MEDIAWIKI == $this->mNamespace
- && preg_match("/\\.(css|js)$/", $this->mTextform )
- && !$wgUser->isAllowed('editinterface') ) {
- wfProfileOut( $fname );
- return false;
- }
-
# protect css/js subpages of user pages
# XXX: this might be better using restrictions
# XXX: Find a way to work around the php bug that prevents using $this->userCanEditCssJsSubpage() from working
function userCanRead() {
global $wgUser;
+ $result = null;
+ wfRunHooks( 'userCan', array( &$this, &$wgUser, 'read', &$result ) );
+ if ( $result !== null ) {
+ return $result;
+ }
+
if( $wgUser->isAllowed('read') ) {
return true;
} else {
function isCssJsSubpage() {
return ( NS_USER == $this->mNamespace and preg_match("/\\.(css|js)$/", $this->mTextform ) );
}
+ /**
+ * Is this a *valid* .css or .js subpage of a user page?
+ * Check that the corresponding skin exists
+ */
+ function isValidCssJsSubpage() {
+ global $wgValidSkinNames;
+ return( $this->isCssJsSubpage() && array_key_exists( $this->getSkinFromCssJsSubpage(), $wgValidSkinNames ) );
+ }
+ /**
+ * Trim down a .css or .js subpage title to get the corresponding skin name
+ */
+ function getSkinFromCssJsSubpage() {
+ $subpage = explode( '/', $this->mTextform );
+ $subpage = $subpage[ count( $subpage ) - 1 ];
+ return( str_replace( array( '.css', '.js' ), array( '', '' ), $subpage ) );
+ }
/**
* Is this a .css subpage of a user page?
* @return bool
$dbr =& wfGetDB( DB_SLAVE );
$n = $dbr->selectField( 'archive', 'COUNT(*)', array( 'ar_namespace' => $this->getNamespace(),
'ar_title' => $this->getDBkey() ), $fname );
+ if( $this->getNamespace() == NS_IMAGE ) {
+ $n += $dbr->selectField( 'filearchive', 'COUNT(*)',
+ array( 'fa_name' => $this->getDBkey() ), $fname );
+ }
}
return (int)$n;
}
*
* @param string $name the text
* @return string the prefixed text
- * @access private
+ * @private
*/
/* private */ function prefix( $name ) {
global $wgContLang;
* namespace prefixes, sets the other forms, and canonicalizes
* everything.
* @return bool true on success
- * @access private
+ * @private
*/
/* private */ function secureAndSplit() {
global $wgContLang, $wgLocalInterwiki, $wgCapitalLinks;
$fname = 'Title::secureAndSplit';
- wfProfileIn( $fname );
# Initialisation
static $rxTc = false;
$t = trim( $t, '_' );
if ( '' == $t ) {
- wfProfileOut( $fname );
return false;
}
if( false !== strpos( $t, UTF8_REPLACEMENT ) ) {
# Contained illegal UTF-8 sequences or forbidden Unicode chars.
- wfProfileOut( $fname );
return false;
}
if( !$firstPass ) {
# Can't make a local interwiki link to an interwiki link.
# That's just crazy!
- wfProfileOut( $fname );
return false;
}
if ( 0 == strcasecmp( $this->mInterwiki, $wgLocalInterwiki ) ) {
if( $t == '' ) {
# Can't have an empty self-link
- wfProfileOut( $fname );
return false;
}
$this->mInterwiki = '';
# Do another namespace split...
continue;
}
+
+ # If there's an initial colon after the interwiki, that also
+ # resets the default namespace
+ if ( $t !== '' && $t[0] == ':' ) {
+ $this->mNamespace = NS_MAIN;
+ $t = substr( $t, 1 );
+ }
}
# If there's no recognized interwiki or namespace,
# then let the colon expression be part of the title.
# Reject illegal characters.
#
if( preg_match( $rxTc, $r ) ) {
- wfProfileOut( $fname );
return false;
}
strpos( $r, '/./' ) !== false ||
strpos( $r, '/../' ) !== false ) )
{
- wfProfileOut( $fname );
return false;
}
# We shouldn't need to query the DB for the size.
#$maxSize = $dbr->textFieldSize( 'page', 'page_title' );
if ( strlen( $r ) > 255 ) {
- wfProfileOut( $fname );
return false;
}
if( $t == '' &&
$this->mInterwiki == '' &&
$this->mNamespace != NS_MAIN ) {
- wfProfileOut( $fname );
return false;
}
+ // Any remaining initial :s are illegal.
+ if ( $t !== '' && ':' == $t{0} ) {
+ return false;
+ }
+
# Fill fields
$this->mDbkeyform = $t;
$this->mUrlform = wfUrlencode( $t );
$this->mTextform = str_replace( '_', ' ', $t );
- wfProfileOut( $fname );
return true;
}
* Get an array of Title objects linking to this Title
* Also stores the IDs in the link cache.
*
+ * WARNING: do not use this function on arbitrary user-supplied titles!
+ * On heavily-used templates it will max out the memory.
+ *
* @param string $options may be FOR UPDATE
* @return array the Title objects linking here
* @access public
* Get an array of Title objects using this Title as a template
* Also stores the IDs in the link cache.
*
+ * WARNING: do not use this function on arbitrary user-supplied titles!
+ * On heavily-used templates it will max out the memory.
+ *
* @param string $options may be FOR UPDATE
* @return array the Title objects linking here
* @access public
AND pl_title=page_title
WHERE pl_from=?
AND page_namespace IS NULL
- !",
+ !",
$db->tableName( 'pagelinks' ),
$db->tableName( 'page' ),
$this->getArticleId(),
);
}
+ function purgeSquid() {
+ global $wgUseSquid;
+ if ( $wgUseSquid ) {
+ $urls = $this->getSquidURLs();
+ $u = new SquidUpdate( $urls );
+ $u->doUpdate();
+ }
+ }
+
/**
* Move this page without authentication
* @param Title &$nt the new page Title
* @access public
*/
function isValidMoveOperation( &$nt, $auth = true ) {
- global $wgUser;
if( !$this or !$nt ) {
return 'badtitletext';
}
*
* @param Title &$nt the page to move to, which should currently
* be a redirect
- * @access private
+ * @private
*/
function moveOverExistingRedirect( &$nt, $reason = '' ) {
- global $wgUser, $wgUseSquid, $wgMwRedir;
+ global $wgUseSquid, $wgMwRedir;
$fname = 'Title::moveOverExistingRedirect';
$comment = wfMsgForContent( '1movedto2', $this->getPrefixedText(), $nt->getPrefixedText() );
/**
* Move page to non-existing title.
* @param Title &$nt the new Title
- * @access private
+ * @private
*/
function moveToNewTitle( &$nt, $reason = '' ) {
- global $wgUser, $wgUseSquid;
+ global $wgUseSquid;
global $wgMwRedir;
$fname = 'MovePageForm::moveToNewTitle';
$comment = wfMsgForContent( '1movedto2', $this->getPrefixedText(), $nt->getPrefixedText() );
'pl_title' => $nt->getDBkey() ),
$fname );
- # Non-existent target may have had broken links to it; these must
- # now be touched to update link coloring.
- $nt->touchLinks();
-
# Purge old title from squid
# The new title, and links to the new title, are purged in Article::onArticleCreate()
- $titles = $nt->getLinksTo();
- if ( $wgUseSquid ) {
- $urls = $this->getSquidURLs();
- foreach ( $titles as $linkTitle ) {
- $urls[] = $linkTitle->getInternalURL();
- }
- $u = new SquidUpdate( $urls );
- $u->doUpdate();
- }
+ $this->purgeSquid();
}
/**
* @access public
*/
function createRedirect( $dest, $comment ) {
- global $wgUser;
if ( $this->getArticleID() ) {
return false;
}
* @access public
*/
function getParentCategories() {
- global $wgContLang,$wgUser;
+ global $wgContLang;
$titlekey = $this->getArticleId();
$dbr =& wfGetDB( DB_SLAVE );
/**
* Get the revision ID of the previous revision
*
- * @param integer $revision Revision ID. Get the revision that was before this one.
+ * @param integer $revId Revision ID. Get the revision that was before this one.
+ * @param string $timestamp The timestamp of the current revision, if known
* @return interger $oldrevision|false
*/
- function getPreviousRevisionID( $revision ) {
- $dbr =& wfGetDB( DB_SLAVE );
+ function getPreviousRevisionID( $revId, $timestamp = false ) {
return $dbr->selectField( 'revision', 'rev_id',
'rev_page=' . intval( $this->getArticleId() ) .
' AND rev_id<' . intval( $revision ) . ' ORDER BY rev_id DESC' );
* @return bool
*/
function equals( $title ) {
- return $this->getInterwiki() == $title->getInterwiki()
+ // Note: === is necessary for proper matching of number-like titles.
+ return $this->getInterwiki() === $title->getInterwiki()
&& $this->getNamespace() == $title->getNamespace()
- && $this->getDbkey() == $title->getDbkey();
+ && $this->getDbkey() === $title->getDbkey();
}
/**
}
/**
- * Update page_touched timestamps on pages linking to this title.
- * In principal, this could be backgrounded and could also do squid
- * purging.
+ * Update page_touched timestamps and send squid purge messages for
+ * pages linking to this title. May be sent to the job queue depending
+ * on the number of links. Typically called on create and delete.
*/
function touchLinks() {
- $fname = 'Title::touchLinks';
-
- $dbw =& wfGetDB( DB_MASTER );
-
- $res = $dbw->select( 'pagelinks',
- array( 'pl_from' ),
- array(
- 'pl_namespace' => $this->getNamespace(),
- 'pl_title' => $this->getDbKey() ),
- $fname );
-
- $toucharr = array();
- while( $row = $dbw->fetchObject( $res ) ) {
- $toucharr[] = $row->pl_from;
- }
- $dbw->freeResult( $res );
+ $u = new HTMLCacheUpdate( $this, 'pagelinks' );
+ $u->doUpdate();
- if( $this->getNamespace() == NS_CATEGORY ) {
- // Categories show up in a separate set of links as well
- $res = $dbw->select( 'categorylinks',
- array( 'cl_from' ),
- array( 'cl_to' => $this->getDbKey() ),
- $fname );
- while( $row = $dbw->fetchObject( $res ) ) {
- $toucharr[] = $row->cl_from;
- }
- $dbw->freeResult( $res );
+ if ( $this->getNamespace() == NS_CATEGORY ) {
+ $u = new HTMLCacheUpdate( $this, 'categorylinks' );
+ $u->doUpdate();
}
-
- if (!count($toucharr))
- return;
- $dbw->update( 'page', /* SET */ array( 'page_touched' => $dbw->timestamp() ),
- /* WHERE */ array( 'page_id' => $toucharr ),$fname);
}
function trackbackURL() {
trackback:ping=\"$tburl\" />
</rdf:RDF>";
}
+
+ /**
+ * Generate strings used for xml 'id' names in monobook tabs
+ * @return string
+ */
+ function getNamespaceKey() {
+ switch ($this->getNamespace()) {
+ case NS_MAIN:
+ case NS_TALK:
+ return 'nstab-main';
+ case NS_USER:
+ case NS_USER_TALK:
+ return 'nstab-user';
+ case NS_MEDIA:
+ return 'nstab-media';
+ case NS_SPECIAL:
+ return 'nstab-special';
+ case NS_PROJECT:
+ case NS_PROJECT_TALK:
+ return 'nstab-project';
+ case NS_IMAGE:
+ case NS_IMAGE_TALK:
+ return 'nstab-image';
+ case NS_MEDIAWIKI:
+ case NS_MEDIAWIKI_TALK:
+ return 'nstab-mediawiki';
+ case NS_TEMPLATE:
+ case NS_TEMPLATE_TALK:
+ return 'nstab-template';
+ case NS_HELP:
+ case NS_HELP_TALK:
+ return 'nstab-help';
+ case NS_CATEGORY:
+ case NS_CATEGORY_TALK:
+ return 'nstab-category';
+ default:
+ return 'nstab-' . strtolower( $this->getSubjectNsText() );
+ }
+ }
}
?>