[edit] Last updated: Mon, 01 Nov 2010

XCIII. mSQL Funktionen

Einführung

Mit diesen Funktionen können Sie auf einen mSQL-Datenbankserver zuzugreifen. Mehr Informationen über mSQL findet man bei » http://www.hughes.com.au/.

Installation

Damit Sie auf diese Funktionen zugreifen können, müssen Sie PHP mit der Unterstützung für mSQL kompilieren, indem Sie die Option --with-msql[=DIR] angeben. DIR ist das mSQL-Installationsverzeichnis. In der Voreinstellung ist dies /usr/local/msql3.

Anmerkung für Win32-Benutzer: Um dieses Modul unter Windows zu aktivieren, müssen Sie die Datei msql.dll aus dem DLL-Verzeichnis des PHP-Paketes für Windows in das SYSTEM32-Verzeichnis Ihres Rechners kopieren. (Ex: C:\WINNT\SYSTEM32 or C:\WINDOWS\SYSTEM32)

Laufzeit Konfiguration

Das Verhalten dieser Funktionen wird durch Einstellungen in der php.ini beeinflusst.

Tabelle 136. mSQL Konfigurations-Optionen

Name	Vorgabewert	Änderbar
msql.allow_persistent	"On"	PHP_INI_SYSTEM
msql.max_persistent	"-1"	PHP_INI_SYSTEM
msql.max_links	"-1"	PHP_INI_SYSTEM

Weitere Details und die Definitionen der PHP_INI_*-Konstanten finden Sie im Anhang G, php.ini Einstellungen.

Hier eine kurze Erklärung der Konfigurationsoptionen:

msql.allow_persistent boolean: Bestimmt, ob persistente Verbindungen erlaubt sind.
msql.max_persistent integer: Bestimmt die maximale Anzahl persistenter Verbindungen zu mSQL pro Prozess.
msql.max_links integer: Bestimmt die Gesamtzahl der Verbindungen (einschliesslich persistenter Verbindungen) zu mSQL pro Prozess.

Resource Typen

Im mSQL-Modul gibt es zwei Ressource-Typen: Die erste ist eine Verbindungskennung einer Datenbankverbindung und die zweite Ressource ist eine Ergebniskennung für ein Abfrageergebnis.

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.

MSQL_ASSOC (integer)
MSQL_NUM (integer)
MSQL_BOTH (integer)

Beispiele

In diesem einfachen Beispiel wird eine Verbindung zum mSQL Datenbankserver aufgebaut, eine Abfrage ausgeführt, das Abfrageergebnis ausgegeben und die Verbindung wieder geschlossen.

Beispiel 1097. Eine Abfrage ausführen


<?php

/* Verbindungsaufbau zum Datenbankserver */

$link = msql_connect('localhost', 'username', 'password')

    or die('Verbindungsaufbau fehlgeschlagen : ' . msql_error($link));



msql_select_db('database', $link)

    or die('Konnte die Datenbank nicht auswählen');



/* SQL Abfrage senden */

$query = 'SELECT * FROM my_table';

$result = msql_query($query, $link) or die('Abfrage fehlgeschlagen : ' . msql_error($link));



/* Abfrageergebnisse in HTML ausgeben*/

echo "<table>\n";

while ($row = msql_fetch_array($result, MSQL_ASSOC)) {

    echo "\t<tr>\n";

    foreach ($row as $col_value) {

        echo "\t\t<td>$col_value</td>\n";

    }

    echo "\t</tr>\n";

}

echo "</table>\n";



/* Speicher wieder freigeben */

msql_free_result($result);



/* Verbindung schliessen */

msql_close($link);

?>

Inhaltsverzeichnis

msql_affected_rows — Gibt die Anzahl der betroffenen Datensätze zurück
msql_close — Schliesst eine mSQL-Verbindung
msql_connect — Öffnet eine mSQL Verbindung
msql_create_db — Erzeugt eine mSQL Datenbank
msql_createdb — Alias von msql_create_db()
msql_data_seek — Bewegt den internen Datensatzzeiger
msql_db_query — Sendet eine mSQL Abfrage an den Server
msql_dbname — Alias von msql_result()
msql_drop_db — Löscht eine mSQL Datenbank
msql_error — Gibt die letzte mSQL-Fehlermeldung zurück
msql_fetch_array — Holt eine Zeile als Array
msql_fetch_field — Gibt Feldinformationen in einem Objekt zurück
msql_fetch_object — Holt eine Zeile als Objekt
msql_fetch_row — Holt eine Zeile als numerisches Array
msql_field_flags — Gibt alle Flags für das angegebene Feld zurück
msql_field_len — Gibt die Länge des angegebenen Feldes zurück
msql_field_name — Gibt den Feldnamen des bezeichneten Feldes zurück
msql_field_seek — Setzt den internen Feld-Zeiger auf den angegebenen Feldindex
msql_field_table — Gibt den Tabellennamen für ein Feld zurück
msql_field_type — Gibt den Datentyp des angegebenen Feldes zurück
msql_fieldflags — Alias für msql_field_flags()
msql_fieldlen — Alias für msql_field_len()
msql_fieldname — Alias für msql_field_name()
msql_fieldtable — Alias für msql_field_table()
msql_fieldtype — Alias für msql_field_type()
msql_free_result — Gibt den durch Ergebnisse belegten Speicher fre
msql_list_dbs — Listet alle mSQL Datenbanken auf dem Server auf
msql_list_fields — Listet alle Felder einer Tabelle auf
msql_list_tables — Listet alle Tabellen einer mSQL-Datenbank auf
msql_num_fields — Gibt die Anzahl der Felder in einem Abfrageergebnis zurück
msql_num_rows — Gibt die Anzahl der Zeilen in einem Abfrageergebnis zurück
msql_numfields — Alias für msql_num_fields()
msql_numrows — Alias für msql_num_rows()
msql_pconnect — Öffnet eine persistente mSQL Verbindung
msql_query — Schickt eine mSQL-Abfrage zum Server
msql_regcase — Alias für sql_regcase()
msql_result — Holt den Wert eines einzelnen Feldes
msql_select_db — Wählt eine mSQL Datenbank aus
msql_tablename — Alias für msql_result()
msql — Alias für msql_db_query()

add a note User Contributed Notes mSQL Funktionen

acroyear at io dot com 15-May-2000 02:11


To those porting code from w3-msql/lite to php, a few functions are different or missing (aside from the fact that the order of arguments is reversed and the other signatures are different...not good design work, imho, or was it built for msql 1.x?  At any rate, conformity with the C and Lite API should have been maintained.).





The lite/C function msqlStoreResult() is automatically done in msql_query() and msql().  


msql_fetch_field() doesn't give you the field length value (unlike msqlFetchField()).  You have to call msql_fieldlen() to get that.





msqlEncode() is missing.  The functionality (which is needed for pretty much ALL SQL based rdbms's) is in addSlashes() in the String library.

add a note