ingres_connect

(PHP 4 >= 4.0.2, PHP 5 <= 5.0.5, PECL ingres >= 1.0.0)

ingres_connectOuvre 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