Introduction

Ces fonctions vous permettent d'accéder aux bases de données MySQL. Le site officiel de cette base est http://www.mysql.com/.

La documentation de MySQL est disponible à http://dev.mysql.com/doc/.

Pré-requis

Afin de pouvoir les utiliser, vous devez compiler PHP avec le support MySQL.

Installation

En utilisant l'option --with-mysql[=DIR], vous activez le support MySQL en PHP

En PHP 4, l'option --with-mysql est activée par défaut. Pour désactiver ce comportement par défaut, vous devez utiliser l'option --without-mysql. De même, en PHP 4, si vous activez MySQL sans spécifier de chemin jusqu'au dossier d'installation MySQL, PHP va utiliser la bibliothèque cliente fournie dans la distribution PHP. Sous Windows, il n'y a pas de DLL, car MySQL est simplement intégré dans PHP Les utilisateurs qui se servent d'autres applications qui utilisent MySQL (par exemple, auth-mysql) ne doivent pas utiliser la bibliothèque intégrée, mais plutôt spécifier --with-mysql=/path/to/mysql. Cela va forcer PHP à utiliser les bibliothèques clientes installées par MySQL, et évitera les conflits.

En PHP 5, MySQL n'est plus activé par défaut, et la bibliothèque MySQL n'est plus fournie avec PHP. Lisez la FAQ pour savoir pourquoi.

Pour la compilation, utilisez simplement l'option --with-mysql=[DIR] où [DIR] est défini.

Cette extension MySQL ne fonctionnera pas avec les versions de MySQL supérieures à la version 4.1.0. Pour cela, il faut utiliser l'extension MySQLi.

Si vous voulez installer l'extension mysqli en même temps que l'extension mysql, vous devez utiliser la même bibliothèque client, pour éviter les conflits.

Configuration à l'exécution

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

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

Types de ressources

Il y a deux types de ressources utilisées par le module MySQL. Le premier est un identifiant de connexion au serveur, appelé mysql link, et le second est un identifiant de résultat de requête, appelé mysql result.

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.

Depuis PHP 4.3.0, il est possible de spécifier des options de client supplémentaires pour les fonctions mysql_connect() et mysql_pconnect(). Ces constantes sont les suivantes :

La fonction mysql_fetch_array() utilise une constante pour spécifier les différents types de formats de réponse. Les constantes suivantes sont utilisées :

Exemples

Cet exemple simple montre comment se connecter, exécuter une requête, lire les informations obtenues et se déconnecter d'une base de données MySQL.

Exemple 1. Exemple de présentation de l'extension MySQL <?php // Connexion et sélection de la base $link = mysql_connect("mysql_hote", "mysql_utilisateur", "mysql_mot_de_passe")     or die("Impossible de se connecter"); echo "Connexion réussie"; mysql_select_db("my_database") or die("Could not select database"); // Exécuter des requêtes SQL $query = "SELECT * FROM my_table"; $result = mysql_query($query) or die("Query failed"); // Afficher des résultats en HTML echo "<table>\n"; while ($line = mysql_fetch_assoc($result)) {     echo "\t<tr>\n";     foreach ($line as $col_value) {         echo "\t\t<td>$col_value</td>\n";     }     echo "\t</tr>\n"; } echo "</table>\n"; // Libération des résultats mysql_free_result($result); // Fermeture de la connexion mysql_close($link); ?>