Mit diesen Funktionen können Sie auf einen mSQL-Datenbankserver
zuzugreifen. Mehr Informationen über mSQL findet man bei http://www.hughes.com.au/.
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)
Das Verhalten dieser Funktionen wird
durch Einstellungen in der php.ini beeinflusst.
Tabelle 1. mSQL Konfigurations-Optionen
| 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 | |
For further details and definitions of the
PHP_INI_* constants, see the
Anhang G.
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.
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.
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.
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);
?>
|
|