Unfortunately the informix extension has been moved to PECL but has no maintainer.
http://devzone.zend.com/node/view/id/1621#Heading11
In practic terms, it has been moved but is not available in PECL yet.
It's sad. I have a big client who uses this extension for more than 6 years and now has to change a code base of 500,000 lines of code or install an old version of PHP in the new server. They recently bought a redundant, double cpu, 8 gb ram, scsi disk server and will not be happy to run old versions of software with unmaintained extensions.
LX. Funciones de Informix
Introducción
El controlador de Informix para Informix (IDS) 7.x, SE 7.x, Universal Server (IUS) 9.x y IDS 2000 es implementado en "ifx.ec" y "php3_ifx.h" en el directorio de la extensión informix. El soporte para IDS 7.x es razonablemente completo, con soporte para columnas BYTE y TEXT. El soporte para IUS 9.x se encuentra parcialmente terminado: los nuevos tipos de datos se encuentran allí, pero el soporte para SLOB y CLOB aun está en construcción
Requisitos
Notas de configuración: Necesita alguna versión de ESQL/C para compilar el controlador para Informix de PHP. Las versiones de ESQL/C a partir de 7.2x deben trabajar bien. ESQL/C es ahora parte del SDK de Cliente de Informix.
Asegúrese de que la variable "INFORMIXDIR" haya sido definida, y de que $INFORMIXDIR/bin se encuentre en su PATH antes de ejecutar el script "configure".
Instalación
Para poder utilizar estas funciones, se debe compilar PHP con la opción de compilación --with-informix[=DIR], donde DIR es el directorio base de la instalación de Informix, y cuyo valor no se establece por defecto.
Configuración en tiempo de ejecución
El comportamiento de estas funciones está afectado por los valores definidos en php.ini.
Nota: Make sure that the Informix environment variables INFORMIXDIR and INFORMIXSERVER are available to the PHP ifx driver, and that the INFORMIX bin directory is in the PATH. Check this by running a script that contains a call to phpinfo() before you start testing. The phpinfo() output should list these environment variables. This is true for both CGI php and Apache mod_php. You may have to set these environment variables in your Apache startup script.
The Informix shared libraries should also be available to the loader (check LD_LIBRARY_PATH or ld.so.conf/ldconfig).
Some notes on the use of BLOBs (TEXT and BYTE columns): BLOBs are normally addressed by BLOB identifiers. Select queries return a "blob id" for every BYTE and TEXT column. You can get at the contents with "string_var = ifx_get_blob($blob_id);" if you choose to get the BLOBs in memory (with: "ifx_blobinfile(0);"). If you prefer to receive the content of BLOB columns in a file, use "ifx_blobinfile(1);", and "ifx_get_blob($blob_id);" will get you the filename. Use normal file I/O to get at the blob contents.
For insert/update queries you must create these "blob id's" yourself with "ifx_create_blob();". You then plug the blob id's into an array, and replace the blob columns with a question mark (?) in the query string. For updates/inserts, you are responsible for setting the blob contents with ifx_update_blob().
The behaviour of BLOB columns can be altered by configuration variables that also can be set at runtime:
configuration variable: ifx.textasvarchar
configuration variable: ifx.byteasvarchar
runtime functions:
ifx_textasvarchar(0): use blob id's for select queries with TEXT columns
ifx_byteasvarchar(0): use blob id's for select queries with BYTE columns
ifx_textasvarchar(1): return TEXT columns as if they were VARCHAR columns, so that you don't need to use blob id's for select queries.
ifx_byteasvarchar(1): return BYTE columns as if they were VARCHAR columns, so that you don't need to use blob id's for select queries.
configuration variable: ifx.blobinfile
runtime function:
ifx_blobinfile_mode(0): return BYTE columns in memory, the blob id lets you get at the contents.
ifx_blobinfile_mode(1): return BYTE columns in a file, the blob id lets you get at the file name.
If you set ifx_text/byteasvarchar to 1, you can use TEXT and BYTE columns in select queries just like normal (but rather long) VARCHAR fields. Since all strings are "counted" in PHP, this remains "binary safe". It is up to you to handle this correctly. The returned data can contain anything, you are responsible for the contents.
If you set ifx_blobinfile to 1, use the file name returned by ifx_get_blob(..) to get at the blob contents. Note that in this case YOU ARE RESPONSIBLE FOR DELETING THE TEMPORARY FILES CREATED BY INFORMIX when fetching the row. Every new row fetched will create new temporary files for every BYTE column.
The location of the temporary files can be influenced by the environment variable "blobdir", default is "." (the current directory). Something like: putenv(blobdir=tmpblob"); will ease the cleaning up of temp files accidentally left behind (their names all start with "blb").
Automatically trimming "char" (SQLCHAR and SQLNCHAR) data: This can be set with the configuration variable
ifx.charasvarchar: if set to 1 trailing spaces will be automatically trimmed, to save you some "chopping".
NULL values: The configuration variable ifx.nullformat (and the runtime function ifx_nullformat()) when set to TRUE will return NULL columns as the string "NULL", when set to FALSE they return the empty string. This allows you to discriminate between NULL columns and empty columns.
Tabla 1. Informix configuration options
| Name | Default | Changeable | Changelog |
|---|---|---|---|
| ifx.allow_persistent | "1" | PHP_INI_SYSTEM | |
| ifx.max_persistent | "-1" | PHP_INI_SYSTEM | |
| ifx.max_links | "-1" | PHP_INI_SYSTEM | |
| ifx.default_host | NULL | PHP_INI_SYSTEM | |
| ifx.default_user | NULL | PHP_INI_SYSTEM | |
| ifx.default_password | NULL | PHP_INI_SYSTEM | |
| ifx.blobinfile | "1" | PHP_INI_ALL | |
| ifx.textasvarchar | "0" | PHP_INI_ALL | |
| ifx.byteasvarchar | "0" | PHP_INI_ALL | |
| ifx.charasvarchar | "0" | PHP_INI_ALL | |
| ifx.nullformat | "0" | PHP_INI_ALL |
A continuación se presenta una corta explicación de las directivas de configuración.
- ifx.allow_persistent boolean
Whether to allow persistent Informix connections.
- ifx.max_persistent integer
The maximum number of persistent Informix connections per process.
- ifx.max_links integer
The maximum number of Informix connections per process, including persistent connections.
- ifx.default_host string
The default host to connect to when no host is specified in ifx_connect() or ifx_pconnect(). Doesn't apply in safe mode.
- ifx.default_user string
The default user id to use when none is specified in ifx_connect() or ifx_pconnect(). Doesn't apply in safe mode.
- ifx.default_password string
The default password to use when none is specified in ifx_connect() or ifx_pconnect(). Doesn't apply in safe mode.
- ifx.blobinfile boolean
Set to TRUE if you want to return blob columns in a file, FALSE if you want them in memory. You can override the setting at runtime with ifx_blobinfile_mode().
- ifx.textasvarchar boolean
Set to TRUE if you want to return TEXT columns as normal strings in select statements, FALSE if you want to use blob id parameters. You can override the setting at runtime with ifx_textasvarchar().
- ifx.byteasvarchar boolean
Set to TRUE if you want to return BYTE columns as normal strings in select queries, FALSE if you want to use blob id parameters. You can override the setting at runtime with ifx_textasvarchar().
- ifx.charasvarchar boolean
Set to TRUE if you want to trim trailing spaces from CHAR columns when fetching them.
- ifx.nullformat boolean
Set to TRUE if you want to return NULL columns as the literal string "NULL", FALSE if you want them returned as the empty string "". You can override this setting at runtime with ifx_nullformat().
Constantes predefinidas
Esta extensión no tiene ninguna constante definida.
- Tabla de contenidos
- ifx_affected_rows -- Obtiene el número de registros procesados por una consulta
- ifx_blobinfile_mode -- Define el modo por defecto para los blob en todas las consultas de selección
- ifx_byteasvarchar -- Define el modo por defecto para los campos de tipo byte
- ifx_close -- Cierra una conexión con Informix
- ifx_connect -- Abrir una conexión con un servidor Informix
- ifx_copy_blob -- Duplica el objeto blob dado
- ifx_create_blob -- Crea un objeto blob
- ifx_create_char -- Crea un objeto char
- ifx_do -- Ejecuta una sentencia SQL preparada previamente
- ifx_error -- Devuelve el código de error de la última llamada a Informix
- ifx_errormsg -- Devuelve el mensaje de error de la última llamada a Informix
- ifx_fetch_row -- Obtiene registros como un array (vector) enumerado
- ifx_fieldproperties -- Indica las propiedades de los campos de una consulta SQL
- ifx_fieldtypes -- Obtiene los campos de una consulta SQL
- ifx_free_blob -- Borra el objeto blob
- ifx_free_char -- Elimina un objeto char
- ifx_free_result -- Libera los recursos de una consulta
- ifx_get_blob -- Obtiene el contenido de un objeto blob
- ifx_get_char -- Obtiene el contenido de un objeto char
- ifx_getsqlca -- Después de una consulta, obtiene el contenido de sqlca.sqlerrd[0..5]
- ifx_htmltbl_result -- Muestra todos los registros de una consulta en una tabla HTML
- ifx_nullformat -- Define el valor por defecto cuando se leen valores nulos
- ifx_num_fields -- Devuelve el número de columnas en una consulta
- ifx_num_rows -- Cuenta los registros ya leídos de una consulta
- ifx_pconnect -- Abre una conexión permanente con Informix
- ifx_prepare -- Preparar una sentencia-SQL para su ejecución
- ifx_query -- Enviar una consulta Informix
- ifx_textasvarchar -- Define el modo por defecto para los campos de tipo text
- ifx_update_blob -- Actualiza el contenido de un objeto blob
- ifx_update_char -- Actualiza el contenido de un objeto char
- ifxus_close_slob -- Cierra un objeto slob
- ifxus_create_slob -- Crea un objeto slob y lo abre
- ifxus_free_slob -- Elimina un objeto slob
- ifxus_open_slob -- Abre un objeto slob
- ifxus_read_slob -- Lee un número de bytes (nbytes) de un objeto slob
- ifxus_seek_slob -- Establece la posición de archivo o búsqueda actual
- ifxus_tell_slob -- Devuelve la posición de archivo o búsqueda actual
- ifxus_write_slob -- Escribe una cadena en un objeto slob
One very frustrating experience with interfacing
Informix and unixODBC (on RHEL4 - PHP 5.20)
was the constant Informix error:
[SQLSTATE=IX 001 SQLCODE=-1829]
Unable to load locale categories
& the non existant handles from unixODBC calls.
This is an issue of the environment being set correctly
which I thought was - phpinfo() reported that the apache
environment was correct <_server=> I even went as far as
to Put/Setenv in httpd.conf.
The hint is in the php 'environment' block
- it did not contain the env strings.
The fix was to insert the environment strings in the httpd
start-up script (/etc/init.d/httpd) which pushed the
environment correctly when the server starts up.
Hope to save someone else the hours....
Installation on RedHat Fedore Core (or in that matter any Linux OS which has a version of glibc of 2.3.* ~or above~) will need to have the latest Informix CSDK (downloadable from IBM). 2.90.UC1.LINUX at the time of this post.
http://www-306.ibm.com/software/data/informix/tools/connect/
I was unable to make PHP with v2.80 of the csdk (as it complained about mktemp being dangerous and how ctype was undefined. After downloading csdk 2.90, I was able to make PHP with no problems at all. (--with-informix).
There goes 2 days of my life!
Feel free to drop me an email at ian_at_devtonic_dot_com if you have any questions.
I just wrote a mini-HOWTO about adding Informix support to mod_php running on a Gentoo Linux server (x86). I wanted to post it here but it was too long. You can find it on http://forums.gentoo.org/viewtopic.php?t=245249 (just in case for some reason they change the thread number, the title is "HOWTO: PHP Informix client support").
add the following to /etc/profile (right before unset i (adjust to your needs)
export INFORMIXDIR=/opt/informix
export ODBCINI=/usr/local/etc/odbc.ini
export INFORMIXSERVER=m_srv
then add the following to your httpd.conf
PassEnv INFORMIXDIR
PassEnv ODBCINI
PassEnv INFORMIXSERVER
(or you can use SetEnv SetEnv INFORMIXDIR /opt/informix etc.)
I upgraded to csdk-2.70.UC3-1 and got the following error when trying to start apache:
Syntax error on line 205 of /usr/local/apache/conf/httpd.conf:
Cannot load /usr/local/apache/libexec/libphp4.so into server: /opt/informix/lib/esql/libifgen.so: undefined symbol: stat
/usr/local/apache/bin/apachectl start: httpd could not be started
This machine has glibc 2.3.5
The following fixed the problem for me (surely there's a better fix) but i'm not sure how it might affect other programs linked to libifgen
mkdir /tmp/ifx
cd /tmp/ifx
ar x $INFORMIXDIR/lib/esql/libifgen.a
gcc -shared -o libifgen.so *.o
cp libifgen.so $INFORMIXDIR/lib/esql
I have compile php-4.0.6 with informix support (dynamic) and when I try to
start apache, it gives me this error message:
Syntax error on line 246 of /etc/httpd/httpd.conf:
Cannot load /usr/lib/apache/libphp4.so into server: /home/informix7/lib/esql/lib
ifgen.so: undefined symbol: stat
/usr/sbin/apachectl start: httpd could not be started
If you are tring to access an Informix Online 5.x server over the
network (ie from a webserver) using PHP, be aware that Online
doesn't support network communications as standard unlike later versions.
You need the Informix product 'I-Star' on your Online server.
This will allow your webserver with the informix client SDK
installed to communicate natively (ESQL).
Thanks go to Mario @ PRS for this info.
An intermittent SQL error -25580 is caused by using the wrong glibc version in Linux.
I have this working correctly in Linux (x86) with Informix Client SDK for 2.70UC-1 for Linux, with glibc 2.1.3.
Originally I had glibc 2.1.1 (Red Hat 6), which gave the intermittent error, but upgrading glibc fixed it.
The Informix Client SDKs can be downloaded from www.informix.com (you need to own an Informix database to log on), and glibc is at ftp://ftp.gnu.org/gnu/glibc .
There's also a FreeBSD version of the client libraries that'll work with PHP. It's not available for download from their website, but you can request a copy (cd or electronic delivery) by calling Informix Customer Support at 1-800-274-8184 option 3.
Some customer service reps know more about alternative operating systems than others, so you may have to do a bit of educating before they can locate the product in their database, but it's definitely there.
My e-mail confirmation referred to it as "Orderable Part Number 100-15871-204057-1", although that number may be specific to the electronically-delivered edition.
Verify with phpinfo() that you have informix module compiled in php.
Also verify that env vars INFORMIXDIR, INFORMIXSERVER, LD_LIBRARY_PATH are set, and that PATH have a route to your informix subdir.
