Файловый менеджер - Редактировать - /var/www/html/mediawiki-1.43.1/includes/linker/LinkRenderer.php
Ðазад
<?php /** * 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 * @author Kunal Mehta <legoktm@debian.org> */ namespace MediaWiki\Linker; use HtmlArmor; use MediaWiki\Cache\LinkCache; use MediaWiki\Config\ServiceOptions; use MediaWiki\HookContainer\HookContainer; use MediaWiki\HookContainer\HookRunner; use MediaWiki\Html\Html; use MediaWiki\Language\Language; use MediaWiki\Message\Message; use MediaWiki\Page\PageReference; use MediaWiki\Parser\Parser; use MediaWiki\Parser\Sanitizer; use MediaWiki\SpecialPage\SpecialPageFactory; use MediaWiki\Title\Title; use MediaWiki\Title\TitleFormatter; use MediaWiki\Title\TitleValue; use Wikimedia\Assert\Assert; /** * Class that generates HTML for internal links. * See the Linker class for other kinds of links. * * @see https://www.mediawiki.org/wiki/Manual:LinkRenderer * @since 1.28 */ class LinkRenderer { public const CONSTRUCTOR_OPTIONS = [ 'renderForComment', ]; /** * Whether to force the pretty article path * * @var bool */ private $forceArticlePath = false; /** * A PROTO_* constant or false * * @var string|bool|int */ private $expandUrls = false; /** * Whether links are being rendered for comments. * * @var bool */ private $comment = false; /** * @var TitleFormatter */ private $titleFormatter; /** * @var LinkCache */ private $linkCache; /** @var HookRunner */ private $hookRunner; /** * @var SpecialPageFactory */ private $specialPageFactory; /** * @internal For use by LinkRendererFactory * * @param TitleFormatter $titleFormatter * @param LinkCache $linkCache * @param SpecialPageFactory $specialPageFactory * @param HookContainer $hookContainer * @param ServiceOptions $options */ public function __construct( TitleFormatter $titleFormatter, LinkCache $linkCache, SpecialPageFactory $specialPageFactory, HookContainer $hookContainer, ServiceOptions $options ) { $options->assertRequiredOptions( self::CONSTRUCTOR_OPTIONS ); $this->comment = $options->get( 'renderForComment' ); $this->titleFormatter = $titleFormatter; $this->linkCache = $linkCache; $this->specialPageFactory = $specialPageFactory; $this->hookRunner = new HookRunner( $hookContainer ); } /** * Whether to force the link to use the article path ($wgArticlePath) even if * a query string is present, resulting in URLs like /wiki/Main_Page?action=foobar. * * @param bool $force */ public function setForceArticlePath( $force ) { $this->forceArticlePath = $force; } /** * @return bool * @see setForceArticlePath() */ public function getForceArticlePath() { return $this->forceArticlePath; } /** * Whether/how to expand URLs. * * @param string|bool|int $expand A PROTO_* constant or false for no expansion * @see UrlUtils::expand() */ public function setExpandURLs( $expand ) { $this->expandUrls = $expand; } /** * @return string|bool|int a PROTO_* constant or false for no expansion * @see setExpandURLs() */ public function getExpandURLs() { return $this->expandUrls; } /** * True when the links will be rendered in an edit summary or log comment. * * @return bool */ public function isForComment(): bool { // This option only exists to power a hack in Wikibase's onHtmlPageLinkRendererEnd hook. return $this->comment; } /** * Render a wikilink. * Will call makeKnownLink() or makeBrokenLink() as appropriate. * * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @param-taint $target none * @param string|HtmlArmor|null $text Text that the user can click on to visit the link. * @param-taint $text escapes_html * @param array $extraAttribs Attributes you would like to add to the <a> tag. For example, if * you would like to add title="Text when hovering!", you would set this to [ 'title' => 'Text * when hovering!' ] * @param-taint $extraAttribs none * @param array $query Parameters you would like to add to the URL. For example, if you would * like to add ?redirect=no&debug=1, you would set this to [ 'redirect' => 'no', 'debug' => '1' ] * @param-taint $query none * @return string HTML * @return-taint escaped */ public function makeLink( $target, $text = null, array $extraAttribs = [], array $query = [] ) { Assert::parameterType( [ LinkTarget::class, PageReference::class ], $target, '$target' ); if ( $this->castToTitle( $target )->isKnown() ) { return $this->makeKnownLink( $target, $text, $extraAttribs, $query ); } else { return $this->makeBrokenLink( $target, $text, $extraAttribs, $query ); } } private function runBeginHook( $target, &$text, &$extraAttribs, &$query ) { $ret = null; if ( !$this->hookRunner->onHtmlPageLinkRendererBegin( // @phan-suppress-next-line PhanTypeMismatchArgument Type mismatch on pass-by-ref args $this, $this->castToTitle( $target ), $text, $extraAttribs, $query, $ret ) ) { return $ret; } } /** * Make a link that's styled as if the target page exists (a "blue link"), with a specified * class attribute. * * Usually you should use makeLink() or makeKnownLink() instead, which will select the CSS * classes automatically. Use this method if the exact styling doesn't matter and you want * to ensure no extra DB lookup happens, e.g. for links generated by the skin. * * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @param-taint $target none * @param string|HtmlArmor|null $text Text that the user can click on to visit the link. * @param-taint $text escapes_html * @param string $classes CSS classes to add * @param-taint $classes none * @param array $extraAttribs Attributes you would like to add to the <a> tag. For example, if * you would like to add title="Text when hovering!", you would set this to [ 'title' => 'Text * when hovering!' ] * @param-taint $extraAttribs none * @param array $query Parameters you would like to add to the URL. For example, if you would * like to add ?redirect=no&debug=1, you would set this to [ 'redirect' => 'no', 'debug' => '1' ] * @param-taint $query none * @return string * @return-taint escaped */ public function makePreloadedLink( $target, $text = null, $classes = '', array $extraAttribs = [], array $query = [] ) { Assert::parameterType( [ LinkTarget::class, PageReference::class ], $target, '$target' ); // Run begin hook $ret = $this->runBeginHook( $target, $text, $extraAttribs, $query ); if ( $ret !== null ) { return $ret; } $target = $this->normalizeTarget( $target ); $url = $this->getLinkURL( $target, $query ); $attribs = [ 'class' => $classes ]; $prefixedText = $this->titleFormatter->getPrefixedText( $target ); if ( $prefixedText !== '' ) { $attribs['title'] = $prefixedText; } $attribs = [ 'href' => $url, ] + $this->mergeAttribs( $attribs, $extraAttribs ); $text ??= $this->getLinkText( $target ); return $this->buildAElement( $target, $text, $attribs, true ); } /** * Make a link that's styled as if the target page exists (usually a "blue link", although the * styling might depend on e.g. whether the target is a redirect). * * This will result in a DB lookup if the title wasn't cached yet. If you want to avoid that, * and don't care about matching the exact styling of links within page content, you can use * makePreloadedLink() instead. * * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @param-taint $target none * @param string|HtmlArmor|null $text Text that the user can click on to visit the link. * @param-taint $text escapes_html * @param array $extraAttribs Attributes you would like to add to the <a> tag. For example, if * you would like to add title="Text when hovering!", you would set this to [ 'title' => 'Text * when hovering!' ] * @param-taint $extraAttribs none * @param array $query Parameters you would like to add to the URL. For example, if you would * like to add ?redirect=no&debug=1, you would set this to [ 'redirect' => 'no', 'debug' => '1' ] * @param-taint $query none * @return string HTML * @return-taint escaped */ public function makeKnownLink( $target, $text = null, array $extraAttribs = [], array $query = [] ) { Assert::parameterType( [ LinkTarget::class, PageReference::class ], $target, '$target' ); if ( $target instanceof LinkTarget ) { $isExternal = $target->isExternal(); } else { // $target instanceof PageReference // treat all PageReferences as local for now $isExternal = false; } $classes = []; if ( $isExternal ) { $classes[] = 'extiw'; } $colour = $this->getLinkClasses( $target ); if ( $colour !== '' ) { $classes[] = $colour; } return $this->makePreloadedLink( $target, $text, implode( ' ', $classes ), $extraAttribs, $query ); } /** * Make a link that's styled as if the target page doesn't exist (a "red link"). * * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @param-taint $target none * @param string|HtmlArmor|null $text Text that the user can click on to visit the link. * @param-taint $text escapes_html * @param array $extraAttribs Attributes you would like to add to the <a> tag. For example, if * you would like to add title="Text when hovering!", you would set this to [ 'title' => 'Text * when hovering!' ] * @param-taint $extraAttribs none * @param array $query Parameters you would like to add to the URL. For example, if you would * like to add ?redirect=no&debug=1, you would set this to [ 'redirect' => 'no', 'debug' => '1' ] * @param-taint $query none * @return string * @return-taint escaped */ public function makeBrokenLink( $target, $text = null, array $extraAttribs = [], array $query = [] ) { Assert::parameterType( [ LinkTarget::class, PageReference::class ], $target, '$target' ); // Run legacy hook $ret = $this->runBeginHook( $target, $text, $extraAttribs, $query ); if ( $ret !== null ) { return $ret; } if ( $target instanceof LinkTarget ) { # We don't want to include fragments for broken links, because they # generally make no sense. if ( $target->hasFragment() ) { $target = $target->createFragmentTarget( '' ); } } $target = $this->normalizeTarget( $target ); if ( !isset( $query['action'] ) && $target->getNamespace() !== NS_SPECIAL ) { $query['action'] = 'edit'; $query['redlink'] = '1'; } $url = $this->getLinkURL( $target, $query ); $attribs = [ 'class' => 'new' ]; $prefixedText = $this->titleFormatter->getPrefixedText( $target ); if ( $prefixedText !== '' ) { // This ends up in parser cache! $attribs['title'] = wfMessage( 'red-link-title', $prefixedText ) ->inContentLanguage() ->text(); } $attribs = [ 'href' => $url, ] + $this->mergeAttribs( $attribs, $extraAttribs ); $text ??= $this->getLinkText( $target ); return $this->buildAElement( $target, $text, $attribs, false ); } /** * Make an external link * * @since 1.43 * @param string $url URL to link to * @param-taint $url escapes_html * @param string|HtmlArmor|Message $text Text of link; will be escaped if * a string. * @param-taint $text escapes_html * @param LinkTarget $title LinkTarget object used for title specific link attributes * @param-taint $title none * @param string $linktype Type of external link. Gets added to the classes * @param-taint $linktype escapes_html * @param array $attribs Array of extra attributes to <a> * @param-taint $attribs escapes_html * @return string */ public function makeExternalLink( string $url, $text, LinkTarget $title, $linktype = '', $attribs = [] ) { $class = 'external'; if ( $linktype ) { $class .= " $linktype"; } if ( isset( $attribs['class'] ) && $attribs['class'] ) { $class .= " {$attribs['class']}"; } $attribs['class'] = $class; if ( $text instanceof Message ) { $text = $text->escaped(); } else { $text = HtmlArmor::getHtml( $text ); // Tell phan that $text is non-null after ::getHtml() '@phan-var string $text'; } $newRel = Parser::getExternalLinkRel( $url, $title ); if ( !isset( $attribs['rel'] ) || $attribs['rel'] === '' ) { $attribs['rel'] = $newRel; } elseif ( $newRel !== null ) { // Merge the rel attributes. $newRels = explode( ' ', $newRel ); $oldRels = explode( ' ', $attribs['rel'] ); $combined = array_unique( array_merge( $newRels, $oldRels ) ); $attribs['rel'] = implode( ' ', $combined ); } $link = ''; $success = $this->hookRunner->onLinkerMakeExternalLink( $url, $text, $link, $attribs, $linktype ); if ( !$success ) { wfDebug( "Hook LinkerMakeExternalLink changed the output of link " . "with url {$url} and text {$text} to {$link}" ); return $link; } $attribs['href'] = $url; return Html::rawElement( 'a', $attribs, $text ); } /** * Return the HTML for the top of a redirect page * * Chances are you should just be using the ParserOutput from * WikitextContent::getParserOutput (which will have this header added * automatically) instead of calling this for redirects. * * If creating your own redirect-alike, please use return value of * this method to set the 'core:redirect-header' extension data field * in your ParserOutput, rather than concatenating HTML directly. * See WikitextContentHandler::fillParserOutput(). * * @since 1.41 * @param Language $lang * @param Title $target Destination to redirect * @param bool $forceKnown Should the image be shown as a bluelink regardless of existence? * @return string Containing HTML with redirect link */ public function makeRedirectHeader( Language $lang, Title $target, bool $forceKnown = false ) { $html = '<ul class="redirectText">'; if ( $forceKnown ) { $link = $this->makeKnownLink( $target, $target->getFullText(), [], // Make sure wiki page redirects are not followed $target->isRedirect() ? [ 'redirect' => 'no' ] : [] ); } else { $link = $this->makeLink( $target, $target->getFullText(), [], // Make sure wiki page redirects are not followed $target->isRedirect() ? [ 'redirect' => 'no' ] : [] ); } $redirectToText = wfMessage( 'redirectto' )->inLanguage( $lang )->escaped(); return Html::rawElement( 'div', [ 'class' => 'redirectMsg' ], Html::rawElement( 'p', [], $redirectToText ) . Html::rawElement( 'ul', [ 'class' => 'redirectText' ], Html::rawElement( 'li', [], $link ) ) ); } /** * Builds the final <a> element * * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @param-taint $target none * @param string|HtmlArmor $text * @param-taint $text escapes_html * @param array $attribs * @param-taint $attribs none * @param bool $isKnown * @param-taint $isKnown none * @return null|string * @return-taint escaped */ private function buildAElement( $target, $text, array $attribs, $isKnown ) { $ret = null; if ( !$this->hookRunner->onHtmlPageLinkRendererEnd( // @phan-suppress-next-line PhanTypeMismatchArgument Type mismatch on pass-by-ref args $this, $this->castToLinkTarget( $target ), $isKnown, $text, $attribs, $ret ) ) { return $ret; } return Html::rawElement( 'a', $attribs, HtmlArmor::getHtml( $text ) ); } /** * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @return string */ private function getLinkText( $target ) { $prefixedText = $this->titleFormatter->getPrefixedText( $target ); // If the target is just a fragment, with no title, we return the fragment // text. Otherwise, we return the title text itself. if ( $prefixedText === '' && $target instanceof LinkTarget && $target->hasFragment() ) { return $target->getFragment(); } return $prefixedText; } /** * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @param array $query Parameters you would like to add to the URL. For example, if you would * like to add ?redirect=no&debug=1, you would set this to [ 'redirect' => 'no', 'debug' => '1' ] * @return string non-escaped text */ private function getLinkURL( $target, $query = [] ) { if ( $this->forceArticlePath ) { $realQuery = $query; $query = []; } else { $realQuery = []; } $url = $this->castToTitle( $target )->getLinkURL( $query, false, $this->expandUrls ); if ( $this->forceArticlePath && $realQuery ) { $url = wfAppendQuery( $url, $realQuery ); } return $url; } /** * Normalizes the provided target * * @internal For use by Linker::getImageLinkMTOParams() * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @return LinkTarget */ public function normalizeTarget( $target ) { $target = $this->castToLinkTarget( $target ); if ( $target->getNamespace() === NS_SPECIAL && !$target->isExternal() ) { [ $name, $subpage ] = $this->specialPageFactory->resolveAlias( $target->getDBkey() ); if ( $name ) { return new TitleValue( NS_SPECIAL, $this->specialPageFactory->getLocalNameFor( $name, $subpage ), $target->getFragment() ); } } return $target; } /** * Merges two sets of attributes * * @param array $defaults * @param array $attribs * * @return array */ private function mergeAttribs( $defaults, $attribs ) { if ( !$attribs ) { return $defaults; } # Merge the custom attribs with the default ones, and iterate # over that, deleting all "false" attributes. $ret = []; $merged = Sanitizer::mergeAttributes( $defaults, $attribs ); foreach ( $merged as $key => $val ) { # A false value suppresses the attribute if ( $val !== false ) { $ret[$key] = $val; } } return $ret; } /** * Returns CSS classes to add to a known link. * * Note that most CSS classes set on wikilinks are actually handled elsewhere (e.g. in * makeKnownLink() or in LinkHolderArray). * * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @return string CSS class */ public function getLinkClasses( $target ) { Assert::parameterType( [ LinkTarget::class, PageReference::class ], $target, '$target' ); $target = $this->castToLinkTarget( $target ); // Don't call LinkCache if the target is "non-proper" if ( $target->isExternal() || $target->getText() === '' || $target->getNamespace() < 0 ) { return ''; } // Make sure the target is in the cache $id = $this->linkCache->addLinkObj( $target ); if ( $id == 0 ) { // Doesn't exist return ''; } if ( $this->linkCache->getGoodLinkFieldObj( $target, 'redirect' ) ) { # Page is a redirect return 'mw-redirect'; } return ''; } /** * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @return Title */ private function castToTitle( $target ): Title { if ( $target instanceof LinkTarget ) { return Title::newFromLinkTarget( $target ); } // $target instanceof PageReference return Title::newFromPageReference( $target ); } /** * @param LinkTarget|PageReference $target Page that will be visited when the user clicks on the link. * @return LinkTarget */ private function castToLinkTarget( $target ): LinkTarget { if ( $target instanceof PageReference ) { return Title::newFromPageReference( $target ); } // $target instanceof LinkTarget return $target; } }
| ver. 1.1 | |
.
| PHP 8.4.18 | Ð“ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ñ Ñтраницы: 0 |
proxy
|
phpinfo
|
ÐаÑтройка