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