Manuel PHP - ingres_connect - Ouvre une connexion sur un serveur Ingres

Description

resource ingres_connect ([ string $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().

Liste de paramètres

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 INGRES_STRUCTURE_HASH INGRES_STRUCTURE_HEAP INGRES_STRUCTURE_ISAM INGRES_STRUCTURE_CBTREE INGRES_STRUCTURE_CISAM INGRES_STRUCTURE_CHASH INGRES_STRUCTURE_CHEAP	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_CBTREE INGRES_STRUCTURE_CISAM INGRES_STRUCTURE_CHASH INGRES_STRUCTURE_BTREE INGRES_STRUCTURE_HASH INGRES_STRUCTURE_ISAM	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_DMY INGRES_DATE_FINISH INGRES_DATE_GERMAN INGRES_DATE_ISO INGRES_DATE_ISO4 INGRES_DATE_MDY INGRES_DATE_MULTINATIONAL INGRES_DATE_MULTINATIONAL4 INGRES_DATE_YMD INGRES_DATE_US	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_LEADING INGRES_MONEY_TRAILING	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

Valeurs de retour

Retourne une ressource Ingres en cas de succès, ou FALSE si une erreur survient.

Exemples

Exemple #1 Exemple avec ingres_connect()

<?php
$link = ingres_connect("mydb", "user", "pass")
	or die("Connexion impossible");
echo "Connexion réussie";
ingres_close($link);
?>

Voir aussi

ingres_pconnect() - Ouvre une connexion persistante à un serveur Ingres
ingres_close() - Ferme une connexion à un serveur Ingres