Complex classes like Zend_Locale often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use Zend_Locale, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 30 | class Zend_Locale |
||
| 31 | { |
||
| 32 | /** |
||
| 33 | * Class wide Locale Constants |
||
| 34 | * |
||
| 35 | * @var array $_localeData |
||
| 36 | */ |
||
| 37 | private static $_localeData = array( |
||
| 38 | 'root' => true, 'aa_DJ' => true, 'aa_ER' => true, 'aa_ET' => true, 'aa' => true, |
||
| 39 | 'af_NA' => true, 'af_ZA' => true, 'af' => true, 'ak_GH' => true, 'ak' => true, |
||
| 40 | 'am_ET' => true, 'am' => true, 'ar_AE' => true, 'ar_BH' => true, 'ar_DZ' => true, |
||
| 41 | 'ar_EG' => true, 'ar_IQ' => true, 'ar_JO' => true, 'ar_KW' => true, 'ar_LB' => true, |
||
| 42 | 'ar_LY' => true, 'ar_MA' => true, 'ar_OM' => true, 'ar_QA' => true, 'ar_SA' => true, |
||
| 43 | 'ar_SD' => true, 'ar_SY' => true, 'ar_TN' => true, 'ar_YE' => true, 'ar' => true, |
||
| 44 | 'as_IN' => true, 'as' => true, 'az_AZ' => true, 'az' => true, 'be_BY' => true, |
||
| 45 | 'be' => true, 'bg_BG' => true, 'bg' => true, 'bn_BD' => true, 'bn_IN' => true, |
||
| 46 | 'bn' => true, 'bo_CN' => true, 'bo_IN' => true, 'bo' => true, 'bs_BA' => true, |
||
| 47 | 'bs' => true, 'byn_ER'=> true, 'byn' => true, 'ca_ES' => true, 'ca' => true, |
||
| 48 | 'cch_NG'=> true, 'cch' => true, 'cop' => true, 'cs_CZ' => true, 'cs' => true, |
||
| 49 | 'cy_GB' => true, 'cy' => true, 'da_DK' => true, 'da' => true, 'de_AT' => true, |
||
| 50 | 'de_BE' => true, 'de_CH' => true, 'de_DE' => true, 'de_LI' => true, 'de_LU' => true, |
||
| 51 | 'de' => true, 'dv_MV' => true, 'dv' => true, 'dz_BT' => true, 'dz' => true, |
||
| 52 | 'ee_GH' => true, 'ee_TG' => true, 'ee' => true, 'el_CY' => true, 'el_GR' => true, |
||
| 53 | 'el' => true, 'en_AS' => true, 'en_AU' => true, 'en_BE' => true, 'en_BW' => true, |
||
| 54 | 'en_BZ' => true, 'en_CA' => true, 'en_GB' => true, 'en_GU' => true, 'en_HK' => true, |
||
| 55 | 'en_IE' => true, 'en_IN' => true, 'en_JM' => true, 'en_MH' => true, 'en_MP' => true, |
||
| 56 | 'en_MT' => true, 'en_NA' => true, 'en_NZ' => true, 'en_PH' => true, 'en_PK' => true, |
||
| 57 | 'en_SG' => true, 'en_TT' => true, 'en_UM' => true, 'en_US' => true, 'en_VI' => true, |
||
| 58 | 'en_ZA' => true, 'en_ZW' => true, 'en' => true, 'eo' => true, 'es_AR' => true, |
||
| 59 | 'es_BO' => true, 'es_CL' => true, 'es_CO' => true, 'es_CR' => true, 'es_DO' => true, |
||
| 60 | 'es_EC' => true, 'es_ES' => true, 'es_GT' => true, 'es_HN' => true, 'es_MX' => true, |
||
| 61 | 'es_NI' => true, 'es_PA' => true, 'es_PE' => true, 'es_PR' => true, 'es_PY' => true, |
||
| 62 | 'es_SV' => true, 'es_US' => true, 'es_UY' => true, 'es_VE' => true, 'es' => true, |
||
| 63 | 'et_EE' => true, 'et' => true, 'eu_ES' => true, 'eu' => true, 'fa_AF' => true, |
||
| 64 | 'fa_IR' => true, 'fa' => true, 'fi_FI' => true, 'fi' => true, 'fil_PH'=> true, |
||
| 65 | 'fil' => true, 'fo_FO' => true, 'fo' => true, 'fr_BE' => true, 'fr_CA' => true, |
||
| 66 | 'fr_CH' => true, 'fr_FR' => true, 'fr_LU' => true, 'fr_MC' => true, 'fr_SN' => true, |
||
| 67 | 'fr' => true, 'fur_IT'=> true, 'fur' => true, 'ga_IE' => true, 'ga' => true, |
||
| 68 | 'gaa_GH'=> true, 'gaa' => true, 'gez_ER'=> true, 'gez_ET'=> true, 'gez' => true, |
||
| 69 | 'gl_ES' => true, 'gl' => true, 'gsw_CH'=> true, 'gsw' => true, 'gu_IN' => true, |
||
| 70 | 'gu' => true, 'gv_GB' => true, 'gv' => true, 'ha_GH' => true, 'ha_NE' => true, |
||
| 71 | 'ha_NG' => true, 'ha_SD' => true, 'ha' => true, 'haw_US'=> true, 'haw' => true, |
||
| 72 | 'he_IL' => true, 'he' => true, 'hi_IN' => true, 'hi' => true, 'hr_HR' => true, |
||
| 73 | 'hr' => true, 'hu_HU' => true, 'hu' => true, 'hy_AM' => true, 'hy' => true, |
||
| 74 | 'ia' => true, 'id_ID' => true, 'id' => true, 'ig_NG' => true, 'ig' => true, |
||
| 75 | 'ii_CN' => true, 'ii' => true, 'in' => true, 'is_IS' => true, 'is' => true, |
||
| 76 | 'it_CH' => true, 'it_IT' => true, 'it' => true, 'iu' => true, 'iw' => true, |
||
| 77 | 'ja_JP' => true, 'ja' => true, 'ka_GE' => true, 'ka' => true, 'kaj_NG'=> true, |
||
| 78 | 'kaj' => true, 'kam_KE'=> true, 'kam' => true, 'kcg_NG'=> true, 'kcg' => true, |
||
| 79 | 'kfo_CI'=> true, 'kfo' => true, 'kk_KZ' => true, 'kk' => true, 'kl_GL' => true, |
||
| 80 | 'kl' => true, 'km_KH' => true, 'km' => true, 'kn_IN' => true, 'kn' => true, |
||
| 81 | 'ko_KR' => true, 'ko' => true, 'kok_IN'=> true, 'kok' => true, 'kpe_GN'=> true, |
||
| 82 | 'kpe_LR'=> true, 'kpe' => true, 'ku_IQ' => true, 'ku_IR' => true, 'ku_SY' => true, |
||
| 83 | 'ku_TR' => true, 'ku' => true, 'kw_GB' => true, 'kw' => true, 'ky_KG' => true, |
||
| 84 | 'ky' => true, 'ln_CD' => true, 'ln_CG' => true, 'ln' => true, 'lo_LA' => true, |
||
| 85 | 'lo' => true, 'lt_LT' => true, 'lt' => true, 'lv_LV' => true, 'lv' => true, |
||
| 86 | 'mk_MK' => true, 'mk' => true, 'ml_IN' => true, 'ml' => true, 'mn_CN' => true, |
||
| 87 | 'mn_MN' => true, 'mn' => true, 'mo' => true, 'mr_IN' => true, 'mr' => true, |
||
| 88 | 'ms_BN' => true, 'ms_MY' => true, 'ms' => true, 'mt_MT' => true, 'mt' => true, |
||
| 89 | 'my_MM' => true, 'my' => true, 'nb_NO' => true, 'nb' => true, 'nds_DE'=> true, |
||
| 90 | 'nds' => true, 'ne_IN' => true, 'ne_NP' => true, 'ne' => true, 'nl_BE' => true, |
||
| 91 | 'nl_NL' => true, 'nl' => true, 'nn_NO' => true, 'nn' => true, 'no' => true, |
||
| 92 | 'nr_ZA' => true, 'nr' => true, 'nso_ZA'=> true, 'nso' => true, 'ny_MW' => true, |
||
| 93 | 'ny' => true, 'oc_FR' => true, 'oc' => true, 'om_ET' => true, 'om_KE' => true, |
||
| 94 | 'om' => true, 'or_IN' => true, 'or' => true, 'pa_IN' => true, 'pa_PK' => true, |
||
| 95 | 'pa' => true, 'pl_PL' => true, 'pl' => true, 'ps_AF' => true, 'ps' => true, |
||
| 96 | 'pt_BR' => true, 'pt_PT' => true, 'pt' => true, 'ro_MD' => true, 'ro_RO' => true, |
||
| 97 | 'ro' => true, 'ru_RU' => true, 'ru_UA' => true, 'ru' => true, 'rw_RW' => true, |
||
| 98 | 'rw' => true, 'sa_IN' => true, 'sa' => true, 'se_FI' => true, 'se_NO' => true, |
||
| 99 | 'se' => true, 'sh_BA' => true, 'sh_CS' => true, 'sh_YU' => true, 'sh' => true, |
||
| 100 | 'si_LK' => true, 'si' => true, 'sid_ET'=> true, 'sid' => true, 'sk_SK' => true, |
||
| 101 | 'sk' => true, 'sl_SI' => true, 'sl' => true, 'so_DJ' => true, 'so_ET' => true, |
||
| 102 | 'so_KE' => true, 'so_SO' => true, 'so' => true, 'sq_AL' => true, 'sq' => true, |
||
| 103 | 'sr_BA' => true, 'sr_CS' => true, 'sr_ME' => true, 'sr_RS' => true, 'sr_YU' => true, |
||
| 104 | 'sr' => true, 'ss_SZ' => true, 'ss_ZA' => true, 'ss' => true, 'st_LS' => true, |
||
| 105 | 'st_ZA' => true, 'st' => true, 'sv_FI' => true, 'sv_SE' => true, 'sv' => true, |
||
| 106 | 'sw_KE' => true, 'sw_TZ' => true, 'sw' => true, 'syr_SY'=> true, 'syr' => true, |
||
| 107 | 'ta_IN' => true, 'ta' => true, 'te_IN' => true, 'te' => true, 'tg_TJ' => true, |
||
| 108 | 'tg' => true, 'th_TH' => true, 'th' => true, 'ti_ER' => true, 'ti_ET' => true, |
||
| 109 | 'ti' => true, 'tig_ER'=> true, 'tig' => true, 'tl' => true, 'tn_ZA' => true, |
||
| 110 | 'tn' => true, 'to_TO' => true, 'to' => true, 'tr_TR' => true, 'tr' => true, |
||
| 111 | 'trv_TW'=> true, 'trv' => true, 'ts_ZA' => true, 'ts' => true, 'tt_RU' => true, |
||
| 112 | 'tt' => true, 'ug_CN' => true, 'ug' => true, 'uk_UA' => true, 'uk' => true, |
||
| 113 | 'ur_IN' => true, 'ur_PK' => true, 'ur' => true, 'uz_AF' => true, 'uz_UZ' => true, |
||
| 114 | 'uz' => true, 've_ZA' => true, 've' => true, 'vi_VN' => true, 'vi' => true, |
||
| 115 | 'wal_ET'=> true, 'wal' => true, 'wo_SN' => true, 'wo' => true, 'xh_ZA' => true, |
||
| 116 | 'xh' => true, 'yo_NG' => true, 'yo' => true, 'zh_CN' => true, 'zh_HK' => true, |
||
| 117 | 'zh_MO' => true, 'zh_SG' => true, 'zh_TW' => true, 'zh' => true, 'zu_ZA' => true, |
||
| 118 | 'zu' => true, |
||
| 119 | // CUSTOM SilverStripe Add Maori locales. |
||
| 120 | // Remove once updating Zend_Locale to 2.0 (which uses CLDR 1.9), see |
||
| 121 | // https://github.com/zendframework/zf2/tree/master/resources/cldr/main |
||
| 122 | 'mi' => true, 'mi_NZ' => true, |
||
| 123 | 'lc' => true, 'lc_XX' => true, |
||
| 124 | ); |
||
| 125 | |||
| 126 | /** |
||
| 127 | * Class wide Locale Constants |
||
| 128 | * |
||
| 129 | * @var array $_territoryData |
||
| 130 | */ |
||
| 131 | private static $_territoryData = array( |
||
| 132 | 'AD' => 'ca_AD', 'AE' => 'ar_AE', 'AF' => 'fa_AF', 'AG' => 'en_AG', 'AI' => 'en_AI', |
||
| 133 | 'AL' => 'sq_AL', 'AM' => 'hy_AM', 'AN' => 'pap_AN', 'AO' => 'pt_AO', 'AQ' => 'und_AQ', |
||
| 134 | 'AR' => 'es_AR', 'AS' => 'sm_AS', 'AT' => 'de_AT', 'AU' => 'en_AU', 'AW' => 'nl_AW', |
||
| 135 | 'AX' => 'sv_AX', 'AZ' => 'az_Latn_AZ', 'BA' => 'bs_BA', 'BB' => 'en_BB', 'BD' => 'bn_BD', |
||
| 136 | 'BE' => 'nl_BE', 'BF' => 'mos_BF', 'BG' => 'bg_BG', 'BH' => 'ar_BH', 'BI' => 'rn_BI', |
||
| 137 | 'BJ' => 'fr_BJ', 'BL' => 'fr_BL', 'BM' => 'en_BM', 'BN' => 'ms_BN', 'BO' => 'es_BO', |
||
| 138 | 'BR' => 'pt_BR', 'BS' => 'en_BS', 'BT' => 'dz_BT', 'BV' => 'und_BV', 'BW' => 'en_BW', |
||
| 139 | 'BY' => 'be_BY', 'BZ' => 'en_BZ', 'CA' => 'en_CA', 'CC' => 'ms_CC', 'CD' => 'sw_CD', |
||
| 140 | 'CF' => 'fr_CF', 'CG' => 'fr_CG', 'CH' => 'de_CH', 'CI' => 'fr_CI', 'CK' => 'en_CK', |
||
| 141 | 'CL' => 'es_CL', 'CM' => 'fr_CM', 'CN' => 'zh_Hans_CN', 'CO' => 'es_CO', 'CR' => 'es_CR', |
||
| 142 | 'CU' => 'es_CU', 'CV' => 'kea_CV', 'CX' => 'en_CX', 'CY' => 'el_CY', 'CZ' => 'cs_CZ', |
||
| 143 | 'DE' => 'de_DE', 'DJ' => 'aa_DJ', 'DK' => 'da_DK', 'DM' => 'en_DM', 'DO' => 'es_DO', |
||
| 144 | 'DZ' => 'ar_DZ', 'EC' => 'es_EC', 'EE' => 'et_EE', 'EG' => 'ar_EG', 'EH' => 'ar_EH', |
||
| 145 | 'ER' => 'ti_ER', 'ES' => 'es_ES', 'ET' => 'en_ET', 'FI' => 'fi_FI', 'FJ' => 'hi_FJ', |
||
| 146 | 'FK' => 'en_FK', 'FM' => 'chk_FM', 'FO' => 'fo_FO', 'FR' => 'fr_FR', 'GA' => 'fr_GA', |
||
| 147 | 'GB' => 'en_GB', 'GD' => 'en_GD', 'GE' => 'ka_GE', 'GF' => 'fr_GF', 'GG' => 'en_GG', |
||
| 148 | 'GH' => 'ak_GH', 'GI' => 'en_GI', 'GL' => 'iu_GL', 'GM' => 'en_GM', 'GN' => 'fr_GN', |
||
| 149 | 'GP' => 'fr_GP', 'GQ' => 'fan_GQ', 'GR' => 'el_GR', 'GS' => 'und_GS', 'GT' => 'es_GT', |
||
| 150 | 'GU' => 'en_GU', 'GW' => 'pt_GW', 'GY' => 'en_GY', 'HK' => 'zh_Hant_HK', 'HM' => 'und_HM', |
||
| 151 | 'HN' => 'es_HN', 'HR' => 'hr_HR', 'HT' => 'ht_HT', 'HU' => 'hu_HU', 'ID' => 'id_ID', |
||
| 152 | 'IE' => 'en_IE', 'IL' => 'he_IL', 'IM' => 'en_IM', 'IN' => 'hi_IN', 'IO' => 'und_IO', |
||
| 153 | 'IQ' => 'ar_IQ', 'IR' => 'fa_IR', 'IS' => 'is_IS', 'IT' => 'it_IT', 'JE' => 'en_JE', |
||
| 154 | 'JM' => 'en_JM', 'JO' => 'ar_JO', 'JP' => 'ja_JP', 'KE' => 'en_KE', 'KG' => 'ky_Cyrl_KG', |
||
| 155 | 'KH' => 'km_KH', 'KI' => 'en_KI', 'KM' => 'ar_KM', 'KN' => 'en_KN', 'KP' => 'ko_KP', |
||
| 156 | 'KR' => 'ko_KR', 'KW' => 'ar_KW', 'KY' => 'en_KY', 'KZ' => 'ru_KZ', 'LA' => 'lo_LA', |
||
| 157 | 'LB' => 'ar_LB', 'LC' => 'en_LC', 'LI' => 'de_LI', 'LK' => 'si_LK', 'LR' => 'en_LR', |
||
| 158 | 'LS' => 'st_LS', 'LT' => 'lt_LT', 'LU' => 'fr_LU', 'LV' => 'lv_LV', 'LY' => 'ar_LY', |
||
| 159 | 'MA' => 'ar_MA', 'MC' => 'fr_MC', 'MD' => 'ro_MD', 'ME' => 'sr_Latn_ME', 'MF' => 'fr_MF', |
||
| 160 | 'MG' => 'mg_MG', 'MH' => 'mh_MH', 'MK' => 'mk_MK', 'ML' => 'bm_ML', 'MM' => 'my_MM', |
||
| 161 | 'MN' => 'mn_Cyrl_MN', 'MO' => 'zh_Hant_MO', 'MP' => 'en_MP', 'MQ' => 'fr_MQ', 'MR' => 'ar_MR', |
||
| 162 | 'MS' => 'en_MS', 'MT' => 'mt_MT', 'MU' => 'mfe_MU', 'MV' => 'dv_MV', 'MW' => 'ny_MW', |
||
| 163 | 'MX' => 'es_MX', 'MY' => 'ms_MY', 'MZ' => 'pt_MZ', 'NA' => 'kj_NA', 'NC' => 'fr_NC', |
||
| 164 | 'NE' => 'ha_Latn_NE', 'NF' => 'en_NF', 'NG' => 'en_NG', 'NI' => 'es_NI', 'NL' => 'nl_NL', |
||
| 165 | 'NO' => 'nb_NO', 'NP' => 'ne_NP', 'NR' => 'en_NR', 'NU' => 'niu_NU', 'NZ' => 'en_NZ', |
||
| 166 | 'OM' => 'ar_OM', 'PA' => 'es_PA', 'PE' => 'es_PE', 'PF' => 'fr_PF', 'PG' => 'tpi_PG', |
||
| 167 | 'PH' => 'fil_PH', 'PK' => 'ur_PK', 'PL' => 'pl_PL', 'PM' => 'fr_PM', 'PN' => 'en_PN', |
||
| 168 | 'PR' => 'es_PR', 'PS' => 'ar_PS', 'PT' => 'pt_PT', 'PW' => 'pau_PW', 'PY' => 'gn_PY', |
||
| 169 | 'QA' => 'ar_QA', 'RE' => 'fr_RE', 'RO' => 'ro_RO', 'RS' => 'sr_Cyrl_RS', 'RU' => 'ru_RU', |
||
| 170 | 'RW' => 'rw_RW', 'SA' => 'ar_SA', 'SB' => 'en_SB', 'SC' => 'crs_SC', 'SD' => 'ar_SD', |
||
| 171 | 'SE' => 'sv_SE', 'SG' => 'en_SG', 'SH' => 'en_SH', 'SI' => 'sl_SI', 'SJ' => 'nb_SJ', |
||
| 172 | 'SK' => 'sk_SK', 'SL' => 'kri_SL', 'SM' => 'it_SM', 'SN' => 'fr_SN', 'SO' => 'sw_SO', |
||
| 173 | 'SR' => 'srn_SR', 'ST' => 'pt_ST', 'SV' => 'es_SV', 'SY' => 'ar_SY', 'SZ' => 'en_SZ', |
||
| 174 | 'TC' => 'en_TC', 'TD' => 'fr_TD', 'TF' => 'und_TF', 'TG' => 'fr_TG', 'TH' => 'th_TH', |
||
| 175 | 'TJ' => 'tg_Cyrl_TJ', 'TK' => 'tkl_TK', 'TL' => 'pt_TL', 'TM' => 'tk_TM', 'TN' => 'ar_TN', |
||
| 176 | 'TO' => 'to_TO', 'TR' => 'tr_TR', 'TT' => 'en_TT', 'TV' => 'tvl_TV', 'TW' => 'zh_Hant_TW', |
||
| 177 | 'TZ' => 'sw_TZ', 'UA' => 'uk_UA', 'UG' => 'sw_UG', 'UM' => 'en_UM', 'US' => 'en_US', |
||
| 178 | 'UY' => 'es_UY', 'UZ' => 'uz_Cyrl_UZ', 'VA' => 'it_VA', 'VC' => 'en_VC', 'VE' => 'es_VE', |
||
| 179 | 'VG' => 'en_VG', 'VI' => 'en_VI', 'VU' => 'bi_VU', 'WF' => 'wls_WF', 'WS' => 'sm_WS', |
||
| 180 | 'YE' => 'ar_YE', 'YT' => 'swb_YT', 'ZA' => 'en_ZA', 'ZM' => 'en_ZM', 'ZW' => 'sn_ZW', |
||
| 181 | // CUSTOM SilverStripe Add Maori locales. |
||
| 182 | // Remove once updating Zend_Locale to 2.0 (which uses CLDR 1.9), see |
||
| 183 | // https://github.com/zendframework/zf2/tree/master/resources/cldr/main |
||
| 184 | 'MI' => 'mi_NZ', |
||
| 185 | 'LC' => 'lc_XX', |
||
| 186 | ); |
||
| 187 | |||
| 188 | /** |
||
| 189 | * Autosearch constants |
||
| 190 | */ |
||
| 191 | const BROWSER = 'browser'; |
||
| 192 | const ENVIRONMENT = 'environment'; |
||
| 193 | const ZFDEFAULT = 'default'; |
||
| 194 | |||
| 195 | /** |
||
| 196 | * Defines if old behaviour should be supported |
||
| 197 | * Old behaviour throws notices and will be deleted in future releases |
||
| 198 | * |
||
| 199 | * @var boolean |
||
| 200 | */ |
||
| 201 | public static $compatibilityMode = false; |
||
| 202 | |||
| 203 | /** |
||
| 204 | * Internal variable |
||
| 205 | * |
||
| 206 | * @var boolean |
||
| 207 | */ |
||
| 208 | private static $_breakChain = false; |
||
| 209 | |||
| 210 | /** |
||
| 211 | * Actual set locale |
||
| 212 | * |
||
| 213 | * @var string Locale |
||
| 214 | */ |
||
| 215 | protected $_locale; |
||
| 216 | |||
| 217 | /** |
||
| 218 | * Automatic detected locale |
||
| 219 | * |
||
| 220 | * @var string Locales |
||
| 221 | */ |
||
| 222 | protected static $_auto; |
||
| 223 | |||
| 224 | /** |
||
| 225 | * Browser detected locale |
||
| 226 | * |
||
| 227 | * @var string Locales |
||
| 228 | */ |
||
| 229 | protected static $_browser; |
||
| 230 | |||
| 231 | /** |
||
| 232 | * Environment detected locale |
||
| 233 | * |
||
| 234 | * @var string Locales |
||
| 235 | */ |
||
| 236 | protected static $_environment; |
||
| 237 | |||
| 238 | /** |
||
| 239 | * Default locale |
||
| 240 | * |
||
| 241 | * @var string Locales |
||
| 242 | */ |
||
| 243 | protected static $_default = array('en' => true); |
||
| 244 | |||
| 245 | /** |
||
| 246 | * Generates a locale object |
||
| 247 | * If no locale is given a automatic search is done |
||
| 248 | * Then the most probable locale will be automatically set |
||
| 249 | * Search order is |
||
| 250 | * 1. Given Locale |
||
| 251 | * 2. HTTP Client |
||
| 252 | * 3. Server Environment |
||
| 253 | * 4. Framework Standard |
||
| 254 | * |
||
| 255 | * @param string|Zend_Locale $locale (Optional) Locale for parsing input |
||
| 256 | * @throws Zend_Locale_Exception When autodetection has been failed |
||
| 257 | */ |
||
| 258 | public function __construct($locale = null) |
||
| 262 | |||
| 263 | /** |
||
| 264 | * Serialization Interface |
||
| 265 | * |
||
| 266 | * @return string |
||
| 267 | */ |
||
| 268 | public function serialize() |
||
| 272 | |||
| 273 | /** |
||
| 274 | * Returns a string representation of the object |
||
| 275 | * |
||
| 276 | * @return string |
||
| 277 | */ |
||
| 278 | public function toString() |
||
| 282 | |||
| 283 | /** |
||
| 284 | * Returns a string representation of the object |
||
| 285 | * Alias for toString |
||
| 286 | * |
||
| 287 | * @return string |
||
| 288 | */ |
||
| 289 | public function __toString() |
||
| 293 | |||
| 294 | /** |
||
| 295 | * Return the default locale |
||
| 296 | * |
||
| 297 | * @return array Returns an array of all locale string |
||
| 298 | */ |
||
| 299 | public static function getDefault() |
||
| 318 | |||
| 319 | /** |
||
| 320 | * Sets a new default locale which will be used when no locale can be detected |
||
| 321 | * If provided you can set a quality between 0 and 1 (or 2 and 100) |
||
| 322 | * which represents the percent of quality the browser |
||
| 323 | * requested within HTTP |
||
| 324 | * |
||
| 325 | * @param string|Zend_Locale $locale Locale to set |
||
| 326 | * @param float $quality The quality to set from 0 to 1 |
||
| 327 | * @throws Zend_Locale_Exception When a autolocale was given |
||
| 328 | * @throws Zend_Locale_Exception When a unknown locale was given |
||
| 329 | * @return void |
||
| 330 | */ |
||
| 331 | public static function setDefault($locale, $quality = 1) |
||
| 363 | |||
| 364 | /** |
||
| 365 | * Expects the Systems standard locale |
||
| 366 | * |
||
| 367 | * For Windows: |
||
| 368 | * f.e.: LC_COLLATE=C;LC_CTYPE=German_Austria.1252;LC_MONETARY=C |
||
| 369 | * would be recognised as de_AT |
||
| 370 | * |
||
| 371 | * @return array |
||
| 372 | */ |
||
| 373 | public static function getEnvironment() |
||
| 422 | |||
| 423 | /** |
||
| 424 | * Return an array of all accepted languages of the client |
||
| 425 | * Expects RFC compilant Header !! |
||
| 426 | * |
||
| 427 | * The notation can be : |
||
| 428 | * de,en-UK-US;q=0.5,fr-FR;q=0.2 |
||
| 429 | * |
||
| 430 | * @return array - list of accepted languages including quality |
||
| 431 | */ |
||
| 432 | public static function getBrowser() |
||
| 487 | |||
| 488 | /** |
||
| 489 | * Sets a new locale |
||
| 490 | * |
||
| 491 | * @param string|Zend_Locale $locale (Optional) New locale to set |
||
| 492 | * @return void |
||
| 493 | */ |
||
| 494 | public function setLocale($locale = null) |
||
| 515 | |||
| 516 | /** |
||
| 517 | * Returns the language part of the locale |
||
| 518 | * |
||
| 519 | * @return string |
||
| 520 | */ |
||
| 521 | public function getLanguage() |
||
| 526 | |||
| 527 | /** |
||
| 528 | * Returns the region part of the locale if available |
||
| 529 | * |
||
| 530 | * @return string|false - Regionstring |
||
| 531 | */ |
||
| 532 | public function getRegion() |
||
| 541 | |||
| 542 | /** |
||
| 543 | * Return the accepted charset of the client |
||
| 544 | * |
||
| 545 | * @return string |
||
| 546 | */ |
||
| 547 | public static function getHttpCharset() |
||
| 574 | |||
| 575 | /** |
||
| 576 | * Returns true if both locales are equal |
||
| 577 | * |
||
| 578 | * @param Zend_Locale $object Locale to check for equality |
||
| 579 | * @return boolean |
||
| 580 | */ |
||
| 581 | public function equals(Zend_Locale $object) |
||
| 589 | |||
| 590 | /** |
||
| 591 | * Returns localized informations as array, supported are several |
||
| 592 | * types of informations. |
||
| 593 | * For detailed information about the types look into the documentation |
||
| 594 | * |
||
| 595 | * @param string $path (Optional) Type of information to return |
||
| 596 | * @param string|Zend_Locale $locale (Optional) Locale|Language for which this informations should be returned |
||
| 597 | * @param string $value (Optional) Value for detail list |
||
| 598 | * @return array Array with the wished information in the given language |
||
| 599 | */ |
||
| 600 | public static function getTranslationList($path = null, $locale = null, $value = null) |
||
| 611 | |||
| 612 | /** |
||
| 613 | * Returns an array with the name of all languages translated to the given language |
||
| 614 | * |
||
| 615 | * @param string|Zend_Locale $locale (Optional) Locale for language translation |
||
| 616 | * @return array |
||
| 617 | * @deprecated |
||
| 618 | */ |
||
| 619 | public static function getLanguageTranslationList($locale = null) |
||
| 624 | |||
| 625 | /** |
||
| 626 | * Returns an array with the name of all scripts translated to the given language |
||
| 627 | * |
||
| 628 | * @param string|Zend_Locale $locale (Optional) Locale for script translation |
||
| 629 | * @return array |
||
| 630 | * @deprecated |
||
| 631 | */ |
||
| 632 | public static function getScriptTranslationList($locale = null) |
||
| 637 | |||
| 638 | /** |
||
| 639 | * Returns an array with the name of all countries translated to the given language |
||
| 640 | * |
||
| 641 | * @param string|Zend_Locale $locale (Optional) Locale for country translation |
||
| 642 | * @return array |
||
| 643 | * @deprecated |
||
| 644 | */ |
||
| 645 | public static function getCountryTranslationList($locale = null) |
||
| 650 | |||
| 651 | /** |
||
| 652 | * Returns an array with the name of all territories translated to the given language |
||
| 653 | * All territories contains other countries. |
||
| 654 | * |
||
| 655 | * @param string|Zend_Locale $locale (Optional) Locale for territory translation |
||
| 656 | * @return array |
||
| 657 | * @deprecated |
||
| 658 | */ |
||
| 659 | public static function getTerritoryTranslationList($locale = null) |
||
| 664 | |||
| 665 | /** |
||
| 666 | * Returns a localized information string, supported are several types of informations. |
||
| 667 | * For detailed information about the types look into the documentation |
||
| 668 | * |
||
| 669 | * @param string $value Name to get detailed information about |
||
| 670 | * @param string $path (Optional) Type of information to return |
||
| 671 | * @param string|Zend_Locale $locale (Optional) Locale|Language for which this informations should be returned |
||
| 672 | * @return string|false The wished information in the given language |
||
| 673 | */ |
||
| 674 | public static function getTranslation($value = null, $path = null, $locale = null) |
||
| 685 | |||
| 686 | /** |
||
| 687 | * Returns the localized language name |
||
| 688 | * |
||
| 689 | * @param string $value Name to get detailed information about |
||
| 690 | * @param string $locale (Optional) Locale for language translation |
||
| 691 | * @return array |
||
| 692 | * @deprecated |
||
| 693 | */ |
||
| 694 | public static function getLanguageTranslation($value, $locale = null) |
||
| 699 | |||
| 700 | /** |
||
| 701 | * Returns the localized script name |
||
| 702 | * |
||
| 703 | * @param string $value Name to get detailed information about |
||
| 704 | * @param string $locale (Optional) locale for script translation |
||
| 705 | * @return array |
||
| 706 | * @deprecated |
||
| 707 | */ |
||
| 708 | public static function getScriptTranslation($value, $locale = null) |
||
| 713 | |||
| 714 | /** |
||
| 715 | * Returns the localized country name |
||
| 716 | * |
||
| 717 | * @param string $value Name to get detailed information about |
||
| 718 | * @param string|Zend_Locale $locale (Optional) Locale for country translation |
||
| 719 | * @return array |
||
| 720 | * @deprecated |
||
| 721 | */ |
||
| 722 | public static function getCountryTranslation($value, $locale = null) |
||
| 727 | |||
| 728 | /** |
||
| 729 | * Returns the localized territory name |
||
| 730 | * All territories contains other countries. |
||
| 731 | * |
||
| 732 | * @param string $value Name to get detailed information about |
||
| 733 | * @param string|Zend_Locale $locale (Optional) Locale for territory translation |
||
| 734 | * @return array |
||
| 735 | * @deprecated |
||
| 736 | */ |
||
| 737 | public static function getTerritoryTranslation($value, $locale = null) |
||
| 742 | |||
| 743 | /** |
||
| 744 | * Returns an array with translated yes strings |
||
| 745 | * |
||
| 746 | * @param string|Zend_Locale $locale (Optional) Locale for language translation (defaults to $this locale) |
||
| 747 | * @return array |
||
| 748 | */ |
||
| 749 | public static function getQuestion($locale = null) |
||
| 765 | |||
| 766 | /** |
||
| 767 | * Internal function for preparing the returned question regex string |
||
| 768 | * |
||
| 769 | * @param string $input Regex to parse |
||
| 770 | * @return string |
||
| 771 | */ |
||
| 772 | private static function _prepareQuestionString($input) |
||
| 809 | |||
| 810 | /** |
||
| 811 | * Checks if a locale identifier is a real locale or not |
||
| 812 | * Examples: |
||
| 813 | * "en_XX" refers to "en", which returns true |
||
| 814 | * "XX_yy" refers to "root", which returns false |
||
| 815 | * |
||
| 816 | * @param string|Zend_Locale $locale Locale to check for |
||
| 817 | * @param boolean $strict (Optional) If true, no rerouting will be done when checking |
||
| 818 | * @param boolean $compatible (DEPRECATED) Only for internal usage, brakes compatibility mode |
||
| 819 | * @return boolean If the locale is known dependend on the settings |
||
| 820 | */ |
||
| 821 | public static function isLocale($locale, $strict = false, $compatible = true) |
||
| 862 | |||
| 863 | /** |
||
| 864 | * Finds the proper locale based on the input |
||
| 865 | * Checks if it exists, degrades it when necessary |
||
| 866 | * Detects registry locale and when all fails tries to detect a automatic locale |
||
| 867 | * Returns the found locale as string |
||
| 868 | * |
||
| 869 | * @param string $locale |
||
| 870 | * @throws Zend_Locale_Exception When the given locale is no locale or the autodetection fails |
||
| 871 | * @return string |
||
| 872 | */ |
||
| 873 | public static function findLocale($locale = null) |
||
| 902 | |||
| 903 | /** |
||
| 904 | * Returns the expected locale for a given territory |
||
| 905 | * |
||
| 906 | * @param string $territory Territory for which the locale is being searched |
||
| 907 | * @return string|null Locale string or null when no locale has been found |
||
| 908 | */ |
||
| 909 | public static function getLocaleToTerritory($territory) |
||
| 918 | |||
| 919 | /** |
||
| 920 | * Returns a list of all known locales where the locale is the key |
||
| 921 | * Only real locales are returned, the internal locales 'root', 'auto', 'browser' |
||
| 922 | * and 'environment' are suppressed |
||
| 923 | * |
||
| 924 | * @return array List of all Locales |
||
| 925 | */ |
||
| 926 | public static function getLocaleList() |
||
| 935 | |||
| 936 | /** |
||
| 937 | * Returns the set cache |
||
| 938 | * |
||
| 939 | * @return Zend_Cache_Core The set cache |
||
| 940 | */ |
||
| 941 | public static function getCache() |
||
| 946 | |||
| 947 | /** |
||
| 948 | * Sets a cache |
||
| 949 | * |
||
| 950 | * @param Zend_Cache_Core $cache Cache to set |
||
| 951 | * @return void |
||
| 952 | */ |
||
| 953 | public static function setCache(Zend_Cache_Core $cache) |
||
| 958 | |||
| 959 | /** |
||
| 960 | * Returns true when a cache is set |
||
| 961 | * |
||
| 962 | * @return boolean |
||
| 963 | */ |
||
| 964 | public static function hasCache() |
||
| 969 | |||
| 970 | /** |
||
| 971 | * Removes any set cache |
||
| 972 | * |
||
| 973 | * @return void |
||
| 974 | */ |
||
| 975 | public static function removeCache() |
||
| 980 | |||
| 981 | /** |
||
| 982 | * Clears all set cache data |
||
| 983 | * |
||
| 984 | * @param string $tag Tag to clear when the default tag name is not used |
||
| 985 | * @return void |
||
| 986 | */ |
||
| 987 | public static function clearCache($tag = null) |
||
| 992 | |||
| 993 | /** |
||
| 994 | * Disables the set cache |
||
| 995 | * |
||
| 996 | * @param boolean $flag True disables any set cache, default is false |
||
| 997 | * @return void |
||
| 998 | */ |
||
| 999 | public static function disableCache($flag) |
||
| 1004 | |||
| 1005 | /** |
||
| 1006 | * Internal function, returns a single locale on detection |
||
| 1007 | * |
||
| 1008 | * @param string|Zend_Locale $locale (Optional) Locale to work on |
||
| 1009 | * @param boolean $strict (Optional) Strict preparation |
||
| 1010 | * @throws Zend_Locale_Exception When no locale is set which is only possible when the class was wrong extended |
||
| 1011 | * @return string |
||
| 1012 | */ |
||
| 1013 | private static function _prepareLocale($locale, $strict = false) |
||
| 1080 | |||
| 1081 | /** |
||
| 1082 | * Search the locale automatically and return all used locales |
||
| 1083 | * ordered by quality |
||
| 1084 | * |
||
| 1085 | * Standard Searchorder is Browser, Environment, Default |
||
| 1086 | * |
||
| 1087 | * @param string $searchorder (Optional) Searchorder |
||
| 1088 | * @return array Returns an array of all detected locales |
||
| 1089 | */ |
||
| 1090 | public static function getOrder($order = null) |
||
| 1111 | } |
||
| 1112 |