phpmyadmin/libraries/charset_conversion.lib.php

   1 <?php
   2 /* vim: set expandtab sw=4 ts=4 sts=4: */
   3 /**
   4  * Charset conversion functions.
   5  *
   6  * @package PhpMyAdmin
   7  */
   8 if (! defined('PHPMYADMIN')) {
   9     exit;
  10 }
  11
  12 define('PMA_CHARSET_NONE', 0);
  13 define('PMA_CHARSET_ICONV', 1);
  14 define('PMA_CHARSET_RECODE', 2);
  15 define('PMA_CHARSET_ICONV_AIX', 3);
  16 define('PMA_CHARSET_MB', 4);
  17
  18 if (! isset($GLOBALS['cfg']['RecodingEngine'])) {
  19     $GLOBALS['cfg']['RecodingEngine'] = '';
  20 }
  21 // Finally detect which function we will use:
  22 if ($GLOBALS['cfg']['RecodingEngine'] == 'iconv') {
  23     if (@function_exists('iconv')) {
  24         if ((@stristr(PHP_OS, 'AIX'))
  25             && (@strcasecmp(ICONV_IMPL, 'unknown') == 0)
  26             && (@strcasecmp(ICONV_VERSION, 'unknown') == 0)
  27         ) {
  28             $PMA_recoding_engine = PMA_CHARSET_ICONV_AIX;
  29         } else {
  30             $PMA_recoding_engine = PMA_CHARSET_ICONV;
  31         }
  32     } else {
  33         $PMA_recoding_engine = PMA_CHARSET_NONE;
  34         PMA_warnMissingExtension('iconv');
  35     }
  36 } elseif ($GLOBALS['cfg']['RecodingEngine'] == 'recode') {
  37     if (@function_exists('recode_string')) {
  38         $PMA_recoding_engine = PMA_CHARSET_RECODE;
  39     } else {
  40         $PMA_recoding_engine = PMA_CHARSET_NONE;
  41         PMA_warnMissingExtension('recode');
  42     }
  43 } elseif ($GLOBALS['cfg']['RecodingEngine'] == 'mb') {
  44     if (@function_exists('mb_convert_encoding')) {
  45         $PMA_recoding_engine = PMA_CHARSET_MB;
  46     } else {
  47         $PMA_recoding_engine = PMA_CHARSET_NONE;
  48         PMA_warnMissingExtension('mbstring');
  49     }
  50 } elseif ($GLOBALS['cfg']['RecodingEngine'] == 'auto') {
  51     if (@function_exists('iconv')) {
  52         if ((@stristr(PHP_OS, 'AIX'))
  53             && (@strcasecmp(ICONV_IMPL, 'unknown') == 0)
  54             && (@strcasecmp(ICONV_VERSION, 'unknown') == 0)
  55         ) {
  56             $PMA_recoding_engine = PMA_CHARSET_ICONV_AIX;
  57         } else {
  58             $PMA_recoding_engine = PMA_CHARSET_ICONV;
  59         }
  60     } elseif (@function_exists('recode_string')) {
  61         $PMA_recoding_engine = PMA_CHARSET_RECODE;
  62     } elseif (@function_exists('mb_convert_encoding')) {
  63         $PMA_recoding_engine = PMA_CHARSET_MB;
  64     } else {
  65         $PMA_recoding_engine = PMA_CHARSET_NONE;
  66     }
  67 } else {
  68     $PMA_recoding_engine = PMA_CHARSET_NONE;
  69 }
  70
  71 /* Load AIX iconv wrapper if needed */
  72 if ($PMA_recoding_engine == PMA_CHARSET_ICONV_AIX) {
  73     include_once './libraries/iconv_wrapper.lib.php';
  74 }
  75
  76 /**
  77  * Converts encoding of text according to parameters with detected
  78  * conversion function.
  79  *
  80  * @param string $src_charset  source charset
  81  * @param string $dest_charset target charset
  82  * @param string $what         what to convert
  83  *
  84  * @return string   converted text
  85  *
  86  * @access  public
  87  *
  88  */
  89 function PMA_convertString($src_charset, $dest_charset, $what)
  90 {
  91     if ($src_charset == $dest_charset) {
  92         return $what;
  93     }
  94     switch ($GLOBALS['PMA_recoding_engine']) {
  95     case PMA_CHARSET_RECODE:
  96         return recode_string($src_charset . '..'  . $dest_charset, $what);
  97     case PMA_CHARSET_ICONV:
  98         return iconv(
  99             $src_charset, $dest_charset . $GLOBALS['cfg']['IconvExtraParams'], $what
 100         );
 101     case PMA_CHARSET_ICONV_AIX:
 102         return PMA_convertAIXIconv(
 103             $src_charset, $dest_charset . $GLOBALS['cfg']['IconvExtraParams'], $what
 104         );
 105     case PMA_CHARSET_MB:
 106         return mb_convert_encoding(
 107             $what, $dest_charset, $src_charset
 108         );
 109     default:
 110         return $what;
 111     }
 112 } //  end of the "PMA_convertString()" function
 113
 114 ?>