Source for file Negotiator.php

<?php
/* vim: set expandtab tabstop=4 shiftwidth=4: */
// +----------------------------------------------------------------------+
// | PHP version 4.0                                                      |
// +----------------------------------------------------------------------+
// | Copyright (c) 1997, 1998, 1999, 2000, 2001, 2002, 2003 The PHP Group       |
// +----------------------------------------------------------------------+
// | This source file is subject to version 2.0 of the PHP license,       |
// | that is bundled with this package in the file LICENSE, and is        |
// | available at through the world-wide-web at                           |
// | http://www.php.net/license/2_02.txt.                                 |
// | If you did not receive a copy of the PHP license and are unable to   |
// | obtain it through the world-wide-web, please send a note to          |
// | license@php.net so we can mail you a copy immediately.               |
// +----------------------------------------------------------------------+
// | Authors: Naoki Shima <murahachibu@php.net>                           |
// |                                                                      |
// +----------------------------------------------------------------------+//
// $Id: Negotiator.php 110339 2003-01-04 11:55:29Z mj $
 
/**
*
* //instantiate Locale_Negotiator
* $negotiator       = & new I18N_Negotiator();
* 
* //define which language[s] your site supports :: optional
* $supportLangs     = array('fr','jp');
*
* //find first matched language
* $lang             =  $negotiator->getLanguageMatch($supportedLangs);
*
* //define which countries your site supports :: optional
* $supportCountries = array('gb','us');
*
* //find first matched Country
* $countryCode      = $negotiator->getCountryMatch($lang,$supportCountries);
*
* echo 'Language Code: '.$lang.'
* Language Name: '.$negotiator->getLanguageName($lang).'
* Country Code: '.$countryCode.'
* Country Name: '.$negotiator->getCountryName($countryCode);
*/
 
class I18N_Negotiator{
 
    // {{{ properties
 
    /**
     * Save default country code.
     *
     * @type  : string
     * @access: private
     */
    var $_defaultCountry;
 
    /**
     * Save default language code.
     *
     * @type  : string
     * @access: private
     */
    var $_defaultLanguage;
 
    /**
     * Save default charset code.
     *
     * @type  : string
     * @access: private
     */
    var $_defaultCharset;
 
    // }}}
    // {{{ constructor
 
    /**
     * Find language code, country code, charset code, and dialect or variant
     * of Locale setting in user's browser from $HTTP_ACCEPT_LANGUAGE,
     * $LANGUAGE_ACCEPT_CHARSET
     *
     * @param : string   Default Language
     * @param : string   Default Charset
     * @param : string   Default Country
     */
    function I18N_Negotiator($defaultLanguage = "en", $defaultCharset = "ISO-8859-1", $defaultCountry = "")
    {
        if($_SERVER) {
            $HTTP_ACCEPT_LANGUAGE = ( in_array("HTTP_ACCEPT_LANGUAGE",
                array_keys($_SERVER)) ) ? $_SERVER['HTTP_ACCEPT_LANGUAGE'] : "";
            $HTTP_ACCEPT_CHARSET = ( in_array("HTTP_ACCEPT_CHARSET",
                array_keys($_SERVER)) ) ? $_SERVER['HTTP_ACCEPT_CHARSET'] : "";
        } else {
            global $HTTP_ACCEPT_LANGUAGE,$HTTP_ACCEPT_CHARSET;
        }
        $this->_defaultCountry = $defaultCountry;
        $this->_defaultLanguage = $defaultLanguage;
        $this->_defaultCharset = $defaultCharset;
        $langs = explode(',',$HTTP_ACCEPT_LANGUAGE);
        foreach($langs AS $lang_tag) {
            // Cut off any q-value that might come after a semi-colon
            if($pos = strpos($lang_tag, ';')) {
                $lang_tag = trim(substr($lang_tag,0,$pos));
            }
            $lang = $lang_tag;
            if($pos = strpos($lang_tag, '-')) {
                $primary_tag = substr($lang_tag,0,$pos);
                $sub_tag = substr($lang_tag,($pos+1));
                if($primary_tag == 'i') {
                    /**
                     * Language not listed in ISO 639 that are not variants
                     * of any listed language, which can be registerd with the
                     * i-prefix, such as i-cherokee
                     */
                    $lang = $sub_tag;
                } else {
                    $lang = $primary_tag;
                    $this->_prepareI18NCountry();
                    if($this->_lc->isValidCode($sub_tag)) {
                        $this->_country[$lang][] = $sub_tag;
                    } else { 
                        /**
                         * Dialect or variant information such as no-nynorsk or
                         * en-cockney.
                         * Script variations, such as az-arabic and az-cyrillic
                         */ 
                        $this->_lang_variation[$lang][] = $sub_tag;
                    }
                }
            }
            $this->_acceptLanguage[] = $lang;
        }
        $this->_acceptCharset = explode(',',$HTTP_ACCEPT_CHARSET);
    }
 
