PHP Linker::splitTrail方法代码示例

 /**
  * Make a link placeholder. The text returned can be later resolved to a real link with
  * replaceLinkHolders(). This is done for two reasons: firstly to avoid further
  * parsing of interwiki links, and secondly to allow all existence checks and
  * article length checks (for stub links) to be bundled into a single query.
  *
  */
 function makeHolder($nt, $text = '', $query = '', $trail = '', $prefix = '')
 {
     wfProfileIn(__METHOD__);
     if (!is_object($nt)) {
         # Fail gracefully
         $retVal = "<!-- ERROR -->{$prefix}{$text}{$trail}";
     } else {
         # Separate the link trail from the rest of the link
         list($inside, $trail) = Linker::splitTrail($trail);
         $entry = array('title' => $nt, 'text' => $prefix . $text . $inside, 'pdbk' => $nt->getPrefixedDBkey());
         if ($query !== '') {
             $entry['query'] = $query;
         }
         if ($nt->isExternal()) {
             // Use a globally unique ID to keep the objects mergable
             $key = $this->parent->nextLinkID();
             $this->interwikis[$key] = $entry;
             $retVal = "<!--IWLINK {$key}-->{$trail}";
         } else {
             $key = $this->parent->nextLinkID();
             $ns = $nt->getNamespace();
             $this->internals[$ns][$key] = $entry;
             $retVal = "<!--LINK {$ns}:{$key}-->{$trail}";
         }
         $this->size++;
     }
     wfProfileOut(__METHOD__);
     return $retVal;
 }

 /**
  * Render a forced-blue link inline; protect against double expansion of
  * URLs if we're in a mode that prepends full URL prefixes to internal links.
  * Since this little disaster has to split off the trail text to avoid
  * breaking URLs in the following text without breaking trails on the
  * wiki links, it's been made into a horrible function.
  *
  * @param Title $nt
  * @param string $text
  * @param array|string $query
  * @param string $trail
  * @param string $prefix
  * @return string HTML-wikitext mix oh yuck
  */
 function makeKnownLinkHolder($nt, $text = '', $query = array(), $trail = '', $prefix = '')
 {
     list($inside, $trail) = Linker::splitTrail($trail);
     if (is_string($query)) {
         $query = wfCgiToArray($query);
     }
     if ($text == '') {
         $text = htmlspecialchars($nt->getPrefixedText());
     }
     $link = Linker::linkKnown($nt, "{$prefix}{$text}{$inside}", array(), $query);
     return $this->armorLinks($link) . $trail;
 }

 /**
  * Render a forced-blue link inline; protect against double expansion of
  * URLs if we're in a mode that prepends full URL prefixes to internal links.
  * Since this little disaster has to split off the trail text to avoid
  * breaking URLs in the following text without breaking trails on the
  * wiki links, it's been made into a horrible function.
  *
  * @param Title $nt
  * @param string $text
  * @param string $query
  * @param string $trail
  * @param string $prefix
  * @return string HTML-wikitext mix oh yuck
  */
 function makeKnownLinkHolder($nt, $text = '', $query = '', $trail = '', $prefix = '')
 {
     list($inside, $trail) = Linker::splitTrail($trail);
     $sk = $this->mOptions->getSkin();
     $link = $sk->makeKnownLinkObj($nt, $text, $query, $inside, $prefix);
     return $this->armorLinks($link) . $trail;
 }

    /**
     * Formats wiki links and media links in text; all other wiki formatting
     * is ignored
     *
     * @todo FIXME: Doesn't handle sub-links as in image thumb texts like the main parser
     * @param string $comment Text to format links in. WARNING! Since the output of this
     *	function is html, $comment must be sanitized for use as html. You probably want
     *	to pass $comment through Sanitizer::escapeHtmlAllowEntities() before calling
     *	this function.
     * @param Title|null $title An optional title object used to links to sections
     * @param bool $local Whether section links should refer to local page
     * @param string|null $wikiId Id of the wiki to link to (if not the local wiki),
     *  as used by WikiMap.
     *
     * @return string
     */
    public static function formatLinksInComment($comment, $title = null, $local = false, $wikiId = null)
    {
        return preg_replace_callback('/
				\\[\\[
				:? # ignore optional leading colon
				([^\\]|]+) # 1. link target; page names cannot include ] or |
				(?:\\|
					# 2. a pipe-separated substring; only the last is captured
					# Stop matching at | and ]] without relying on backtracking.
					((?:]?[^\\]|])*+)
				)*
				\\]\\]
				([^[]*) # 3. link trail (the text up until the next link)
			/x', function ($match) use($title, $local, $wikiId) {
            global $wgContLang;
            $medians = '(?:' . preg_quote(MWNamespace::getCanonicalName(NS_MEDIA), '/') . '|';
            $medians .= preg_quote($wgContLang->getNsText(NS_MEDIA), '/') . '):';
            $comment = $match[0];
            # fix up urlencoded title texts (copied from Parser::replaceInternalLinks)
            if (strpos($match[1], '%') !== false) {
                $match[1] = strtr(rawurldecode($match[1]), array('<' => '&lt;', '>' => '&gt;'));
            }
            # Handle link renaming [[foo|text]] will show link as "text"
            if ($match[2] != "") {
                $text = $match[2];
            } else {
                $text = $match[1];
            }
            $submatch = array();
            $thelink = null;
            if (preg_match('/^' . $medians . '(.*)$/i', $match[1], $submatch)) {
                # Media link; trail not supported.
                $linkRegexp = '/\\[\\[(.*?)\\]\\]/';
                $title = Title::makeTitleSafe(NS_FILE, $submatch[1]);
                if ($title) {
                    $thelink = Linker::makeMediaLinkObj($title, $text);
                }
            } else {
                # Other kind of link
                if (preg_match($wgContLang->linkTrail(), $match[3], $submatch)) {
                    $trail = $submatch[1];
                } else {
                    $trail = "";
                }
                $linkRegexp = '/\\[\\[(.*?)\\]\\]' . preg_quote($trail, '/') . '/';
                if (isset($match[1][0]) && $match[1][0] == ':') {
                    $match[1] = substr($match[1], 1);
                }
                list($inside, $trail) = Linker::splitTrail($trail);
                $linkText = $text;
                $linkTarget = Linker::normalizeSubpageLink($title, $match[1], $linkText);
                $target = Title::newFromText($linkTarget);
                if ($target) {
                    if ($target->getText() == '' && !$target->isExternal() && !$local && $title) {
                        $newTarget = clone $title;
                        $newTarget->setFragment('#' . $target->getFragment());
                        $target = $newTarget;
                    }
                    $thelink = Linker::makeCommentLink($target, $linkText . $inside, $wikiId) . $trail;
                }
            }
            if ($thelink) {
                // If the link is still valid, go ahead and replace it in!
                $comment = preg_replace($linkRegexp, StringUtils::escapeRegexReplacement($thelink), $comment, 1);
            }
            return $comment;
        }, $comment);
    }

 public function splitTrail($trail)
 {
     return Linker::splitTrail($trail);
 }

 function makeSelfLinkObj($nt, $text = '', $query = '', $trail = '', $prefix = '')
 {
     $args = '';
     if ('' == $text) {
         $text = $nt->mDbkeyform;
     }
     list($inside, $trail) = Linker::splitTrail($trail);
     $title = "{$prefix}{$text}";
     if ($text == 'RTENOTITLE') {
         // 2223
         $args .= '_fcknotitle="true" ';
         $title = $nt->mDbkeyform;
     }
     return "<a {$args}href=\"" . $nt->mDbkeyform . "\" class=\"selflink\">{$title}</a>{$inside}{$trail}";
 }

 /**
  * Render a forced-blue link inline; protect against double expansion of
  * URLs if we're in a mode that prepends full URL prefixes to internal links.
  * Since this little disaster has to split off the trail text to avoid
  * breaking URLs in the following text without breaking trails on the
  * wiki links, it's been made into a horrible function.
  *
  * @param Title $nt
  * @param string $text
  * @param string $trail
  * @param string $prefix
  * @return string HTML-wikitext mix oh yuck
  */
 protected function makeKnownLinkHolder($nt, $text = '', $trail = '', $prefix = '')
 {
     list($inside, $trail) = Linker::splitTrail($trail);
     if ($text == '') {
         $text = htmlspecialchars($nt->getPrefixedText());
     }
     $link = $this->getLinkRenderer()->makeKnownLink($nt, new HtmlArmor("{$prefix}{$text}{$inside}"));
     return $this->armorLinks($link) . $trail;
 }

 /**
  * Pass a title object, not a title string
  */
 function makeBrokenImageLinkObj($nt, $text = '', $query = '', $trail = '', $prefix = '')
 {
     # Fail gracefully
     if (!isset($nt)) {
         # wfDebugDieBacktrace();
         return "<!-- ERROR -->{$prefix}{$text}{$trail}";
     }
     $fname = 'Linker::makeBrokenImageLinkObj';
     wfProfileIn($fname);
     $q = 'wpDestFile=' . urlencode($nt->getDBkey());
     if ('' != $query) {
         $q .= "&{$query}";
     }
     $uploadTitle = Title::makeTitle(NS_SPECIAL, 'Upload');
     $url = $uploadTitle->escapeLocalURL($q);
     if ('' == $text) {
         $text = htmlspecialchars($nt->getPrefixedText());
     }
     $style = $this->getInternalLinkAttributesObj($nt, $text, "yes");
     list($inside, $trail) = Linker::splitTrail($trail);
     $s = "<a href=\"{$url}\"{$style}>{$prefix}{$text}{$inside}</a>{$trail}";
     wfProfileOut($fname);
     return $s;
 }

 /** 
  * Make appropriate markup for a link to the current article. This is currently rendered
  * as the bold link text. The calling sequence is the same as the other make*LinkObj functions,
  * despite $query not being used.
  */
 function makeSelfLinkObj($nt, $text = '', $query = '', $trail = '', $prefix = '')
 {
     if ('' == $text) {
         $text = htmlspecialchars($nt->getPrefixedText());
     }
     list($inside, $trail) = Linker::splitTrail($trail);
     return "<strong class=\"selflink\">{$prefix}{$text}{$inside}</strong>{$trail}";
 }

 /**
  * @deprecated Use link()
  *
  * Make a red link to the edit page of a given title.
  *
  * @param $nt Title object of the target page
  * @param $text  String: Link text
  * @param $query String: Optional query part
  * @param $trail String: Optional trail. Alphabetic characters at the start of this string will
  *                      be included in the link text. Other characters will be appended after
  *                      the end of the link.
  */
 function makeBrokenLinkObj($title, $text = '', $query = '', $trail = '', $prefix = '')
 {
     wfProfileIn(__METHOD__);
     list($inside, $trail) = Linker::splitTrail($trail);
     if ($text === '') {
         $text = $this->linkText($title);
     }
     $nt = $this->normaliseSpecialPage($title);
     $ret = $this->link($title, "{$prefix}{$text}{$inside}", array(), wfCgiToArray($query), 'broken') . $trail;
     wfProfileOut(__METHOD__);
     return $ret;
 }

 /**
  * Render a forced-blue link inline; protect against double expansion of
  * URLs if we're in a mode that prepends full URL prefixes to internal links.
  * Since this little disaster has to split off the trail text to avoid
  * breaking URLs in the following text without breaking trails on the
  * wiki links, it's been made into a horrible function.
  *
  * @param $nt Title
  * @param $text String
  * @param $query String
  * @param $trail String
  * @param $prefix String
  * @return String: HTML-wikitext mix oh yuck
  */
 function makeKnownLinkHolder($nt, $text = '', $query = '', $trail = '', $prefix = '')
 {
     list($inside, $trail) = Linker::splitTrail($trail);
     $sk = $this->mOptions->getSkin($this->mTitle);
     # FIXME: use link() instead of deprecated makeKnownLinkObj()
     $link = $sk->makeKnownLinkObj($nt, $text, $query, $inside, $prefix);
     return $this->armorLinks($link) . $trail;
 }