(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
$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.
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 |
index_structure | string | Die Vorgabewerte für die Struktur neuer sekundärer Indexe. Gültige Werte für Indexstrukturen sind:
|
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_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_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 |
Gibt bei Erfolg eine Ingres-Verbindungskennung zurück oder FALSE
bei einem Fehler.
Beispiel #1 ingres_connect()-Beispiel
<?php
$link = ingres_connect("mydb", "user", "pass")
or die("Konnte nicht verbinden");
echo "Verbindungsaufbau erfolgreich";
ingres_close($link);
?>