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 d’activer ce module dans l’environnement Windows, vous devez copier les bibliothèques “msql.dll” depuis le dossier DLL de PHP/Win32 dans le dossier système SYSTEM32 de votre machine (par exemple : “C:\WINNT\SYSTEM32” ou “C:\WINDOWS\SYSTEM32”).

Le comportement de ces fonctions est affecté par la configuration dans le fichier “php.ini”.

Tableau 1. Options de configuration

Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à Annexe G.

Voici un éclaircissement sur l’utilisation des directives de configuration.

“msql.allow_persistent” bool

Activation ou non des connexions mSQL persistantes.

“msql.max_persistent” entier

Le nombre maximum de connexions mSQL persistantes par processus.

“msql.max_links” entier

Le nombre maximum de connexions mSQL par processus, y compris les connexions persistantes.

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.

“MSQL_ASSOC” (entier)

“MSQL_NUM” (entier)

“MSQL_BOTH” (entier)

Cet exemple simple vous présente comment vous connecter à une base mSQL pour y lire quelques lignes.

<?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);
?>

Table des matières

msql_affected_rows – Retourne le nombre de lignes affectéesmsql_close – Ferme une connexion mSQLmsql_connect – Ouvre une connexion mSQLmsql_create_db – Crée une base de données mSQLmsql_createdb – Alias de msql_create_db()
msql_data_seek – Déplace le pointeur interne mSQLmsql_db_query – Soumet une requête mSQLmsql_dbname – Alias de msql_result()
msql_drop_db – Efface une base de données mSQLmsql_error – Retourne le message d’erreur mSQLmsql_fetch_array – Lit une ligne sous la forme d’un tableaumsql_fetch_field – Lit la valeur d’un champ mSQLmsql_fetch_object – Lit une ligne sous la forme d’un objetmsql_fetch_row – Retourne une ligne sous la forme d’un tableaumsql_field_flags – Lit les options de champ msqlmsql_field_len – Lit la taille du champ mSQLmsql_field_name – Lit le nom du champ msqlmsql_field_seek – Fixe l’offset d’un champ mSQLmsql_field_table – Lit le nom de la table du champ msqlmsql_field_type – Lit le type de champ mSQLmsql_fieldflags – Alias de msql_field_flags()
msql_fieldlen – Alias de msql_field_len()
msql_fieldname – Alias de msql_field_name()
msql_fieldtable – Alias de msql_field_table()
msql_fieldtype – Alias de msql_field_type()
msql_free_result – Libère le résultat de la mémoiremsql_list_dbs – Liste les bases de données mSQL sur un serveurmsql_list_fields – Liste les champs d’une tablemsql_list_tables – Liste les tables mSQL sur une base de donnéesmsql_num_fields – Retourne le nombre de champs dans un résultatmsql_num_rows – Retourne le nombre de lignes dans un résultatmsql_numfields – Alias de msql_num_fields()
msql_numrows – Alias de msql_num_rows()
msql_pconnect – Ouvre une connexion persistante à un serveur mSQLmsql_query – Envoie une requête mSQLmsql_regcase – Alias de sql_regcase()
msql_result – Retourne les données de résultatmsql_select_db – Sélectionne une base de données mSQLmsql_tablename – Alias de msql_result()
msql – Alias de msql_db_query()