ingres_commit
ingres_cursor
Fonctions Ingres II
PHP Manual

# ingres_connect

(PHP 4 >= 4.0.2, PHP 5 <= 5.0.5, PECL ingres:1.0-1.4.3)

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().

Toutes les autres fonctions Ingres utilisent le dernier lien ouvert comme lien par défaut, il n'est donc nécessaire de conserver la valeur de retour qu'en cas d'utilisation de plus d'un lien en même temps.

### 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 | Description
  --- | ---
  date_century_boundary | 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.
  group | Spécifie d'identifiant de groupe de l'utilisateur. Équivaut au drapeau "-G"
  role | 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 | Le compte utilisateur ingres à personnifier. Équivalent au drapeau "-u"
  dbms_password | Le mot de passe interne de la base de données pour l'utilisateur se connectant à Ingres

  table_structure

  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

  index_structure

  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

  login_local

  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`.

  timezone | 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

  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

  decimal_separator | Le caractère utilisé comme séparateur des décimales

  money_lort

  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

  money_sign | Le symbole à utiliser avec le type de données MONEY
  money_precision | La précision pour le type de données MONEY
  float4_precision | La précision pour le type de données FLOAT4
  float8_precision | La précision pour le type de données FLOAT8
  blob_segment_length | 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.

### 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);
?>`

Exemple #2 Exemple avec ingres_connect() en utilisant le lien par défaut

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

### Voir aussi

- ingres_pconnect()
- ingres_close()

ingres_commit
ingres_cursor
Fonctions Ingres II
PHP Manual