XLIV. iconv 関数

導入

このモジュールには、iconv による文字集合の変換機能へのインターフェースが含まれています。このモジュールにより、ローカルな文字集合で表された文字列を、Unicod文字集合のような他の文字集合で表わされた文字列に変換することができます。サポートされる文字集合は、使用するシステムのiconvの実装に依存します。いくつかのシステムではiconv関数は意図した通りに動作しない可能性があることに注意して下さい。この場合は、ライブラリをインストールすると良いでしょう。このライブラリの出力は、多くの場合、より妥当なものとなります。

PHP 5.0.0以降、この拡張モジュールには、多言語スクリプトを書く際に有用な種々のユーティリティが附属しています。この新機能については、以下のセクションを参照して下さい。

要件

使用しているシステムが、最近のPOSIX対応システムのどれかである場合には、標準C 言語ライブラリの中にiconv機能が含まれているため、何かをする必要はありません。そうでない場合は、ライブラリを入手して使用するシステムにインストールする必要があります。

インストール手順

この関数を使用するには、 PHPバイナリを以下のオプションを指定して構築する必要があります。 --with-iconv[=DIR]

Windows® ユーザへの注意: Windows®環境でこのモジュールを有効にするには、 PHP/Win32バイナリパッケージに附属するiconv.dllまたは iconv-1.3.dll (4.2.1より前)という名前の DLLファイルを環境変数PATHで指定したディレクトリまたは Windows® のシステムディレクトリにコピーする必要があります。

実行用の設定

これらの関数の動作は、php.iniの設定により変化します。

表 1. iconv設定オプション

名前	デフォルト	変更の可否
iconv.input_encoding	ICONV_INPUT_ENCODING	PHP_INI_ALL
iconv.output_encoding	ICONV_OUTPUT_ENCODING	PHP_INI_ALL
iconv.internal_encoding	ICONV_INTERNAL_ENCODING	PHP_INI_ALL

PHP_INI_*定数に関する詳細と定義については、 ini_set()を参照して下さい。

リソース型

この拡張モジュールはリソース型を全く定義しません。

定義済みの定数

PHP 4.3.0以降、この拡張モジュールで使用される iconv 実装の種類を実行時に調べることができます。

表 2. iconv定数

名前	型	説明
ICONV_IMPL	string	実装の名前
ICONV_VERSION	string	実装のバージョン

注意: これらの定数を用いて実装に依存するスクリプトを書くことは全く推奨されません。

PHP 5.0.0以降、以下の定数も利用可能です。

表 3. PHP 5.0.0以降で利用可能なiconv定数

名前	型	説明
ICONV_MIME_DECODE_STRICT	integer	iconv_mime_decode()で使用されるビットマスク
ICONV_MIME_DECODE_CONTINUE_ON_ERROR	integer	iconv_mime_decode()で使用されるビットマスク

以下も参照下さい

GNU Recode 関数も参照して下さい。

目次
iconv_get_encoding -- iconv拡張モジュールの内部設定変数を取得する
iconv_mime_decode_headers -- Decodes multiple MIME header fields at once
iconv_mime_decode -- Decodes a MIME header field
iconv_mime_encode -- Composes a MIME header field
iconv_set_encoding -- 文字エンコーディング変換用の設定を行なう
iconv_strlen -- Returns the character count of string
iconv_strpos -- Finds position of first occurrence of a needle within a haystack
iconv_strrpos -- Finds the last occurrence of a needle within the specified range of haystack
iconv_substr -- Cut out part of a string
iconv -- 文字列を指定した文字エンコーディングに変換する
ob_iconv_handler -- 出力バッファハンドラとして文字エンコーディングを変換する

add a note User Contributed Notes
iconv 関数

The Godfather
15-Dec-2004 01:36


With this function you can translate the german Symbols from the character set UTF-8 in windows-1252. 



function convert_text($str){

  $out = '';

  for ($i = 0; $i<strlen($str);$i++){

   $ch = ord($str{$i});

   switch($ch){

         case 252: $out .= chr(129);break; //u Umlaut

         case 220: $out .= chr(154);break;//U Umlaut 

         case 228: $out .= chr(132);break;//a Umlaut  

         case 196: $out .= chr(142);break;//A Umlaut 

         case 214: $out .= chr(153);break;//O Umlaut  

         case 246: $out .= chr(148);break;//o Umlaug 

         case 223: $out .= chr(225);break;//SZ 

         default : $out .= chr($ch) ;

   }

  }

  return $out;

}

tokiee at hotmail dot com
19-Aug-2004 08:40


iconv now has been built-in, at least in PHP >= 5.0.1 for win32. You don't have to modify php.ini for this. Actually you should not. And clearly, libiconv does not need to be installed.

thierry.bo
23-Dec-2003 10:26


Windows users.



Personaly I leaved all php dlls in \php\dlls\ directory, just adding this path to my system path, and iconv.dll supplied with php 4.3.2 works fine, also leaving supplied php_iconv.dll in my \php\extensions\ directory. This was working fine with Apache and Omnihttpd server I use.



As soon I installed IIS on the same server, php complained about not finding php_iconv.dll in the extensions directory. In fact PHP with IIS loads all extensions in my \php\extensions directory correctly, except php_iconv.dll. 

Although iconv.dll is in my system path, the only way to load php_iconv.dll was to copy iconv.dll file in \%winnt\system32 directory. With other servers, iconv.dll can be in anywhere in the system path.

ALecFFer
07-Nov-2003 12:10


To windows users:



Download here iconv version 1.9.1:

14-Sep-2002 12:23


I'm not sure how recent version of

glibc 2.x Slackware 7.x/8.x comes with, but

it's very likely that it comes with glibc 2.2.x.

In that case, you don't have to bother at all to

install libiconv in /usr/local. iconv(3) in glibc 2.2.x

is very good (thanks to Ulrich Drepper and

Bruno Haible. the latter is the author of libiconv).

libiconv is very handy for those outdated/non-standard-compliant Unix 

and non-Unix systems that don't have 

sufficiently good iconv(3) in their C library.

elk at NOSPAMmodel-fx dot com
26-Jul-2002 04:07


If you use the libiconv library instead of the libc's iconv support, don't forget to use libiconv() instead of iconv()

elk at NOSPAMmodel-fx dot com
25-Jul-2002 03:39


To compile libiconv under Slackware 7.0 or 8.0 without errors (either with the apache module of PHP or the CGI version), you must specify the full path of the libiconv installation.



Exemple :



       --with-iconv=/usr/local

add a note


	downloads \| documentation \| faq \| getting help \| mailing lists \| \| php.net sites \| links \| my php.net

search for in the