mSQL Funktionen
Einführung
Mit diesen Funktionen können Sie auf einen mSQL-Datenbankserver zuzugreifen. Mehr Informationen über mSQL findet man bei » https://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.
Hinweis: 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.
| Name | Vorgabewert | Änderbar | Changelog |
|---|---|---|---|
| msql.allow_persistent | "On" | PHP_INI_SYSTEM | |
| msql.max_persistent | "-1" | PHP_INI_SYSTEM | |
| msql.max_links | "-1" | PHP_INI_SYSTEM |
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.
Beispiele
In diesem einfachen Beispiel wird eine Verbindung zum mSQL Datenbankserver aufgebaut, eine Abfrage ausgeführt, das Abfrageergebnis ausgegeben und die Verbindung wieder geschlossen.
Example#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