Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.

Options de configuration Ingres
Nom Défaut Modifiable Historique
ingres.allow_persistent "1" PHP_INI_SYSTEM Disponible depuis ingres 1.0.0
ingres.array_index_start "1" PHP_INI_ALL Disponible depuis ingres 1.4.0.
ingres.auto "1" PHP_INI_ALL Disponible depuis ingres 2.0.0.
ingres.blob_segment_length "4096" PHP_INI_ALL Disponible depuis ingres 1.2.0.
ingres.cursor_mode "0" PHP_INI_ALL Disponible depuis ingres 1.1.0.
ingres.default_database NULL PHP_INI_ALL Disponible depuis ingres 1.0.0
ingres.default_password NULL PHP_INI_ALL Disponible depuis ingres 1.0.0
ingres.default_user NULL PHP_INI_ALL Disponible depuis ingres 1.0.0
ingres.describe 1 PHP_INI_ALL Disponible depuis ingres 2.1.0
ingres.fetch_buffer_size 100 PHP_INI_ALL Disponible depuis ingres 2.1.0
ingres.max_links "-1" PHP_INI_SYSTEM Disponible depuis ingres 1.0.0
ingres.max_persistent "-1" PHP_INI_SYSTEM Disponible depuis ingres 1.0.0
ingres.reuse_connection "1" PHP_INI_ALL Disponible depuis ingres 2.0.0
ingres.scrollable "1" PHP_INI_ALL Disponible depuis ingres 2.0.0.
ingres.trace "0" PHP_INI_ALL Disponible depuis ingres 2.0.0.
ingres.trace_connect "0" PHP_INI_ALL Disponible depuis ingres 1.2.1.
ingres.utf8 "1" PHP_INI_ALL Disponible depuis ingres 2.0.0.
Pour plus de détails sur les modes PHP_INI_*, reportez-vous à Où une directive de configuration peut être modifiée.

Voici un éclaircissement sur l'utilisation des directives de configuration.

ingres.allow_persistent booléen

Indique s'il faut activer les connexions persistantes à Ingres

ingres.array_index_start entier

Spécifie la valeur de départ pour les clés des entiers des tableaux générés par la fonction ingres_fetch_row() ou par la fonction ingres_fetch_array(). Par défaut, le paramètre ingres.array_index_start est défini à 1. Si vous voulez que l'extension ingres fonctionne de la même façon que les autres extensions de bases de données, définissez ce paramètre à 0.

ingres.auto booléen

Active ou pas l'émulation de l'autocommit. Ingres ne peut pas avoir plusieurs curseurs ouverts simultanément, lorsque l'autocommit est actif. Lorsqu'il est activé, le pilote émule l'autocommit.

ingres.blob_segment_length entier

Spécifie la quantité de mémoire à utiliser lors de la lecture des BLOB, en octets.

ingres.cursor_mode entier

Spécifie le mode par défaut pour les curseurs ouverts avec ingres_prepare(). Les valeurs valides sont INGRES_CURSOR_UPDATE ou INGRES_CURSOR_READONLY.

ingres.default_database chaîne de caractères

Spécifie le nom de la base de données par défaut, lors de la connexion à un serveur, si aucun nom de base n'est fourni. Cela ne s'applique pas au safe mode SQL.

ingres.default_password chaîne de caractères

Spécifie le mot de passe par défaut, lors de la connexion à un serveur, si aucun nom de base n'est fourni. Cela ne s'applique pas au safe mode SQL.

ingres.default_user chaîne de caractères

Spécifie le nom d'utilisateur par défaut, lors de la connexion à un serveur, si aucun nom de base n'est fourni. Cela ne s'applique pas au safe mode SQL.

ingres.describe booléen

Active l'utilisation de DESCRIBE INPUT pour déterminer les types de données pour les requêtes préparées. Disponible depuis Ingres 9.1.0. Lorsque cette directive est désactivée, les requêtes qui reçoivent des paramètres doivent décrire manuellement ces paramètres avec le paramètre types dans la fonction ingres_query().

Note:

En activant cette fonctionnalité, ingres_query() va réaliser plusieurs requêtes supplémentaires entre PHP et le serveur. Pour réduire ce trafic, utilisez ingres_prepare() et ingres_execute().

ingres.fetch_buffer_size entier

Spécifie le nombre de ligne à télécharger lors d'une opération de lecture en groupe par ingres_fetch_array(), ingres_fetch_object() et ingres_fetch_row().

Spécifie le nombre de sessions Ingres allouées par processus ou thread. Le nombre de sessions ne doit pas excéder le nombre maximal de connexions configurées par le serveur Ingres.

ingres.max_persistent entier

Spécifie le nombre maximum de sessions persistantes allouées par processus ou par thread. Le nombre de sessions ne doit pas excéder le nombre de connexions configurées sur le serveur Ingres.

ingres.reuse_connection booléen

Active la réutilisation de connexion si la connexion est tentée sur le même serveur avec le même nom d'utilisateur.

ingres.scrollable booléen

Active le support des curseurs scrollables. Lors de la lecture de données CLOB ou BLOB, cette directive doit être mise à FALSE. Disponible depuis Ingres 9.2.0.

ingres.trace booléen

Active les traces simples de messages E_NOTICE.

ingres.trace_connect booléen

Affiche des messages E_NOTICE durant les appels à ingres_connect() et ingres_pconnect().

ingres.utf8 booléen

Suppose que les chaînes de caractères passées à une colonne de type National Character (NVARCHAR ou NCHAR) utilisent l'encodage UTF-8 et les converti en UTF-16 pour le serveur.