ingres_connect

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

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

Beschreibung

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

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. €
money_precision integer 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. Im Fehlerfall wird FALSE zurückgegeben.

Beispiele

Beispiel #1 Öffnen einer Verbindung zu einer Ingres-Datenbank

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

Siehe auch