LXXIX. 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 1. mSQL Konfigurations-Optionen

NameVorgabewertÄnderbarChangelog
msql.allow_persistent"On"PHP_INI_SYSTEM 
msql.max_persistent"-1"PHP_INI_SYSTEM 
msql.max_links"-1"PHP_INI_SYSTEM 
For further details and definitions of the PHP_INI_* constants, see the Anhang H.

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 1. 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()

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 17:57:25