Microsoft SQL Server Funktionen
Einführung
Diese Funktionen ermöglichen Ihnen den Zugriff auf den MS SQL-Datenbankserver.
Anforderungen
Voraussetzungen für Win32-Plattformen.
Für die Erweiterung müssen die MS SQL Client Tools auf dem System installiert sein auf dem PHP installiert ist. Die Client Tools können entweder von der MS SQL Server-CD oder durch kopieren der ntwdblib.dll von \winnt\system32 auf dem Server nach \winnt\system32 auf dem PHP-Rechner installiert werden. Mit dem Kopieren der ntwdblib.dll wird nur der Zugriff durch benannte Pipes (named pipes) unterstützt. Für die Konfiguration des Clients ist eine Installation aller Tools nötig.
Voraussetzungen für Unix/Linux-Plattformen.
Um die MSSQL-Erweiterung unter Unix/Linux nutzen zu können, müssen Sie zuerst die FreeTDS-Bibliothek übersetzen und installieren. Quellcode und Installationsanleitung stehen auf der FreeTDS-Homepage zur Verfügung: » https://www.freetds.org/
Hinweis: Unter Windows wird die DBLIB von Microsoft verwendet. Funktionen, die einen Feldnamen zurückgeben, basieren auf der DBLIB-Funktion dbcolname(). DBLIB wurde für den SQL Server 6.x entwickelt, bei dem die maximale Länge der Bezeichner bei 30 liegt. Aus diesem Grund ist die Länge von Feldern auf maximal 30 Zeichen begrenzt. Auf Plattformen, auf denen FreeTDS verwendet wird (Linux) gibt es dieses Problem nicht.
Installation
Die MSSQL-Erweiterung wird durch den Eintrag extension=php_mssql.dll in die php.ini aktiviert.
Damit diese Funktionen zur Verfügung stehen, müssen Sie PHP mit --with-mssql[=DIR] übersetzen, wobei DIR der Präfix der FreeTDS-Installation ist. Und FreeTDS muss mit --enable-msdblib übersetzt werden.
Laufzeit Konfiguration
Das Verhalten dieser Funktionen wird durch Einstellungen in der php.ini beeinflusst.
| Bezeichnung | Grundeinstellung | Änderbar | Changelog |
|---|---|---|---|
| mssql.allow_persistent | "1" | PHP_INI_SYSTEM | |
| mssql.max_persistent | "-1" | PHP_INI_SYSTEM | |
| mssql.max_links | "-1" | PHP_INI_SYSTEM | |
| mssql.min_error_severity | "10" | PHP_INI_ALL | |
| mssql.min_message_severity | "10" | PHP_INI_ALL | |
| mssql.compatability_mode | "0" | PHP_INI_ALL | |
| mssql.connect_timeout | "5" | PHP_INI_ALL | |
| mssql.timeout | "60" | PHP_INI_ALL | Seit PHP 4.1.0 verfügbar. |
| mssql.textsize | "-1" | PHP_INI_ALL | |
| mssql.textlimit | "-1" | PHP_INI_ALL | |
| mssql.batchsize | "0" | PHP_INI_ALL | Seit PHP 4.0.4 verfügbar. |
| mssql.datetimeconvert | "1" | PHP_INI_ALL | Seit PHP 4.2.0 verfügbar. |
| mssql.secure_connection | "0" | PHP_INI_SYSTEM | Seit PHP 4.3.0 verfügbar. |
| mssql.max_procs | "-1" | PHP_INI_ALL | Seit PHP 4.3.0 verfügbar. |
Resource Typen
Vordefinierte Konstanten
Folgende Konstanten werden von dieser Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde.
Inhaltsverzeichnis
- mssql_bind — Fügt einer Stored Procedure oder einer Remote Stored Procedure einen Parameter hinzu
- mssql_close — Schließt die Verbindung zum MS SQL Server
- mssql_connect — Baut eine Verbindung zum MS SQL Server auf
- mssql_data_seek — Bewegt den internen Datensatzzeiger
- mssql_execute — Führt eine Stored Procedure in einer MS SQL-Datenbank aus
- mssql_fetch_array — Liefert einen Ergebnis-Datensatz als assoziatives Array, als numerisches Array oder beides
- mssql_fetch_assoc — Liefert ein assoziatives Array des aktuellen Datensatzes aus dem Ergebnis, das durch die Ergebniskennung bestimmt ist
- mssql_fetch_batch — Liefert den nächsten Stapel von Datensätzen
- mssql_fetch_field — Liefert Informationen über ein Feld
- mssql_fetch_object — Liefert einen Datensatz als Objekt
- mssql_fetch_row — Liefert einen Datensatz als indiziertes Array
- mssql_field_length — Liefert die Länge eines Feldes
- mssql_field_name — Liefert den Namen eines Feldes
- mssql_field_seek — Setzt einen Feld-Offset
- mssql_field_type — Liefert den Typ eines Feldes
- mssql_free_result — Gibt den Ergebnisspeicher frei
- mssql_free_statement — Gibt den Anweisungsspeicher frei
- mssql_get_last_message — Gibt die letzte Meldung des Servers zurück
- mssql_guid_string — Wandelt eine 16 byte binary GUID in eine Zeichenkette um
- mssql_init — Initialisiert eine Stored Procedure oder eine Remote Stored Procedure
- mssql_min_error_severity — Setzt die untere Fehlerschwelle
- mssql_min_message_severity — Setzt die untere Schwelle für Meldungen
- mssql_next_result — Bewegt den internen Ergebnis-Zeiger zum nächsten Ergebnis
- mssql_num_fields — Liefert die Anzahl der Felder eines Ergebnisses
- mssql_num_rows — Liefert die Anzahl der Datensätze eines Ergebnisses
- mssql_pconnect — Baut eine persistente MS SQL Verbindung auf
- mssql_query — Sendet eine MS SQL Anfrage
- mssql_result — Liefert die bei einer Abfrage gefundenen Daten
- mssql_rows_affected — Liefert die Anzahl der von einer Anfrage betroffenen Datensätze
- mssql_select_db — Wählt eine MS SQL Datenbank aus