Manuel PHP
Précédent |  | Suivant

# XCIII. 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

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 |

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.

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

Précédent | Sommaire | Suivant
msession_unlock | Niveau supérieur | msql_affected_rows