LXXVI. mSQL

Introduction

Ces fonctions vous permettent d'accéder aux bases de données mSQL. Plus d'informations sur mSQL à http://www.hughes.com.au/.

Installation

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

Configuration à l'exécution

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

Tableau 1. Options de configuration

NomPar défautModifiable
msql.allow_persistent"On"PHP_INI_SYSTEM
msql.max_persistent"-1"PHP_INI_SYSTEM
msql.max_links"-1"PHP_INI_SYSTEM
Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à ini_set().

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.

Types de ressources

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.

Constantes pré-définies

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)

Exemples

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

Exemple 1. 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);
?>

Table des matières
msql_affected_rows -- Retourne le nombre de lignes affectées
msql_close -- Ferme une connexion mSQL
msql_connect -- Ouvre une connexion mSQL
msql_create_db -- Crée une base de données mSQL
msql_createdb -- Alias de msql_create_db()
msql_data_seek -- Déplace le pointeur interne mSQL
msql_db_query -- Soumet une requête mSQL
msql_dbname -- Lit le nom de la base de données courante
msql_drop_db -- Efface une base de données mSQL
msql_error -- Retourne le message d'erreur mSQL
msql_fetch_array -- Lit une ligne sous la forme d'un tableau
msql_fetch_field -- Lit la valeur d'un champ mSQL
msql_fetch_object -- Lit une ligne sous la forme d'un objet
msql_fetch_row -- Retourne une ligne sous la forme d'un tableau
msql_field_flags -- Lit les options de champ msql
msql_field_len -- Lit la taille du champ mSQL
msql_field_name -- Lit le nom du champ msql
msql_field_seek -- Fixe l'offset d'un champ mSQL
msql_field_table -- Lit le nom de la table du champ msql
msql_field_type -- Lit le type de champ mSQL
msql_fieldflags -- Alias de msql_field_flags()
msql_fieldlen -- Alias de msql_field_len()
msql_fieldname -- Alias demsql_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émoire
msql_list_dbs -- Liste les bases de données mSQL sur un serveur
msql_list_fields -- Liste les champs d'une table
msql_list_tables -- Liste les tables mSQL sur une base de données
msql_num_fields -- Retourne le nombre de champs dans un résultat
msql_num_rows -- Retourne le nombre de lignes dans un résultat
msql_numfields -- Alias de msql_num_fields()
msql_numrows -- Alias de msql_num_rows()
msql_pconnect -- Ouvre une connexion persistante à un serveur mSQL
msql_query -- Envoie une requête mSQL
msql_regcase -- Alias de sql_regcase()
msql_result -- Retourne les données de résultat
msql_select_db -- Sélectionne une base de données mSQL
msql_tablename -- Alias de msql_result()
msql -- Alias de msql_db_query()