PHP ContentHandler::deprecated方法代碼示例

 /**
  * Extract a redirect destination from a string and return an
  * array of Titles, or null if the text doesn't contain a valid redirect
  * The last element in the array is the final destination after all redirects
  * have been resolved (up to $wgMaxRedirects times)
  *
  * @param string $text Text with possible redirect
  * @return Title[] Array of Titles, with the destination last
  * @deprecated since 1.21, use Content::getRedirectChain instead.
  */
 public static function newFromRedirectArray($text)
 {
     ContentHandler::deprecated(__METHOD__, '1.21');
     $content = ContentHandler::makeContent($text, null, CONTENT_MODEL_WIKITEXT);
     return $content->getRedirectChain();
 }

	/**
	 * Return an applicable autosummary if one exists for the given edit.
	 * @param string|null $oldtext the previous text of the page.
	 * @param string|null $newtext The submitted text of the page.
	 * @param int $flags bitmask: a bitmask of flags submitted for the edit.
	 * @return string An appropriate autosummary, or an empty string.
	 *
	 * @deprecated since 1.21, use ContentHandler::getAutosummary() instead
	 */
	public static function getAutosummary( $oldtext, $newtext, $flags ) {
		// NOTE: stub for backwards-compatibility. assumes the given text is wikitext. will break horribly if it isn't.

		ContentHandler::deprecated( __METHOD__, '1.21' );

		$handler = ContentHandler::getForModelID( CONTENT_MODEL_WIKITEXT );
		$oldContent = is_null( $oldtext ) ? null : $handler->unserializeContent( $oldtext );
		$newContent = is_null( $newtext ) ? null : $handler->unserializeContent( $newtext );

		return $handler->getAutosummary( $oldContent, $newContent, $flags );
	}

 /**
  * @return string
  *
  * @deprecated Since 1.21, use getContent() instead.
  */
 function getText()
 {
     ContentHandler::deprecated(__METHOD__, '1.21');
     return $this->text;
 }

 /**
  * Use specified text instead of loading from the database
  * @deprecated since 1.21, use setContent() instead.
  */
 public function setText($oldText, $newText)
 {
     ContentHandler::deprecated(__METHOD__, "1.21");
     $oldContent = ContentHandler::makeContent($oldText, $this->getTitle());
     $newContent = ContentHandler::makeContent($newText, $this->getTitle());
     $this->setContent($oldContent, $newContent);
 }

 /**
  * Get text of an article from database
  * Does *NOT* follow redirects.
  *
  * @protected
  * @note this is really internal functionality that should really NOT be used by other functions. For accessing
  *       article content, use the WikiPage class, especially WikiBase::getContent(). However, a lot of legacy code
  *       uses this method to retrieve page text from the database, so the function has to remain public for now.
  *
  * @return mixed string containing article contents, or false if null
  * @deprecated in 1.21, use WikiPage::getContent() instead
  */
 function fetchContent()
 {
     #BC cruft!
     ContentHandler::deprecated(__METHOD__, '1.21');
     if ($this->mContentLoaded && $this->mContent) {
         return $this->mContent;
     }
     wfProfileIn(__METHOD__);
     $content = $this->fetchContentObject();
     $this->mContent = ContentHandler::getContentText($content);
     #@todo: get rid of mContent everywhere!
     ContentHandler::runLegacyHooks('ArticleAfterFetchContent', array(&$this, &$this->mContent));
     wfProfileOut(__METHOD__);
     return $this->mContent;
 }

 /**
  * Get text of an article from database
  * Does *NOT* follow redirects.
  *
  * @protected
  * @note This is really internal functionality that should really NOT be
  * used by other functions. For accessing article content, use the WikiPage
  * class, especially WikiBase::getContent(). However, a lot of legacy code
  * uses this method to retrieve page text from the database, so the function
  * has to remain public for now.
  *
  * @return string|bool String containing article contents, or false if null
  * @deprecated since 1.21, use WikiPage::getContent() instead
  */
 function fetchContent()
 {
     // BC cruft!
     ContentHandler::deprecated(__METHOD__, '1.21');
     if ($this->mContentLoaded && $this->mContent) {
         return $this->mContent;
     }
     $content = $this->fetchContentObject();
     if (!$content) {
         return false;
     }
     // @todo Get rid of mContent everywhere!
     $this->mContent = ContentHandler::getContentText($content);
     ContentHandler::runLegacyHooks('ArticleAfterFetchContent', array(&$this, &$this->mContent));
     return $this->mContent;
 }

 /**
  * Attempts to merge text content with base and current revisions
  *
  * @param $editText string
  *
  * @return bool
  * @deprecated since 1.21, use mergeChangesIntoContent() instead
  */
 function mergeChangesInto(&$editText)
 {
     ContentHandler::deprecated(__METHOD__, "1.21");
     $editContent = $this->toEditContent($editText);
     $ok = $this->mergeChangesIntoContent($editContent);
     if ($ok) {
         $editText = $this->toEditText($editContent);
         return true;
     }
     return false;
 }

 /**
  * Fetch revision text without regard for view restrictions
  *
  * @return String
  *
  * @deprecated since 1.21. Instead, use Revision::getContent( Revision::RAW )
  *                         or Revision::getSerializedData() as appropriate.
  */
 public function getRawText()
 {
     ContentHandler::deprecated(__METHOD__, "1.21");
     return $this->getText(self::RAW);
 }

 /**
  * Call to WikiPage function for backwards compatibility.
  * @see WikiPage::getText
  */
 public function getText($audience = Revision::FOR_PUBLIC, User $user = null)
 {
     ContentHandler::deprecated(__METHOD__, '1.21');
     return $this->mPage->getText($audience, $user);
 }

 /**
  * Call to WikiPage function for backwards compatibility.
  * @see WikiPage::replaceSection
  */
 public function replaceSection($sectionId, $text, $sectionTitle = '', $edittime = null)
 {
     ContentHandler::deprecated(__METHOD__, '1.21');
     return $this->mPage->replaceSection($sectionId, $text, $sectionTitle, $edittime);
 }

 /**
  * @private
  * @todo document
  *
  * @param $editText string
  *
  * @return bool
  * @deprecated since 1.21, use mergeChangesIntoContent() instead
  */
 function mergeChangesInto(&$editText)
 {
     ContentHandler::deprecated(__METHOD__, "1.21");
     wfProfileIn(__METHOD__);
     $db = wfGetDB(DB_MASTER);
     // This is the revision the editor started from
     $baseRevision = $this->getBaseRevision();
     if (is_null($baseRevision)) {
         wfProfileOut(__METHOD__);
         return false;
     }
     $baseText = $baseRevision->getText();
     // The current state, we want to merge updates into it
     $currentRevision = Revision::loadFromTitle($db, $this->mTitle);
     if (is_null($currentRevision)) {
         wfProfileOut(__METHOD__);
         return false;
     }
     $currentText = $currentRevision->getText();
     $result = '';
     $editText = $this->toEditText($editText);
     if (wfMerge($baseText, $editText, $currentText, $result)) {
         $editText = $result;
         wfProfileOut(__METHOD__);
         return true;
     } else {
         wfProfileOut(__METHOD__);
         return false;
     }
 }

 /**
  * Fetch revision text if it's available to the specified audience.
  * If the specified audience does not have the ability to view this
  * revision, an empty string will be returned.
  *
  * @param int $audience One of:
  *   Revision::FOR_PUBLIC       to be displayed to all users
  *   Revision::FOR_THIS_USER    to be displayed to the given user
  *   Revision::RAW              get the text regardless of permissions
  * @param User $user User object to check for, only if FOR_THIS_USER is passed
  *   to the $audience parameter
  *
  * @deprecated since 1.21, use getContent() instead
  * @todo Replace usage in core
  * @return string
  */
 public function getText($audience = self::FOR_PUBLIC, User $user = null)
 {
     ContentHandler::deprecated(__METHOD__, '1.21');
     $content = $this->getContent($audience, $user);
     return ContentHandler::getContentText($content);
     # returns the raw content text, if applicable
 }

 /**
  * Generate a diff, no caching
  *
  * @param string $otext Old text, must be already segmented
  * @param string $ntext New text, must be already segmented
  *
  * @return bool|string
  * @deprecated since 1.21, use generateContentDiffBody() instead!
  */
 public function generateDiffBody($otext, $ntext)
 {
     ContentHandler::deprecated(__METHOD__, "1.21");
     return $this->generateTextDiffBody($otext, $ntext);
 }