What ist phpUnac?
-----------------
This is phpUnac, a php (php3 or php4) binding for the unac library
version 1.3.0 as found on http://www.senga.org/unac/html/.

It provides a single function (unac_string) that strips accents from
a string in all charsets known to iconv(3). Sample usage is :

unac_string("iso-8859-1", "t") -> "ete"

Install
-------

phpUnac works with :
. php-3.0.12 or higher
. php-4.0.3pl1 or higher
. apache_1.3.9 or higher compiled and installed with dynamic modules 
  enabled (--enable-shared=max).

For OS that are not GNU/Linux we recommend to use the iconv library
provided by Bruno Haible <haible@clisp.cons.org> at
ftp://ftp.ilog.fr/pub/Users/haible/gnu/libiconv-1.3.tar.gz. Under
Solaris-2.6 the native iconv library is not able to convert from
ISO-8859-1 to UTF-16 directly, it must do ISO-8859-1 -> UTF-8 ->
UTF-16 and vice versa.

. Check that your apache has php3 or php4 compiled in. Create a phpinfo.php3
  (or phpinfo.php) page to display the status of php using <? phpinfo() ?>

. Extract the sources of the php version you are using and run configure
  on them exactly as shown on the phpinfo page. Do not compile them, this is
  not needed.

. ./configure --with-php-version={3,4} 
	      --with-php-dir=DIR
	      --with-php-extensions=DIR
	      --with-apache-include=DIR

  --with-php-version={3,4}
  If you are running php3, chose 3. If you are running php4 chose 4.

  --with-php-dir=DIR
  The sources directory of php. First run configure on them. If
  you want to mimic an installed version configuration, check the
  configure arguments with phpinfo().

  --with-php-extensions=DIR
  The directory where the php shared library must be installed. It
  is shown in the output of phpinfo() as extensions_dir in the 
  configuration section. If it says 'none', add or uncomment
  extensions_dir in your php3.ini (or php.ini) file.

  --with-apache-include=DIR
  The directory containing the apache header files. locate httpd.h
  will tell you where they are. For instance on RedHat-7.0 it is in
  /usr/include/apache.

  Example for configuration for a native RedHat-6.2 installation with
  php-3.0.17 sources, apache-1.3.11 compiled with php-3.0.14.

  cd /usr/local/ports/php-3.0.17
  ./configure '--prefix=/usr' '--with-apxs=/usr/sbin/apxs' \
              '--with-config-file-path=/etc/httpd' '--enable-safe-mode' \
              '--with-exec-dir=/usr/bin' '--with-system-regex' \
              '--disable-debug' '--with-zlib' '--enable-debugger' \
              '--enable-magic-quotes' '--enable-track-vars' '--with-xml'

  ./configure --with-php-version=3 \
	      --with-php-dir=/usr/local/ports/php-3.0.17 \
	      --with-php-extensions=/usr/lib/apache \
	      --with-apache-include=/usr/include/apache

. make

. make install

. For php3, add the following line in php3.ini
  extension=libphp_unac.so

. For php4, add the following line in php.ini
  extension=/extension/dir/libphp_unac.so
  Where /extension/dir is the value givent to the --with-php-extensions
  option at configure time. You can omit this if the extension directory
  is known to contain shared libraries (via ldconfig or LD_LIBRARY_PATH,
  typicaly). The module may also be specified with
  extension=libphp_unac.so
  only. 

. Restart the apache server.

. Load the phpinfo.php3 (or phpinfo.php) page in your navigator and search 
  for the unac string. The unac module must appear in the extensions list.

. Install the unac.php3 (or unac.php) file in your html tree and load it. 
  Success or failure will be self explanatory.

Authors
-------
Loic Dachary <loic@senga.org>
Andreas Hochsteger <e9625392@student.tuwien.ac.at>
