Collation.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;
 
abstract class Collation {
    private static $instance;
 
    public static function singleton() {
        if ( !self::$instance ) {
            global $wgCategoryCollation;
            self::$instance = self::factory( $wgCategoryCollation );
        }
        return self::$instance;
    }
 
    public static function factory( $collationName ) {
        switch ( $collationName ) {
            case 'uppercase':
                return new UppercaseCollation;
            case 'numeric':
                return new NumericUppercaseCollation(
                    MediaWikiServices::getInstance()->getContentLanguage() );
            case 'identity':
                return new IdentityCollation;
            case 'uca-default':
                return new IcuCollation( 'root' );
            case 'uca-default-u-kn':
                return new IcuCollation( 'root-u-kn' );
            case 'xx-uca-ckb':
                return new CollationCkb;
            case 'uppercase-ab':
                return new AbkhazUppercaseCollation;
            case 'uppercase-ba':
                return new BashkirUppercaseCollation;
            default:
                $match = [];
                if ( preg_match( '/^uca-([A-Za-z@=-]+)$/', $collationName, $match ) ) {
                    return new IcuCollation( $match[1] );
                }
 
                # Provide a mechanism for extensions to hook in.
                $collationObject = null;
                Hooks::run( 'Collation::factory', [ $collationName, &$collationObject ] );
 
                if ( $collationObject instanceof self ) {
                    return $collationObject;
                }
 
                // If all else fails...
                throw new MWException( __METHOD__ . ": unknown collation type \"$collationName\"" );
        }
    }
 
    abstract function getSortKey( $string );
 
    abstract function getFirstLetter( $string );
 
}