Manuel PHP
Précédent |  | Suivant

# LXVII. 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
--- | --- | ---
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 integer

  Le nombre maximum de connexions mSQL persistantes par processus.

msql.max_links integer

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

# Types de ressources

Il y a deux types de ressource utilisé dans le modile 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édefinies

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
udm_set_agent_param | Niveau supérieur | msql_affected_rows