Файловый менеджер - Редактировать - /var/www/html/Status.zip
Ðазад
PK ! h� R�7 �7 StatusFormatter.phpnu �Iw�� <?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 */ namespace MediaWiki\Status; use MediaWiki\Api\ApiMessage; use MediaWiki\Language\Language; use MediaWiki\Language\RawMessage; use MediaWiki\Message\Message; use MediaWiki\Parser\ParserOutput; use MediaWiki\StubObject\StubUserLang; use MessageCache; use MessageLocalizer; use Psr\Log\LoggerInterface; use RuntimeException; use StatusValue; use UnexpectedValueException; use Wikimedia\Message\MessageParam; use Wikimedia\Message\MessageSpecifier; /** * Formatter for StatusValue objects. * * @since 1.42 * * @see StatusValue */ class StatusFormatter { private MessageLocalizer $messageLocalizer; private MessageCache $messageCache; private LoggerInterface $logger; public function __construct( MessageLocalizer $messageLocalizer, MessageCache $messageCache, LoggerInterface $logger ) { $this->messageLocalizer = $messageLocalizer; $this->messageCache = $messageCache; $this->logger = $logger; } /** * @param array $params * @param array $options * * @return array */ private function cleanParams( array $params, array $options = [] ) { $cleanCallback = $options['cleanCallback'] ?? null; if ( !$cleanCallback ) { return $params; } $cleanParams = []; foreach ( $params as $i => $param ) { $cleanParams[$i] = call_user_func( $cleanCallback, $param ); } return $cleanParams; } /** * Get the error list as a wikitext formatted list * * All message parameters that were provided as strings will be escaped with wfEscapeWikiText. * This is mostly a historical accident and often undesirable (T368821). * - To avoid this behavior when producing the Status, pass MessageSpecifier objects to methods * such as `$status->fatal()`, instead of separate key and params parameters. * - To avoid this behavior when consuming the Status, use the `$status->getMessages()` method * instead, and display each message separately (or combine then with `Message::listParams()`). * * @param StatusValue $status * @param array $options An array of options, supporting the following keys: * - 'shortContext' (string|false|null) A short enclosing context message name, to * be used when there is a single error * - 'longContext' (string|false|null) A long enclosing context message name, for a list * - 'lang' (string|Language|StubUserLang|null) Language to use for processing messages * - 'cleanCallback' (callable|null) A callback for sanitizing parameter values * * @return string */ public function getWikiText( StatusValue $status, array $options = [] ) { $shortContext = $options['shortContext'] ?? null; $longContext = $options['longContext'] ?? null; $lang = $options['lang'] ?? null; $rawErrors = $status->getErrors(); if ( count( $rawErrors ) === 0 ) { if ( $status->isOK() ) { $errMsg = __METHOD__ . " called for a good result, this is incorrect\n"; } else { $errMsg = __METHOD__ . ": Invalid result object: no error text but not OK\n"; } $status->fatal( 'internalerror_info', $errMsg ); $this->logger->warning( $errMsg, [ 'exception' => new RuntimeException() ] ); $rawErrors = $status->getErrors(); // just added a fatal } if ( count( $rawErrors ) === 1 ) { $s = $this->getErrorMessage( $rawErrors[0], $options )->plain(); if ( $shortContext ) { $s = $this->msgInLang( $shortContext, $lang, $s )->plain(); } elseif ( $longContext ) { $s = $this->msgInLang( $longContext, $lang, "* $s\n" )->plain(); } } else { $errors = $this->getErrorMessageArray( $rawErrors, $options ); foreach ( $errors as &$error ) { $error = $error->plain(); } $s = "<ul>\n<li>\n" . implode( "\n</li>\n<li>\n", $errors ) . "\n</li>\n</ul>\n"; if ( $longContext ) { $s = $this->msgInLang( $longContext, $lang, $s )->plain(); } elseif ( $shortContext ) { $s = $this->msgInLang( $shortContext, $lang, "\n$s\n" )->plain(); } } return $s; } /** * Get a bullet list of the errors as a Message object. * * All message parameters that were provided as strings will be escaped with wfEscapeWikiText. * This is mostly a historical accident and often undesirable (T368821). * - To avoid this behavior when producing the Status, pass MessageSpecifier objects to methods * such as `$status->fatal()`, instead of separate key and params parameters. * - To avoid this behavior when consuming the Status, use the `$status->getMessages()` method * instead, and display each message separately (or combine then with `Message::listParams()`). * * $shortContext and $longContext can be used to wrap the error list in some text. * $shortContext will be preferred when there is a single error; $longContext will be * preferred when there are multiple ones. In either case, $1 will be replaced with * the list of errors. * * $shortContext is assumed to use $1 as an inline parameter: if there is a single item, * it will not be made into a list; if there are multiple items, newlines will be inserted * around the list. * $longContext is assumed to use $1 as a standalone parameter; it will always receive a list. * * If both parameters are missing, and there is only one error, no bullet will be added. * * @param StatusValue $status * @param array $options An array of options, supporting the following keys: * - 'shortContext' (string|false|null) A short enclosing context message name, to * be used when there is a single error * - 'longContext' (string|false|null) A long enclosing context message name, for a list * - 'lang' (string|Language|StubUserLang|null) Language to use for processing messages * - 'cleanCallback' (callable|null) A callback for sanitizing parameter values * * @return Message */ public function getMessage( StatusValue $status, array $options = [] ) { $shortContext = $options['shortContext'] ?? null; $longContext = $options['longContext'] ?? null; $lang = $options['lang'] ?? null; $rawErrors = $status->getErrors(); if ( count( $rawErrors ) === 0 ) { if ( $status->isOK() ) { $errMsg = __METHOD__ . " called for a good result, this is incorrect\n"; } else { $errMsg = __METHOD__ . ": Invalid result object: no error text but not OK\n"; } $status->fatal( 'internalerror_info', $errMsg ); $this->logger->warning( $errMsg, [ 'exception' => new RuntimeException() ] ); $rawErrors = $status->getErrors(); // just added a fatal } if ( count( $rawErrors ) === 1 ) { $s = $this->getErrorMessage( $rawErrors[0], $options ); if ( $shortContext ) { $s = $this->msgInLang( $shortContext, $lang, $s ); } elseif ( $longContext ) { $wrapper = new RawMessage( "* \$1\n" ); $wrapper->params( $s )->parse(); $s = $this->msgInLang( $longContext, $lang, $wrapper ); } } else { $msgs = $this->getErrorMessageArray( $rawErrors, $options ); $msgCount = count( $msgs ); $s = new RawMessage( '* $' . implode( "\n* \$", range( 1, $msgCount ) ) ); $s->params( $msgs )->parse(); if ( $longContext ) { $s = $this->msgInLang( $longContext, $lang, $s ); } elseif ( $shortContext ) { $wrapper = new RawMessage( "\n\$1\n", [ $s ] ); $wrapper->parse(); $s = $this->msgInLang( $shortContext, $lang, $wrapper ); } } return $s; } /** * Try to convert the status to a PSR-3 friendly format. The output will be similar to * getWikiText( false, false, 'en' ), but message parameters will be extracted into the * context array with parameter names 'parameter1' etc. when possible. * * @return array A pair of (message, context) suitable for passing to a PSR-3 logger. * @phan-return array{0:string,1:(int|float|string)[]} */ public function getPsr3MessageAndContext( StatusValue $status ): array { $options = [ 'lang' => 'en' ]; $errors = $status->getErrors(); if ( count( $errors ) === 1 ) { // identical to getMessage( false, false, 'en' ) when there's just one error $message = $this->getErrorMessage( $errors[0], [ 'lang' => 'en' ] ); if ( in_array( get_class( $message ), [ Message::class, ApiMessage::class ], true ) ) { // Fall back to getWikiText for rawmessage, which is just a placeholder for non-translated text. // Turning the entire message into a context parameter wouldn't be useful. if ( $message->getKey() === 'rawmessage' ) { return [ $this->getWikiText( $status, $options ), [] ]; } // $1,$2... will be left as-is when no parameters are provided. $text = $this->msgInLang( $message->getKey(), 'en' )->plain(); $params = $message->getParams(); } elseif ( $message instanceof RawMessage ) { $text = $message->getTextOfRawMessage(); $params = $message->getParamsOfRawMessage(); } else { // Unknown Message subclass, we can't be sure how it marks parameters. Fall back to getWikiText. return [ $this->getWikiText( $status, $options ), [] ]; } $context = []; $i = 1; foreach ( $params as $param ) { if ( $param instanceof MessageParam ) { $param = $param->getValue(); } if ( is_int( $param ) || is_float( $param ) || is_string( $param ) ) { $context["parameter$i"] = $param; } else { // Parameter is not of a safe type, fall back to getWikiText. return [ $this->getWikiText( $status, $options ), [] ]; } $text = str_replace( "\$$i", "{parameter$i}", $text ); $i++; } return [ $text, $context ]; } // Parameters cannot be easily extracted, fall back to getWikiText, return [ $this->getWikiText( $status, $options ), [] ]; } /** * Return the message for a single error * * The code string can be used a message key with per-language versions. * If $error is an array, the "params" field is a list of parameters for the message. * * @param array|string $error Code string or (key: code string, params: string[]) map * @param array $options * @return Message */ private function getErrorMessage( $error, array $options = [] ) { $lang = $options['lang'] ?? null; if ( is_array( $error ) ) { if ( isset( $error['message'] ) && $error['message'] instanceof Message ) { // Apply context from MessageLocalizer even if we have a Message object already $msg = $this->msg( $error['message'] ); } elseif ( isset( $error['message'] ) && isset( $error['params'] ) ) { $msg = $this->msg( $error['message'], array_map( static function ( $param ) { return is_string( $param ) ? wfEscapeWikiText( $param ) : $param; }, $this->cleanParams( $error['params'], $options ) ) ); } else { $msgName = array_shift( $error ); $msg = $this->msg( $msgName, array_map( static function ( $param ) { return is_string( $param ) ? wfEscapeWikiText( $param ) : $param; }, $this->cleanParams( $error, $options ) ) ); } } elseif ( is_string( $error ) ) { $msg = $this->msg( $error ); } else { throw new UnexpectedValueException( 'Got ' . get_class( $error ) . ' for key.' ); } if ( $lang ) { $msg->inLanguage( $lang ); } return $msg; } /** * Get the error message as HTML. This is done by parsing the wikitext error message * * All message parameters that were provided as strings will be escaped with wfEscapeWikiText. * This is mostly a historical accident and often undesirable (T368821). * - To avoid this behavior when producing the Status, pass MessageSpecifier objects to methods * such as `$status->fatal()`, instead of separate key and params parameters. * - To avoid this behavior when consuming the Status, use the `$status->getMessages()` method * instead, and display each message separately (or combine then with `Message::listParams()`). * * @param StatusValue $status * @param array $options An array of options, supporting the following keys: * - 'shortContext' (string|false|null) A short enclosing context message name, to * be used when there is a single error * - 'longContext' (string|false|null) A long enclosing context message name, for a list * - 'lang' (string|Language|StubUserLang|null) Language to use for processing messages * - 'cleanCallback' (callable|null) A callback for sanitizing parameter values * * @return string */ public function getHTML( StatusValue $status, array $options = [] ) { $lang = $options['lang'] ?? null; $text = $this->getWikiText( $status, $options ); $out = $this->messageCache->parse( $text, null, true, true, $lang ); return $out instanceof ParserOutput ? $out->getText( [ 'enableSectionEditLinks' => false ] ) : $out; } /** * Return an array with a Message object for each error. * * @param array $errors * @param array $options * * @return Message[] */ private function getErrorMessageArray( $errors, array $options = [] ) { return array_map( function ( $e ) use ( $options ) { return $this->getErrorMessage( $e, $options ); }, $errors ); } /** * @param string|MessageSpecifier $key * @param string|string[] ...$params * @return Message */ private function msg( $key, ...$params ): Message { return $this->messageLocalizer->msg( $key, ...$params ); } /** * @param string|MessageSpecifier $key * @param string|Language|StubUserLang|null $lang * @param mixed ...$params * @return Message */ private function msgInLang( $key, $lang, ...$params ): Message { $msg = $this->msg( $key, ...$params ); if ( $lang ) { $msg->inLanguage( $lang ); } return $msg; } } PK ! #n~�2 2 Status.phpnu �Iw�� <?php /** * Generic operation result. * * 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 */ namespace MediaWiki\Status; use MediaWiki\Context\IContextSource; use MediaWiki\Context\RequestContext; use MediaWiki\Language\Language; use MediaWiki\MediaWikiServices; use MediaWiki\Message\Message; use MediaWiki\StubObject\StubUserLang; use MessageLocalizer; use RuntimeException; use StatusValue; /** * Generic operation result class * Has warning/error list, boolean status and arbitrary value * * "Good" means the operation was completed with no warnings or errors. * * "OK" means the operation was partially or wholly completed. * * An operation which is not OK should have errors so that the user can be * informed as to what went wrong. Calling the fatal() function sets an error * message and simultaneously switches off the OK flag. * * The recommended pattern for Status objects is to return a Status object * unconditionally, i.e. both on success and on failure -- so that the * developer of the calling code is reminded that the function can fail, and * so that a lack of error-handling will be explicit. * * @newable */ class Status extends StatusValue { /** @var callable|false */ public $cleanCallback = false; /** @var MessageLocalizer|null */ protected $messageLocalizer; private ?StatusFormatter $formatter = null; /** * Succinct helper method to wrap a StatusValue * * This is useful when formatting StatusValue objects: * @code * $this->getOutput()->addHtml( Status::wrap( $sv )->getHTML() ); * @endcode * * @param StatusValue|Status $sv * @return Status */ public static function wrap( $sv ) { if ( $sv instanceof static ) { return $sv; } $result = new static(); $result->ok =& $sv->ok; $result->errors =& $sv->errors; $result->value =& $sv->value; $result->successCount =& $sv->successCount; $result->failCount =& $sv->failCount; $result->success =& $sv->success; $result->statusData =& $sv->statusData; return $result; } /** * Backwards compatibility logic * * @param string $name * @return mixed * @throws RuntimeException */ public function __get( $name ) { if ( $name === 'ok' ) { return $this->isOK(); } if ( $name === 'errors' ) { return $this->getErrors(); } throw new RuntimeException( "Cannot get '$name' property." ); } /** * Change operation result * Backwards compatibility logic * * @param string $name * @param mixed $value * @throws RuntimeException */ public function __set( $name, $value ) { if ( $name === 'ok' ) { $this->setOK( $value ); } else { throw new RuntimeException( "Cannot set '$name' property." ); } } /** * Makes this Status object use the given localizer instead of the global one. * If it is an IContextSource or a ResourceLoader Context, it will also be used to * determine the interface language. * @note This setting does not survive serialization. That's usually for the best * (there's no guarantee we'll still have the same localization settings after * unserialization); it is the caller's responsibility to set the localizer again * if needed. * @param MessageLocalizer $messageLocalizer * * @deprecated since 1.42, use FormatterFactory::getStatusFormatter instead. */ public function setMessageLocalizer( MessageLocalizer $messageLocalizer ) { // TODO: hard deprecate after switching callers to StatusFormatter $this->messageLocalizer = $messageLocalizer; $this->formatter = null; } private function getFormatter(): StatusFormatter { if ( !$this->formatter ) { $context = RequestContext::getMain(); // HACK: only works for IContextSource objects. if ( $this->messageLocalizer && $this->messageLocalizer instanceof IContextSource ) { $context = $this->messageLocalizer; } $formatterFactory = MediaWikiServices::getInstance()->getFormatterFactory(); $this->formatter = $formatterFactory->getStatusFormatter( $context ); } return $this->formatter; } /** * Splits this Status object into two new Status objects, one which contains only * the error messages, and one that contains the warnings, only. The returned array is * defined as: * [ * 0 => object(Status) # The Status with error messages, only * 1 => object(Status) # The Status with warning messages, only * ] * * @return Status[] */ public function splitByErrorType() { [ $errorsOnlyStatus, $warningsOnlyStatus ] = parent::splitByErrorType(); // phan/phan#2133? '@phan-var Status $errorsOnlyStatus'; '@phan-var Status $warningsOnlyStatus'; if ( $this->messageLocalizer ) { $errorsOnlyStatus->setMessageLocalizer = $this->messageLocalizer; $warningsOnlyStatus->setMessageLocalizer = $this->messageLocalizer; } if ( $this->formatter ) { $errorsOnlyStatus->formatter = $this->formatter; $warningsOnlyStatus->formatter = $this->formatter; } $errorsOnlyStatus->cleanCallback = $warningsOnlyStatus->cleanCallback = $this->cleanCallback; return [ $errorsOnlyStatus, $warningsOnlyStatus ]; } /** * Returns the wrapped StatusValue object * @return StatusValue * @since 1.27 */ public function getStatusValue() { return $this; } /** * Get the error list as a wikitext formatted list * * All message parameters that were provided as strings will be escaped with wfEscapeWikiText. * This is mostly a historical accident and often undesirable (T368821). * - To avoid this behavior when producing the Status, pass MessageSpecifier objects to methods * such as `$status->fatal()`, instead of separate key and params parameters. * - To avoid this behavior when consuming the Status, use the `$status->getMessages()` method * instead, and display each message separately (or combine then with `Message::listParams()`). * * @deprecated since 1.42, use StatusFormatter instead. * * @param string|false $shortContext A short enclosing context message name, to * be used when there is a single error * @param string|false $longContext A long enclosing context message name, for a list * @param string|Language|StubUserLang|null $lang Language to use for processing messages * @return string */ public function getWikiText( $shortContext = false, $longContext = false, $lang = null ) { return $this->getFormatter()->getWikiText( $this, [ 'shortContext' => $shortContext, 'longContext' => $longContext, 'lang' => $lang, 'cleanCallback' => $this->cleanCallback ] ); } /** * Get a bullet list of the errors as a Message object. * * All message parameters that were provided as strings will be escaped with wfEscapeWikiText. * This is mostly a historical accident and often undesirable (T368821). * - To avoid this behavior when producing the Status, pass MessageSpecifier objects to methods * such as `$status->fatal()`, instead of separate key and params parameters. * - To avoid this behavior when consuming the Status, use the `$status->getMessages()` method * instead, and display each message separately (or combine then with `Message::listParams()`). * * $shortContext and $longContext can be used to wrap the error list in some text. * $shortContext will be preferred when there is a single error; $longContext will be * preferred when there are multiple ones. In either case, $1 will be replaced with * the list of errors. * * $shortContext is assumed to use $1 as an inline parameter: if there is a single item, * it will not be made into a list; if there are multiple items, newlines will be inserted * around the list. * $longContext is assumed to use $1 as a standalone parameter; it will always receive a list. * * If both parameters are missing, and there is only one error, no bullet will be added. * * @deprecated since 1.42, use StatusFormatter instead. * * @param string|string[]|false $shortContext A message name or an array of message names. * @param string|string[]|false $longContext A message name or an array of message names. * @param string|Language|StubUserLang|null $lang Language to use for processing messages * @return Message */ public function getMessage( $shortContext = false, $longContext = false, $lang = null ) { return $this->getFormatter()->getMessage( $this, [ 'shortContext' => $shortContext, 'longContext' => $longContext, 'lang' => $lang, 'cleanCallback' => $this->cleanCallback ] ); } /** * Try to convert the status to a PSR-3 friendly format. The output will be similar to * getWikiText( false, false, 'en' ), but message parameters will be extracted into the * context array with parameter names 'parameter1' etc. when possible. * * @deprecated since 1.42, use StatusFormatter instead. * * @return array A pair of (message, context) suitable for passing to a PSR-3 logger. * @phan-return array{0:string,1:(int|float|string)[]} */ public function getPsr3MessageAndContext(): array { return $this->getFormatter()->getPsr3MessageAndContext( $this ); } /** * Get the error message as HTML. This is done by parsing the wikitext error message * * All message parameters that were provided as strings will be escaped with wfEscapeWikiText. * This is mostly a historical accident and often undesirable (T368821). * - To avoid this behavior when producing the Status, pass MessageSpecifier objects to methods * such as `$status->fatal()`, instead of separate key and params parameters. * - To avoid this behavior when consuming the Status, use the `$status->getMessages()` method * instead, and display each message separately (or combine then with `Message::listParams()`). * * @deprecated since 1.42, use StatusFormatter instead. * * @param string|false $shortContext A short enclosing context message name, to * be used when there is a single error * @param string|false $longContext A long enclosing context message name, for a list * @param string|Language|StubUserLang|null $lang Language to use for processing messages * @return string */ public function getHTML( $shortContext = false, $longContext = false, $lang = null ) { return $this->getFormatter()->getHTML( $this, [ 'shortContext' => $shortContext, 'longContext' => $longContext, 'lang' => $lang, 'cleanCallback' => $this->cleanCallback ] ); } /** * Get the list of errors (but not warnings) * * @deprecated since 1.43 Use `->getMessages( 'error' )` instead * @return array[] A list in which each entry is an array with a message key as its first element. * The remaining array elements are the message parameters. * @phan-return non-empty-array[] */ public function getErrorsArray() { return $this->getStatusArray( 'error' ); } /** * Get the list of warnings (but not errors) * * @deprecated since 1.43 Use `->getMessages( 'warning' )` instead * @return array[] A list in which each entry is an array with a message key as its first element. * The remaining array elements are the message parameters. * @phan-return non-empty-array[] */ public function getWarningsArray() { return $this->getStatusArray( 'warning' ); } /** * Don't save the callback when serializing, because Closures can't be * serialized and we're going to clear it in __wakeup anyway. * Don't save the localizer, because it can be pretty much anything. Restoring it is * the caller's responsibility (otherwise it will just fall back to the global request context). * Same for the formatter, which is likely to contain a localizer. * @return array */ public function __sleep() { $keys = array_keys( get_object_vars( $this ) ); return array_diff( $keys, [ 'cleanCallback', 'messageLocalizer', 'formatter' ] ); } /** * Sanitize the callback parameter on wakeup, to avoid arbitrary execution. */ public function __wakeup() { $this->cleanCallback = false; $this->messageLocalizer = null; $this->formatter = null; } } /** @deprecated class alias since 1.41 */ class_alias( Status::class, 'Status' ); PK ! h� R�7 �7 StatusFormatter.phpnu �Iw�� PK ! #n~�2 2 8 Status.phpnu �Iw�� PK � Cj
| ver. 1.1 | |
.
| PHP 8.4.18 | Ð“ÐµÐ½ÐµÑ€Ð°Ñ†Ð¸Ñ Ñтраницы: 0 |
proxy
|
phpinfo
|
ÐаÑтройка