static public $mLangObjCache = [];
+ /**
+ * Return a fallback chain for messages in getFallbacksFor
+ * @since 1.32
+ */
+ const MESSAGES_FALLBACKS = 0;
+
+ /**
+ * Return a strict fallback chain in getFallbacksFor
+ * @since 1.32
+ */
+ const STRICT_FALLBACKS = 1;
+
static public $mWeekdayMsgs = [
'sunday', 'monday', 'tuesday', 'wednesday', 'thursday',
'friday', 'saturday'
}
$this->namespaceAliases = $aliases + $convertedNames;
+
+ # Filter out aliases to namespaces that don't exist, e.g. from extensions
+ # that aren't loaded here but are included in the l10n cache.
+ # (array_intersect preserves keys from its first argument)
+ $this->namespaceAliases = array_intersect(
+ $this->namespaceAliases,
+ array_keys( $this->getNamespaces() )
+ );
}
return $this->namespaceAliases;
return self::$dataCache->getItem( $this->mCode, 'datePreferenceMigrationMap' );
}
- /**
- * @param string $image
- * @return array|null
- */
- function getImageFile( $image ) {
- return self::$dataCache->getSubitem( $this->mCode, 'imageFiles', $image );
- }
-
- /**
- * @return array
- * @since 1.24
- */
- public function getImageFiles() {
- return self::$dataCache->getItem( $this->mCode, 'imageFiles' );
- }
-
/**
* @return array
*/
);
}
- /**
- * This method is deprecated since 1.31 and kept as alias for truncateForDatabase, which
- * has replaced it. This method provides truncation suitable for DB.
- *
- * The database offers limited byte lengths for some columns in the database;
- * multi-byte character sets mean we need to ensure that only whole characters
- * are included, otherwise broken characters can be passed to the user.
- *
- * @deprecated since 1.31, use truncateForDatabase or truncateForVisual as appropriate.
- *
- * @param string $string String to truncate
- * @param int $length Maximum length (including ellipsis)
- * @param string $ellipsis String to append to the truncated text
- * @param bool $adjustLength Subtract length of ellipsis from $length.
- * $adjustLength was introduced in 1.18, before that behaved as if false.
- * @return string
- */
- function truncate( $string, $length, $ellipsis = '...', $adjustLength = true ) {
- wfDeprecated( __METHOD__, '1.31' );
- return $this->truncateForDatabase( $string, $length, $ellipsis, $adjustLength );
- }
-
/**
* Truncate a string to a specified length in bytes, appending an optional
* string (e.g. for ellipsis)
}
/**
- * Check if the language has the specific variant
+ * Strict check if the language has the specific variant.
+ *
+ * Compare to LanguageConverter::validateVariant() which does a more
+ * lenient check and attempts to coerce the given code to a valid one.
*
* @since 1.19
* @param string $variant
* @return bool
*/
public function hasVariant( $variant ) {
- return (bool)$this->mConverter->validateVariant( $variant );
+ return $variant && ( $variant === $this->mConverter->validateVariant( $variant ) );
}
/**
/**
* @param string $code
+ * @deprecated since 1.32, use Language::factory to create a new object instead.
*/
public function setCode( $code ) {
$this->mCode = $code;
*
* @since 1.19
* @param string $code Language code
- * @return array Non-empty array, ending in "en"
+ * @param int $mode Fallback mode, either MESSAGES_FALLBACKS (which always falls back to 'en'),
+ * or STRICT_FALLBACKS (whic honly falls back to 'en' when explicitly defined)
+ * @throws MWException
+ * @return array List of language codes
*/
- public static function getFallbacksFor( $code ) {
+ public static function getFallbacksFor( $code, $mode = self::MESSAGES_FALLBACKS ) {
if ( $code === 'en' || !self::isValidBuiltInCode( $code ) ) {
return [];
}
- // For unknown languages, fallbackSequence returns an empty array,
- // hardcode fallback to 'en' in that case.
- return self::getLocalisationCache()->getItem( $code, 'fallbackSequence' ) ?: [ 'en' ];
+ switch ( $mode ) {
+ case self::MESSAGES_FALLBACKS:
+ // For unknown languages, fallbackSequence returns an empty array,
+ // hardcode fallback to 'en' in that case as English messages are
+ // always defined.
+ return self::getLocalisationCache()->getItem( $code, 'fallbackSequence' ) ?: [ 'en' ];
+ case self::STRICT_FALLBACKS:
+ // Use this mode when you don't want to fallback to English unless
+ // explicitly defined, for example when you have language-variant icons
+ // and an international language-independent fallback.
+ return self::getLocalisationCache()->getItem( $code, 'originalFallbackSequence' );
+ default:
+ throw new MWException( "Invalid fallback mode \"$mode\"" );
+ }
}
/**