|
|
Manuel PHP |
|
||
|
|
||||
Le pilote d'accès à Informix pour Online (ODS) 7.x, SE 7.x et Universal Server (IUS) 9.x est implémenté dans "functions/ifx.ec" et "functions/php3_ifx.h". Le support ODS 7.x est plutôt complet, et accepte les colonnes de type BYTE et TEXT. Le support IUS 9.x est partiellment fini, de nouveau types sont disponibles, mais SLOB et CLOB sont toujours en developpement.
Notes de configuration:
Avant que vous ne lanciez le script "configure", assurez vous que la variable d'environnement "INFORMIXDIR" a été correctement paramétrée.
Le script de configuration va détecter automatiquement les librairies disponibles, et inclure les dossiers si vous lancer le script avec l'option "configure --with_informix=yes". Vous pouvez ignorer cette détection en spécifiant "IFX_LIBDIR", "IFX_LIBS" et "IFX_INCDIR" dans votre environnement. Le script de configuration va aussi essayer de détecter la version de votre serveur Informix. Il modifiera alors la condition de compilation "HAVE_IFX_IUS" si votre serveur Informix est d'une version plus récente que 9.00.
Notes sur l'utilisation des BLOBs (TEXT et BYTE):
Les objets de type BLOBs sont normalement gérés par des entiers identifiant de BLOB. Les requêtes de selection retournent un identifiant de blob pour chaque colonne de type BYTE et TEXT. Vous pouvez en lire le contenu, avec des commandes de types "string_var = ifx_get_blob($blob_id);" ; si vous souhaitez ramener le BLOBs en memoire (avec: "ifx_blobinfile(0);"). Si vous préférez recevoir le contenu d'une colonne BLOB dans un fichier, utilisez "ifx_blobinfile(1);", et "ifx_get_blob($blob_id);" vous retournera le nom du fichier. Utilisez les fonctions habituelles d'accès aux fichiers pour lire son contenu.
Pour les requêtes insert/update, vous devez créer les identifiantsde blob par vous même, avec la fonction "ifx_create_blob(..);". Puis, vous placez l'identifiant de blob dans un tableau, et remplacez la colonne par un point d'interrogation. Pour les updates/inserts, vous etes responsable du contenu du blob, avec la fonction ifx_update_blob(...).
Le comportement par défaut des colonnes de type BLOB peut être modifié en affectant de nouvelles valeurs aux variables de configuration (même à la volée) :
Variable de configuration : ifx.textasvarchar
Variable de configuration : ifx.byteasvarchar
Fonction à utiliser lors de l'exécution :
ifx_textasvarchar(0) : Utilise l'identifiant de blob avec des colonnes de types TEXT, dans les requêtes SELECT
ifx_byteasvarchar(0) : Utilise l'identifiant de blob avec des colonnes de types BYTE, dans les requêtes SELECT
ifx_textasvarchar(1) : Retourne les colonnes de type TEXT sous la forme de VARCHAR, sans utiliser les identifiants de blob dans les requêtes SELECT.
ifx_byteasvarchar(1) : Retourne les colonnes de type BYTE sous la forme de VARCHAR, sans utiliser les identifiants de blob dans les requêtes SELECT.
configuration variable : ifx.blobinfile
Fonction à utiliser lors de l'exécution :
ifx_blobinfile_mode(0) : Retourne les colonnes de type BYTE en mémoire, l'identifiant de blob vous donnera accès au contenu.
ifx_blobinfile_mode(1) : Retourne les colonnes de type BYTE dans un fichier, l'identifiant de blob vous donnera accès au nom de ce fichier.
En affectant la valeur de 1 à ifx_text/byteasvarchar, vous pouvez utiliser les colonnes de type TEXT et BYTE dans les requêtes SELECT comme des champs VARCHAR (mais plus long). Etant donné la gestion des chaînes par PHP, cette technique conserve les données binaires. Les données retournées peuvent contenir n'importe quoi, et vous êtes responsable de la bonne manipulation de ces valeurs.
En affectant la valeur de 1 à ifx_blobinfile, utilisez le nom de fichier retourné par ifx_get_blob(..) pour accéder au contenu du blob. Notez bien que vous êtes tenu responsable de l'effacement des fichiers temporaires, créés par Informix. Chaque nouvelle ligne lue sur le serveur va créer un nouveau fichier temporaire, pour chaque colonne de type BYTE.
L'emplacement des fichiers temporaire peut être modifié, grâce à la variable "blobdir", (par défaut, ".", c'est à dire, le dossier courant). Une valeur telle que blobdir="tmpblob" simplifiera le nettoyage des fichiers temporaires, accidentellement oubliés (les noms commencent tous par "blb").
Suppression automatique des espaces (SQLCHAR et SQLNCHAR):
Elle peut être mise en place avec la variable de configuration
ifx.charasvarchar : avec la valeur 1, les espaces de fin de champs seront automatiquement supprimés.
NULL:
Lorsque la variable de configuration ifx.nullformat (ou que la fonction ifx_nullformat()) est à un, les colonnes contenant la valeur NULL retourneront la chaîne "NULL", et sinon, retourneront une chaîne vide. Cela vous permet de faire la différence entre les colonnes vides et celle qui contiennent la valeur NULL.
