ingres_connect
(PHP 4 >= 4.0.2, PHP 5 <= 5.0.5, PECL ingres >= 1.0.0)
ingres_connect — Ouvre une connexion sur un serveur Ingres
Description
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