Ces fonctions vous permettent d'accéder aux bases de données mSQL. Plus d'informations sur mSQL à » http://www.hughes.com.au/ .
Pour cela, vous devez compiler PHP avec le support msql, en utilisant l'option de configuration --with-msql[=DIR] . Par défaut, le chemin DIR est /usr/local/msql3 .
Note aux utilisateurs Win32: Afin de faire fonctionner cette extension, quelques bibliothèques DLL doivent être disponibles via le PATH du système Windows. Lisez la FAQ intitulée "Comment ajouter mon dossier PHP à mon PATH WIndows " pour plus d'informations. Le fait de copier les bibliothèques DLL depuis le dossier PHP dans le dossier système Windows fonctionne également (car le dossier système est par défaut dans le PATH système), mais cette méthode n'est pas recommandée. Cette extension nécessite que les fichiers suivants se trouvent dans le PATH : msql.dll
Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini .
Tableau 174. Options de configuration
| Nom | Par défaut | Modifiable | Historique |
|---|---|---|---|
| msql.allow_persistent | "1" | PHP_INI_ALL | |
| msql.max_persistent | "-1" | PHP_INI_ALL | |
| msql.max_links | "-1" | PHP_INI_ALL |
Voici un éclaircissement sur l'utilisation des directives de configuration.
Il y a deux types de ressources utilisées dans le module mSQL. Le premier est le lien identifiant la connexion de la base de données, le second, représente le résultat d'une requête.
Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.
Cet exemple simple vous présente comment vous connecter à une base mSQL pour y lire quelques lignes.
Exemple 1531. Exemple d'utilisation avec mSQL
<?php
/* Connexion à la base, sélection de la base de données */
$link
=
msql_connect
(
'localhost'
,
'username'
,
'password'
)
or die(
'Could not connect : '
.
msql_error
(
$link
));
msql_select_db
(
'database'
,
$link
)
or die(
'Could not select database'
);
/* Soumission de la requête */
$query
=
'SELECT * FROM my_table'
;
$result
=
msql_query
(
$query
,
$link
) or die(
'Query failed : '
.
msql_error
(
$link
));
/* Affichage des résultats */
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"
;
/* Libération des résultats */
msql_free_result
(
$result
);
/* Déconnexion */
msql_close
(
$link
);
?>