2016-12-08 18:38:45 +00:00
|
|
|
<?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
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Basic localized exception.
|
|
|
|
|
*
|
2020-06-29 12:13:29 +00:00
|
|
|
* @newable
|
2020-07-13 09:00:30 +00:00
|
|
|
* @stable to extend
|
2016-12-08 18:38:45 +00:00
|
|
|
* @since 1.29
|
|
|
|
|
* @ingroup Exception
|
|
|
|
|
* @note Don't use this in a situation where MessageCache is not functional.
|
|
|
|
|
*/
|
2021-09-14 19:01:21 +00:00
|
|
|
class LocalizedException extends Exception implements ILocalizedException {
|
2016-12-08 18:38:45 +00:00
|
|
|
/** @var string|array|MessageSpecifier */
|
|
|
|
|
protected $messageSpec;
|
|
|
|
|
|
|
|
|
|
/**
|
2020-07-13 08:53:06 +00:00
|
|
|
* @stable to call
|
2016-12-08 18:38:45 +00:00
|
|
|
* @param string|array|MessageSpecifier $messageSpec See Message::newFromSpecifier
|
2017-12-28 15:06:10 +00:00
|
|
|
* @param int $code
|
2019-12-29 19:44:43 +00:00
|
|
|
* @param Throwable|null $previous The previous exception used for the exception
|
2018-06-26 21:14:43 +00:00
|
|
|
* chaining.
|
2016-12-08 18:38:45 +00:00
|
|
|
*/
|
2019-12-29 19:44:43 +00:00
|
|
|
public function __construct( $messageSpec, $code = 0, Throwable $previous = null ) {
|
2016-12-08 18:38:45 +00:00
|
|
|
$this->messageSpec = $messageSpec;
|
|
|
|
|
|
|
|
|
|
// Exception->getMessage() should be in plain English, not localized.
|
|
|
|
|
// So fetch the English version of the message, without local
|
|
|
|
|
// customizations, and make a basic attempt to turn markup into text.
|
|
|
|
|
$msg = $this->getMessageObject()->inLanguage( 'en' )->useDatabase( false )->text();
|
|
|
|
|
$msg = preg_replace( '!</?(var|kbd|samp|code)>!', '"', $msg );
|
2017-07-07 23:35:07 +00:00
|
|
|
$msg = Sanitizer::stripAllTags( $msg );
|
2016-12-08 18:38:45 +00:00
|
|
|
parent::__construct( $msg, $code, $previous );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public function getMessageObject() {
|
|
|
|
|
return Message::newFromSpecifier( $this->messageSpec );
|
|
|
|
|
}
|
|
|
|
|
}
|