Einführung

Der Informix-Treiber für Informix (IDS) 7.x, SE 7.x, Universal Server (IUS) 9.x und IDS 2000 ist in "ifx.ec" und "php3_ifx.h" im Verzeichnis der Informix Erweiterung implementiert. Die Unterstützung für IDS 7.x ist mit der vollen Unterstützung für TEXT- und BYTE-Felder ziemlich vollständig. Die Unterstützung von IUS 9.x ist nur teilweise fertig: die neuen Datentypen gibt es zwar, aber die Unterstützung von SLOB- und CLOB-Datentypen ist noch in Arbeit.

Anforderungen

Bemerkungen zur Konfiguration: Sie brauchen ESQL/C, um den PHP Informix-Treiber zu kompilieren. ESQL/C Versionen ab 7.2x sollten genügen. ESQL/C ist jetzt Teil des Informix Client SDK.

Versichern Sie sich, dass die Variable "INFORMIXDIR" gesetzt ist und dass Sie $INFORMIXDIR/bin in Ihren Pfad eingebunden haben, bevor Sie das "configure" Skript aufrufen.

Installation

Um die Funktionen dieses Moduls benutzen zu können, müssen Sie Ihren PHP-Interpreter mit der Option --with-informix[=DIR] kompilieren. DIR ist das Basis-Installationsverzeichnis von Informix, das in der Standardeistellung leer ist.

Laufzeit Konfiguration

Das Verhalten dieser Funktionen wird durch Einstellungen in der php.ini beeinflusst.

Anmerkung: Die Umgebungsvariablen INFORMIXDIR und INFORMIXSERVER müssen für den PHP-Treiber verfügbar sein und das INFORMIX bin-Verzeichnis muss im Pfad enthalten sein. Prüfen Sie diese Voraussetzungen mit einem Skript, das einen Aufruf von phpinfo() enthält, bevor Sie testen. Die Ausgabe von phpinfo() sollte diese Umgebungsvariablen auflisten. Dies ist sowohl für CGI PHP als auch Apache mod_php TRUE. Möglicherweise müssen Sie diese Umgebungsvariablen in Ihrem Apache Startskript setzen.

Die Informix shared libraries sollten für den Lader ebenfalls verfügbar sein (überprüfen Sie den LD_LIBRARY_PATH oder ld.so.conf/ldconfig).

Einige Anmerkungen zum Gebrauch von BLOBs (TEXT- und BYTE Felder) : BLOBs werden normalerweise durch blob-Identifikatoren adressiert. Select Abfragen geben eine "blob-ID" für alle TEXT- und BYTE-Felder zurück. Sie können die Inhalte mit "string_var = ifx_get_blob($blob_id);" auslesen, falls Sie die BLOBS in den Speicher schreiben möchten (mit "ifx_blobinfile(0);"). Wenn Sie die Inhalte von BLOB-Felder lieber in eine Datei ausgeben möchten, benutzen Sie "ifx_blobinfile(1);" und mit "ifx_get_blob($blob_id);" ermitteln Sie den Dateinamen. Mit den normalen I/O-Routinen des Dateisystems erhalten Sie die Inhalte von BLOBs.

Bei insert/update Abfragen müssen Sie diese "blob-ID's" mit der Funktion ifx_create_blob() selber erzeugen. Danach schreiben Sie die blob-ID's in ein Array und ersetzen die BLOB-Felder durch ein Fragezeichen (?) im Abfragestring. Für die Inhalte der BLOBs, die mit der Funktion ifx_update_blob() gesetzt werden, sind Sie bei updates/inserts selber verantwortlich.

Das Verhalten einer BLOB-Spalte kann auch zur Laufzeit durch Konfigurationsvariablen verändert werden.

Konfigurationsvariable: ifx.textasvarchar

Konfigurationsvariable: ifx.byteasvarchar

Laufzeitfunktionen:

ifx_textasvarchar(0): benutzt bei SELECT Abfragen von TEXT-Feldern die blob-ID

ifx_byteasvarchar(0): benutzt bei SELECT Abfragen von BYTE-Feldern die blob-ID

ifx_textasvarchar(1): gibt TEXT-Felder so zurück, als wären es VARCHAR Felder, so dass Sie keine blob-ID für select Abfragen brauchen.

ifx_byteasvarchar(1): gibt BYTE-Felder so zurück, als wären es VARCHAR Felder, so dass Sie keine blob-ID für select Abfragen brauchen.

Konfigurationsvariable: ifx.blobinfile

Laufzeitfunktionen:

ifx_blobinfile_mode(0): gibt BYTE-Felder in den Speicher zurück, mit der blob-ID können Sie auf den Inhalt zugreifen.

ifx_blobinfile_mode(1): gibt BYTE-Felder in einer Datei zurück, mit der blob-ID können Sie den Dateinamen ermitteln.

Wenn Sie ifx_text/byteasvarchar auf 1 setzen, können Sie TEXT- und BYTE-Felder in select Abfragen genauso benutzen, wie normale (allerdings sehr lange) VARCHAR-Felder. Da alle Zeichenketten in PHP "gezählt" werden, bleibt dies "binary safe". Es bleibt Ihnen überlassen, korrekt damit umzugehen. Die zurückgegebenen Daten können alles mögliche enthalten, so dass Sie für die Inhalte verantwortlich sind.

