ingres_commit
ingres_cursor
Ingres-Funktionen
PHP Manual

# ingres_connect

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

ingres_connect — Öffnet eine Verbindung zu einem Ingres-II-Datenbankserver

### Beschreibung

resource ingres_connect ([ string `$database` [, string `$username` [, string `$password` [, array `$options` ]]]] )

ingres_connect() öffnet eine Verbindung zu der Ingres-Datenbank `database`.

Die Verbindung wird geschlossen, wenn das Skript zuende ist oder wenn die Funktion ingres_close() mit der aktuellen Verbindungskennung aufgerufen wird.

### Parameter-Liste

Wenn einige Parameter fehlen, benutzt ingres_connect() die Werte, die in der php.ini für `ingres.default_database`, `ingres.default_user` und `ingres.default_password` eingetragen sind.

`database`

  Der Name der Datenbank. Dieser muss der Syntax

  [vnode::]dbname[/svr_class] folgen.

`username`

  Der Ingres-Benutzername.

`password`

  Das Passwort zu `username`.

`options`

  ingres_connect()-Optionen

  Name der Option | Typ | Beschreibung | Beispiel
  --- | --- | --- | ---
  date_century_boundary | integer | Der Schwellwert, anhand dessen geprüft wird, ob eine zweistellige Jahreszahl im aktuellen oder im kommenden Jahrhundert liegt. Äquivalent zu II_DATE_CENTURY_BOUNDARY. | 50
  group | string | Die Nummer der Benutzergruppe des Benutzers. Äquivalent zum '-G' Flag. | payroll
  role | string | Die Role-Nummer der Applikation. Falls auch ein Role-Passwort verlangt wird, sollte der Wert als "role/password" angegeben werden.
  effective_user | string | Das Ingres-Benutzerkonto, das der Benutzer verkörpert. Äquivalent zu dem Flag '-u'. | another_user
  dbms_password | string | Das interne Datenbank-Passwort für den Benutzer, der sich mit Ingres verbindet. | s3cr3t

  table_structure

  string

  Die Vorgabewerte für die Struktur neuer Tabellen. Gültige Werte für Tabellenstrukturen sind:
  - 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

  string

  Die Vorgabewerte für die Struktur neuer sekundärer Indexe. Gültige Werte für Indexstrukturen sind:
  - INGRES_STRUCTURE_CBTREE
  - INGRES_STRUCTURE_CISAM
  - INGRES_STRUCTURE_CHASH
  - INGRES_STRUCTURE_BTREE
  - INGRES_STRUCTURE_HASH
  - INGRES_STRUCTURE_ISAM

  INGRES_STRUCTURE_HASH

  login_local

  boolean

  Bestimmt, wie mit Verbindungs-Benutzer-ID und -Passwort verfahren wird, wenn im Verbindungsstring für die Zieldatenbank ein VNODE enthalten ist. Falls diese Option auf TRUE gesetzt wird, werden Benutzer-ID und Passwort für den lokalen Zugriff auf VNODE verwendet und die Zugangsdaten zu VNODE werden zum Verbindungsaufbau zur Datenbank benutzt. Falls die Option auf den Wert FALSE gesetzt wurde, wird mit der Prozess-Benutzer-ID des Benutzers auf VNODE zugegriffen und mit seinen Logindaten für die Verbindung wird, anstelle der VNODE-Login-Daten, eine Verbindung zur Datenbank aufgebaut. Falls der Verbindungsstring keinen VNODE enthält, wird die Option ignoriert. Der Standardwert ist FALSE.

  TRUE

  timezone | string | Bestimmt die Zeitzone der Datenbanksitzung. Falls die Option nicht angegeben wurde, wird der Wert von II_TIMEZONE_NAME benutzt. Falls dort auch nichts definiert ist, wird NA-PACIFIC (GMT-8 mit Sommerzeit) benutzt.

  date_format

  integer

  Bestimmt die erlaubten Ein- und Ausgabeformate für das Datum in Ingres. Falls nichts angegeben ist, werden die Formate von II_DATE_FORMAT benutzt. Falls dort auch nichts definiert wurde, ist US (mm/dd/yy) das Standardformat. Gültige Werte für date_format sind:
  - 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 | string | Das Dezimaltrennzeichen | ","

  money_lort

  integer

  Führendes oder angehängtes Währungssymbol. Gültige Werte für money_lort sind:
  - INGRES_MONEY_LEADING
  - INGRES_MONEY_TRAILING

  INGRES_MONEY_TRAILING

  money_sign | string | Das Währungssymbol, das mit dem Datentyp MONEY benutzt wird. | €
  integer | money_precision | Die Genauigkeit des Datentyps MONEY. | 3
  float4_precision | integer | Die Genauigkeit des Datentyps FLOAT4. | 10
  float8_precision | integer | Die Genauigkeit des Datentyps FLOAT8. | 10
  blob_segment_length | integer | Die Datenmenge in Bytes, die in einem Zugriff aus einem BLOB/CLOB gelesen werden kann. Falls nichts anderes angegeben wurde, ist der Vorgabewert 4096 Bytes. | 8192

### Rückgabewerte

Gibt bei Erfolg eine Ingres-Verbindungskennung zurück oder `FALSE` bei einem Fehler.

### Beispiele

Beispiel #1 ingres_connect()-Beispiel

`<?php
$link = ingres_connect("mydb", "user", "pass")
or die("Konnte nicht verbinden");
echo "Verbindungsaufbau erfolgreich";
ingres_close($link);
?>`

### Siehe auch

- ingres_pconnect() - Öffnet eine persistente Verbindung zu einer Ingres-Datenbank
- ingres_close() - Schließt eine Ingres-II-Datenbankverbindung

ingres_commit
ingres_cursor
Ingres-Funktionen
PHP Manual