(PHP 4 >= 4.0.2, PHP 5 <= 5.0.5, PECL ingres >= 1.0.0)
ingres_connect — Ouvre une connexion sur un serveur Ingres
$database
[, string $username
[, string $password
[, array $options
]]]] )
ingres_connect() ouvre une connexion
avec la base de données database.
La connexion est fermée lorsque le script se termine ou en cas d'appel à ingres_close().
Si certains paramètres sont manquants,
ingres_connect() utilise les valeurs de
ingres.default_database,
ingres.default_user et
ingres.default_password indiquées dans
php.ini.
database
Le nom de la base de données.
Doit suivre la syntaxe : [node_id::]dbname[/svr_class].
username
Le nom d'utilisateur Ingres
password
Le mot de passe associé avec l'utilisateur
username
options
Options d' ingres_connect()
| Nom de l'option | Option type | Description | Exemple |
|---|---|---|---|
| date_century_boundary | entier | Le seuil pour lequel une année sur 2 chiffres est déterminée pour être dans le siècle courant ou dans le siècle prochain. Identique à II_DATE_CENTURY_BOUNDARY. | 50 |
| group | chaîne de caractères | Spécifie d'identifiant de groupe de l'utilisateur. Équivaut à l'option "-G" | payroll |
| role | chaîne de caractères | L'identifiant du rôle de l'application. Si un mot de passe de rôle est nécessaire, la valeur du paramètre devra être spécifiée sous la forme "rôle/mot de passe" | |
| effective_user | chaîne de caractères | Le compte utilisateur Ingres à personnifier. Équivalent à l'option "-u" | un_autre_utilisateur |
| dbms_password | chaîne de caractères | Le mot de passe interne de la base de données pour l'utilisateur se connectant à Ingres | s3cr3t |
| table_structure | chaîne de caractères |
La structure par défaut pour les nouvelles tables. Les valeurs valides pour table_structure sont :
|
INGRES_STRUCTURE_BTREE |
| index_structure | chaîne de caractères |
La structure par défaut pour les indexes secondaires. Les valeurs valides pour index_structure sont :
|
INGRES_STRUCTURE_HASH |
| login_local | booléen |
Détermine la façon dont sont traités l'identifiant de l'utilisateur
et le mot de passe lorsqu'un VNODE est inclus dans la chaîne cible de la
base de données. Si définit à TRUE, l'identifiant de l'utilisateur et le mot
de passe sont utilisés pour accéder localement au VNODE et les informations
d'identification du VNODE sont utilisées pour établir la connexion DBMS.
Si définit à FALSE, l'identifiant du processus utilisateur est utilisé pour
accéder au VNODE et l'identifiant de l'utilisateur pour la connexion et le mot
de passe sont utilisés à la place des informations d'identification VNODE
pour établir la connexion DBMS. Ce paramètre est ignoré si aucun VNODE n'est
inclus dans la chaîne cible de la base de données. Par défaut, ce paramètre vaut
FALSE.
|
TRUE |
| timezone | chaîne de caractères | Contrôle le fuseau horaire de la session. Si aucun n'est défini, ce paramètre vaudra la valeur définie par la constante II_TIMEZONE_NAME. Si la constante II_TIMEZONE_NAME n'est pas définie, la valeur NA-PACIFIC (GMT-8) sera utilisée. | |
| date_format | entier |
Définit les formats d'entrée et de sortie autorisées pour les dates Ingres. Par défaut, la valeur est définie par la constante II_DATE_FORMAT. Si la constante II_DATE_FORMAT n'est pas définie, le format par défaut de la date sera US, e.g. mm/dd/yy. Les valeurs valides pour date_format sont :
|
INGRES_DATE_MULTINATIONAL4 |
| decimal_separator | chaîne de caractères | Le caractère utilisé comme séparateur des décimales | "," |
| money_lort | entier |
Si le signe pour la monnaie doit se trouver avant ou après la valeur. Les valeurs valides pour money_lort sont :
|
INGRES_MONEY_TRAILING |
| money_sign | chaîne de caractères | Le symbole à utiliser avec le type de données MONEY | € |
| money_precision | entier | La précision pour le type de données MONEY | 3 |
| float4_precision | entier | La précision pour le type de données FLOAT4 | 10 |
| float8_precision | entier | La précision pour le type de données FLOAT8 | 10 |
| blob_segment_length | entier | La quantité de données à récupérer en une fois lorsque l'on récupère des données de type BLOB/CLOB. Par défaut, ce paramètre vaut 4096 octets. | 8192 |
Retourne une ressource Ingres en cas de succès, ou FALSE si une erreur survient.
Exemple #1 Exemple avec ingres_connect()
<?php
$link = ingres_connect("mydb", "user", "pass")
or die("Connexion impossible");
echo "Connexion réussie";
ingres_close($link);
?>