    // }}}
    // {{{ _constructor();
 
    /**
     * Dummy constructor
     * call actual constructor
     */
    function _constructor()
    {
        $this->I18N_Negotiator();
    }
 
    // }}}
    // {{{ destructor
 
    /**
     * It does nothing right now
     */
    function _I18N_Negotiater()
    {
    }
 
    // }}}
    // {{{ getCountryMatch()
 
    /**
     * Find Country Match
     *
     * @param : string
     * @param : array
     *
     * @return: array
     * @access: public
     */
    function getCountryMatch($lang='',$countries = '')
    {
        if(!$lang) {
            return FALSE;
        }
        return $this->_getMatch($countries,$this->_country[$lang],
                   $this->_defaultCountry);
    }
 
    // }}}
    // {{{ getVariantInfo()
 
    /**
     * Return variant info for passed parameter.
     *
     * @param : string
     *
     * @return: string
     * @access: public
     */
    function getVariantInfo($lang)
    {
        return $this->_lang_variation[$lang];
    }
 
    // }}}
    // {{{ getCharsetMatch()
 
    /**
     * Find Charset match
     *
     * @param : array
     * 
     * @return: string
     * @access: public
     */
    function getCharsetMatch($chasets = '')
    {
        return $this->_getMatch($charsets,$this->_acceptCharset,
                   $this->_defaultCharset);
    }
 
    // }}}
    // {{{ getLanguageMatch()
 
    /**
     * Find Language match
     *
     * @param : array
     * 
     * @return: string
     * @access: public
     */
    function getLanguageMatch($langs = '')
    {
        return $this->_getMatch($langs,$this->_acceptLanguage,
                   $this->_defaultLanguage);
    }
    
    // }}}
    // {{{ _getMatch()
 
    /**
     * Return first matched value from first and second parameter.
     * If there is no match found, then return third parameter.
     * 
     * @param : array
     * @param : array
     * @param : string
     * 
     * @return: string
     * @access: private
     */
    function _getMatch($needle,$heystack,$default = '')
    {
        if(!$heystack) {
            return $default;
        }
        if(!$needle) {
            return array_shift($heystack);
        }
        if($result = array_shift(array_intersect($heystack,$needle))) {
            return $result;
        }
        return $default;
    }
    
    /**
     * Find Country name for country code passed
     * 
     * @param : string   country code
     *
     * @return: void
     * @access: private
     */
    function getCountryName($code)
    {
        $this->_prepareI18NCountry();
        return $this->_lc->getName($code);
    }
 
    /**
     * Find Country name for country code passed
     * 
     * @param : string   country code
     *
     * @return: void
     * @access: private
     */
    function getLanguageName($code)
    {
        $this->_prepareI18NLanguage();
        return $this->_ll->getName($code);
    }
 
    /**
     * Check if I18N_Language class has been instantiated and set to $this->_ll
     * If it's not, it will load the script and instantiate I18N_Language class
     * 
     * @return: void
     * @access: private
     */
    function _prepareI18NLanguage()
    {
        if(!isset($this->_ll)) {
            include_once('I18N/Language.php');
            $this->_ll =& new I18N_Language();
        }
    }
 
    /**
     * Check if I18N_Country class has been instantiated and set to $this->_lc
     * If it's not, it will load the script and instantiate I18N_Country class
     * 
     * @return: void
     * @access: private
     */
    function _prepareI18NCountry()
    {
        if(!isset($this->_lc)) {
            include_once('I18N/Country.php');
            $this->_lc =& new I18N_Country();
        }
    }
}
?>