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         $PMA_recoding_engine = PMA_getIconvRecodingEngine();
  25     } else {
  26         $PMA_recoding_engine = PMA_CHARSET_NONE;
  27         PMA_warnMissingExtension('iconv');
  28     }
  29 } elseif ($GLOBALS['cfg']['RecodingEngine'] == 'recode') {
  30     if (@function_exists('recode_string')) {
  31         $PMA_recoding_engine = PMA_CHARSET_RECODE;
  32     } else {
  33         $PMA_recoding_engine = PMA_CHARSET_NONE;
  34         PMA_warnMissingExtension('recode');
  35     }
  36 } elseif ($GLOBALS['cfg']['RecodingEngine'] == 'mb') {
  37     if (@function_exists('mb_convert_encoding')) {
  38         $PMA_recoding_engine = PMA_CHARSET_MB;
  39     } else {
  40         $PMA_recoding_engine = PMA_CHARSET_NONE;
  41         PMA_warnMissingExtension('mbstring');
  42     }
  43 } elseif ($GLOBALS['cfg']['RecodingEngine'] == 'auto') {
  44     if (@function_exists('iconv')) {
  45         $PMA_recoding_engine = PMA_getIconvRecodingEngine();
  46     } elseif (@function_exists('recode_string')) {
  47         $PMA_recoding_engine = PMA_CHARSET_RECODE;
  48     } elseif (@function_exists('mb_convert_encoding')) {
  49         $PMA_recoding_engine = PMA_CHARSET_MB;
  50     } else {
  51         $PMA_recoding_engine = PMA_CHARSET_NONE;
  52     }
  53 } else {
  54     $PMA_recoding_engine = PMA_CHARSET_NONE;
  55 }
  56
  57 /* Load AIX iconv wrapper if needed */
  58 if ($PMA_recoding_engine == PMA_CHARSET_ICONV_AIX) {
  59     include_once './libraries/iconv_wrapper.lib.php';
  60 }
  61
  62 /**
  63  * Determines the correct recoding engine to use
  64  *
  65  * @return int $PMA_recoding_engine
  66  *
  67  * @access  public
  68  *
  69  */
  70 function PMA_getIconvRecodingEngine()
  71 {
  72     if ((@stristr(PHP_OS, 'AIX'))
  73         && (@strcasecmp(ICONV_IMPL, 'unknown') == 0)
  74         && (@strcasecmp(ICONV_VERSION, 'unknown') == 0)
  75     ) {
  76         return PMA_CHARSET_ICONV_AIX;
  77     } else {
  78         return PMA_CHARSET_ICONV;
  79     }
  80 }
  81
  82 /**
  83  * Converts encoding of text according to parameters with detected
  84  * conversion function.
  85  *
  86  * @param string $src_charset  source charset
  87  * @param string $dest_charset target charset
  88  * @param string $what         what to convert
  89  *
  90  * @return string   converted text
  91  *
  92  * @access  public
  93  *
  94  */
  95 function PMA_convertString($src_charset, $dest_charset, $what)
  96 {
  97     if ($src_charset == $dest_charset) {
  98         return $what;
  99     }
 100     switch ($GLOBALS['PMA_recoding_engine']) {
 101     case PMA_CHARSET_RECODE:
 102         return recode_string($src_charset . '..'  . $dest_charset, $what);
 103     case PMA_CHARSET_ICONV:
 104         return iconv(
 105             $src_charset, $dest_charset . $GLOBALS['cfg']['IconvExtraParams'], $what
 106         );
 107     case PMA_CHARSET_ICONV_AIX:
 108         return PMA_convertAIXIconv(
 109             $src_charset, $dest_charset . $GLOBALS['cfg']['IconvExtraParams'], $what
 110         );
 111     case PMA_CHARSET_MB:
 112         return mb_convert_encoding(
 113             $what, $dest_charset, $src_charset
 114         );
 115     default:
 116         return $what;
 117     }
 118 } //  end of the "PMA_convertString()" function
 119
 120 ?>