Cette extension PECL
n'est pas intégrée à PHP.
Des informations sur l'installation de ces extensions PECL
peuvent être trouvées dans le chapitre du manuel intitulé Installation
des extensions PECL. D'autres informations comme les notes sur les nouvelles
versions, les téléchargements, les sources des fichiers, les informations concernant les mainteneurs
ainsi qu'un CHANGELOG, peuvent être trouvées ici :
http://pecl.php.net/package/ingres.
Pour pouvoir utiliser ces fonctions, vous devez compiler PHP avec
le support Ingres, en utilisant l'option --with-ingres[=DIR] où DIR est le répertoire
d'installation du serveur Ingres (par défaut,
/II/ingres).
Ceci nécessite les fichiers de bibliothèque de l'en-tête d'Open API
qui sont inclus dans Ingres II. Si la variable d'environnement
II_SYSTEM n'est pas correctement initialisée, vous devrez utiliser
--with-ingres=DIR, pour spécifier
le répertoire où a été installé Ingres.
Lorsque cette extension est utilisée avec Apache, si Apache ne
démarre pas et émet l'erreur
"PHP Fatal error: Unable to start ingres_ii module in Unknown on line 0",
assurez-vous que la variable d'environnement II_SYSTEM
est correctement initialisée. Il suffit
souvent d'ajouter "export II_SYSTEM="/home/ingres/II"
dans le script qui démarre Apache, juste avant le lancement de
httpd.
Le comportement de ces fonctions est
affecté par la configuration dans le fichier php.ini.
Tableau 1. Options de configuration
| Nom | Par défaut | Modifiable | Historique |
|---|
| ingres.allow_persistent | "1" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.2. |
| ingres.max_persistent | "-1" | PHP_INI_SYSTEM | |
| ingres.max_links | "-1" | PHP_INI_SYSTEM | Disponible depuis PHP 4.0.2. |
| ingres.default_database | NULL | PHP_INI_ALL | Disponible depuis PHP 4.0.2. |
| ingres.default_user | NULL | PHP_INI_ALL | Disponible depuis PHP 4.0.2. |
| ingres.default_password | NULL | PHP_INI_ALL | Disponible depuis PHP 4.0.2. |
| ingres.report_db_warnings | "1" | PHP_INI_ALL | Disponible depuis la version 1.1.0 de l'extension PECL. |
| ingres.cursor_mode | "0" | PHP_INI_ALL | Disponible depuis la version 1.1.0 de l'extension PECL. |
| ingres.blob_segment_length | "4096" | PHP_INI_ALL | Disponible depuis la version 1.2.0 de l'extension PECL. |
Pour plus de détails sur les constantes PHP_INI_*,
reportez-vous Ã
Annexe G.
Ces constantes sont définies par cette
extension, et ne sont disponibles que si cette extension a été compilée avec
PHP, ou bien chargée au moment de l'exécution.
- INGRES_ASSOC
(entier)
Des colonnes sont retournées dans un tableau ayant comme index le nom des
champs.
- INGRES_NUM
(entier)
Des colonnes sont retournées dans un tableau ayant un index numérique des
champs. L'index commence avec 1, le premier champ dans le résultat.
- INGRES_BOTH
(entier)
Des colonnes sont retournées dans un tableau ayant un index numérique et
un index avec le nom des champs.
- INGRES_EXT_VERSION
(chaîne de caractères)
Spécifie la version de l'extension Ingres. Disponible depuis la version
1.2.0 de l'extension PECL.
- INGRES_API_VERSION
(entier)
Spécifie la version de Ingres OpenAPI de l'extension qui a été bâtie.
Disponible depuis la version 1.2.0 de l'extension PECL.
- INGRES_CURSOR_READONLY
(entier)
Spécifie que les curseurs Ingres doivent être ouverts en mode lecture
seule ('readonly'). Disponible depuis la version 1.2.0 de l'extension
PECL.
- INGRES_CURSOR_UPDATE
(entier)
Spécifie que les curseurs Ingres doivent être ouverts en mode pour mise Ã
jour ('for update'). Disponible depuis la version 1.2.0 de l'extension
PECL.
- INGRES_DATE_MULTINATIONAL
(entier)
Équivalent à la configuration II_DATE_FORMAT de MULTINATIONAL. Disponible
depuis la version 1.2.0 de l'extension PECL.
- INGRES_DATE_MULTINATIONAL4
(entier)
Équivalent à la configuration II_DATE_FORMAT de MULTINATIONAL4.
Disponible depuis la version 1.2.0 de l'extension PECL.
- INGRES_DATE_FINNISH
(entier)
Équivalent à la configuration II_DATE_FORMAT de FINNISH. Disponible
depuis la version 1.2.0 de l'extension PECL.
- INGRES_DATE_ISO
(entier)
Équivalent à la configuration II_DATE_FORMAT de ISO. Disponible depuis la
version 1.2.0 de l'extension PECL.
- INGRES_DATE_ISO4
(entier)
Équivalent à la configuration II_DATE_FORMAT de ISO4. Disponible depuis
la version 1.2.0 de l'extension PECL.
- INGRES_DATE_GERMAN
(entier)
Équivalent à la configuration II_DATE_FORMAT de GERMAN. Disponible depuis
la version 1.2.0 de l'extension PECL.
- INGRES_DATE_MDY
(entier)
Équivalent à la configuration II_DATE_FORMAT de MDY. Disponible depuis la
version 1.2.0 de l'extension PECL.
- INGRES_DATE_DMY
(entier)
Équivalent à la configuration II_DATE_FORMAT de DMY. Disponible depuis la
version 1.2.0 de l'extension PECL.
- INGRES_DATE_YMD
(entier)
Équivalent à la configuration II_DATE_FORMAT de YMD. Disponible depuis la
version 1.2.0 de l'extension PECL.
- INGRES_MONEY_LEADING
(entier)
Spécifie le caractère de devise qui doit être placé au début des valeurs
monétaires. Équivalent à la configuration II_MONEY_FORMAT à 'L:'.
Disponible depuis la version 1.2.0 de l'extension PECL.
- INGRES_MONEY_TRAILING
(entier)
Spécifie le caractère de devise qui doit être placé Ã la fin des valeurs
monétaires. Équivalent à la configuration II_MONEY_FORMAT à 'T:'.
Disponible depuis la version 1.2.0 de l'extension PECL.