Manuel PHP
Précédent |  | Suivant

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