Wenn Sie ifx_blobinfile auf 1 setzen, benutzen Sie den Dateinamen, der von ifx_get_blob(..) zurückgegeben wird, um auf den Inhalt des BLOB zuzugreifen. Beachten Sie, dass Sie in diesem Fall FÜR DAS LÖSCHEN DER TEMPORÄREN DATEIEN, DIE VON INFORMIX ERSTELLT WERDEN VERANTWORTLLICH SIND, wenn sie ein Tupel auslesen. Jedes neue Tupel, das gelesen wird, erzeugt für jedes BYTE-Feld eine neue temporäre Datei.

Der Speicherort für die temporären Dateien kann mit der Umgebungsvariablen "blobdir" beeinflusst werden, die Standardeinstellung ist "." (das aktuelle Verzeichnis). Etwas Ähnliches wie : putenv(blobdir=tmpblob"); erleichtert das Bereinigen der temporären Dateien, die versehentlich stehen geblieben sind (ihre Namen beginnen alle mit "blb").

Automatisches Abschneiden von Leerzeichen bei "char" (SQLCHAR und SQLNCHAR) Daten : Dies kann mit einer Konfigurationsvariablen eingestellt werden.

ifx.charasvarchar : falls auf 1 gesetzt, werden abschliessende Leerzeichen automatisch abgeschnitten. Dies erspart den Aufruf der chop() Funktion.

NULL-Werte: Wenn die Konfigurationsvariable ifx.nullformat (und die Laufzeitfunktion ifx_nullformat()) auf TRUE gesetzt sind, werden NULL-werte in Spalten als Zeichenkette NULL zurückgegeben, wenn die Variable auf FALSE gesetzt ist, werden leere Strings für NULLwerte zurückgegeben. So können sie zwischen NULLwerten und leeren Spalten unterscheiden.

Weitere Details und die Definitionen der PHP_INI_*-Konstanten finden Sie im Anhang G, php.ini Einstellungen.

Hier eine kurze Erklärung der Konfigurationsoptionen:

Resource Typen

Vordefinierte Konstanten

Diese Erweiterung definiert keine Konstanten.

Inhaltsverzeichnis

ifx_affected_rows — Gibt die Anzahl der Datensätze zurück, die von einer Abfrage betroffen sind

ifx_blobinfile_mode — Setzt den Standardmodus für BLOBs bei allen SELECT Abfragen

ifx_byteasvarchar — Setzt den Standard Byte-Modus

ifx_close — Schliesst eine Informix Verbindung

ifx_connect — Öffnet eine Verbindung zu einem Informix Server

ifx_copy_blob — Dupliziert ein gegebenes BLOB (Binary Large Object)

ifx_create_blob — Erzeugt ein BLOB (Binary Large Object)

ifx_create_char — Erzeugt ein Zeichen-Objekt

ifx_do — Führt eine vorbereitete Abfrage aus

ifx_error — Gibt den Fehlercode des letzten Informix Aufrufs zurück

ifx_errormsg — Gibt die Fehlermeldung des zuletzt aufgetretenen Informix Fehlers zurück

ifx_fetch_row — Holt eine Zeile als assoziatives Array

ifx_fieldproperties — Gibt eine Liste mit den Feldeigenschaften zurück

ifx_fieldtypes — Gibt eine Liste der Informix SQL Felder zurück

ifx_free_blob — Löscht ein Blob Objekt

ifx_free_char — Löscht ein CHAR Objekt

ifx_free_result — Gibt den belegten Speicher einer Ergebnismenge wieder frei

ifx_get_blob — Gibt den Inhalt eines Large Objects zurück

ifx_get_char — Gibt den Inhalt eines Zeichen-Objekts zurück

ifx_getsqlca — Gibt den Inhalt von sqlca.sqlerrd[0..5] nach einer Abfrage zurück

ifx_htmltbl_result — Gibt alle Zeilen einer Abfrage als HTML-Tabelle formatiert zurück

ifx_nullformat — Setzt den aktuellen Rückgabewert für Nullwerte beim Lesen von Zeilen

ifx_num_fields — Gibt die Anzahl der Spalten einer Abfrage zurück

ifx_num_rows — Count the rows already fetched from a query

ifx_pconnect — Öffnet eine persistente Informix Verbindung

ifx_prepare — Bereitet eine Abfrage zur späteren Ausführung vor

ifx_query — Schickt eine Informix Abfrage an den Server

ifx_textasvarchar — Setzt den Standard-Textmodus

ifx_update_blob — Aktualisiert den Inhalt eines Blob-Objekts

ifx_update_char — Aktualisiert den Inhalt eines Char-Objekts

ifxus_close_slob — Löscht ein Slob-Objekt

ifxus_create_slob — Erzeugt ein Slob-Objekt und öffnet es

ifxus_free_slob — Löscht ein Slob-Objekt

ifxus_open_slob — Öffnet ein Slob-Objekt

ifxus_read_slob — Liest nbytes aus einem Slob-Objekt

ifxus_seek_slob — Setzt die aktuelle Dateizeiger- oder Suchposition

ifxus_tell_slob — Gibt die aktuelle Dateizeiger- oder Suchposition zurück

ifxus_write_slob — Schreibt einen String in ein Slob-Objekt