XL. iconv Functions
Introduction
This module contains an interface to iconv character set conversion
facility. With this module, you can turn a string represented
by a local character set into the one represented by another
character set, which may be the Unicode charcter set. Supported
character sets depend on the iconv implementation of your
system. Note that the iconv function on some systems may not
work as you expect. In such case, it'd be a good idea to install
the GNU libiconv library. It will most likely end up with
more consistent results.
Since PHP 5.0.0, this extension comes with various utility
functions that help you to write multilingual scripts. Let's
have a look at the following sections to explore the new
features.
Requirements
You will need nothing if the system you are using is one
of the recent POSIX-compliant systems because standard C
libraries that are supplied in them must provide iconv facility.
Otherwise, you have to get the libiconv library installed
in your system.
Installation
To use functions provided by this module, the PHP binary
must be built with the following configure line: --with-iconv[=DIR].
Note to Windows® Users: In order to enable this module
on a Windows® environment, you need to put a DLL file
named iconv.dll or iconv-1.3.dll (prior to 4.2.1) which
is bundled with the PHP/Win32 binary package into a directory
specified by the PATH environment variable or one of the
system directories of your Windows® installation.
Runtime Configuration
The behaviour of these functions is affected by settings
in php.ini.
Table 1. Iconv configuration options
Name Default Changeable
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
For further details and definition of the PHP_INI_* constants
see ini_set().
|