MessageUtils.php

Go to the documentation of this file.

<?php
 
class MessageUtils {
 
    public static function languageSpecificFallback(
        $language = 'en', $msg_keys = [], $params = []
    ) {
        if ( count( $msg_keys ) < 1 ) {
            throw new InvalidArgumentException( __FUNCTION__ . " BAD PROGRAMMER. No message keys given." );
        }
 
        # look for the first message that exists
        foreach ( $msg_keys as $m ) {
            if ( WmfFramework::messageExists( $m, $language ) ) {
                return WmfFramework::formatMessage( $m, $params );
            }
        }
 
        # we found nothing in the requested language, return the first fallback message that exists
        foreach ( $msg_keys as $m ) {
            if ( WmfFramework::messageExists( $m, $language ) ) {
                return WmfFramework::formatMessage( $m, $params );
            }
        }
 
        # somehow we still don't have a message, return a default error message
        return WmfFramework::formatMessage( $msg_keys[0], $params );
    }
 
    public static function getCountrySpecificMessage( $key, $country, $language, $params = [] ) {
        return self::languageSpecificFallback(
            $language, [ $key . '-' . strtolower( $country ), $key ], $params
        );
    }
 
    public static function makeSafe( $string ) {
        $stripped = preg_replace( '/[^-_\w]/', '', $string );
 
        // theoretically this is overkill, but better safe than sorry
        return WmfFramework::sanitize( htmlspecialchars( $stripped ) );
    }
}