Installation

Avertissement

Cette extension était obsolète en PHP 5.5.0, et a été supprimée en PHP 7.0.0. À la place, vous pouvez utiliser l'extension MySQLi ou l'extension PDO_MySQL. Voir aussi MySQL : choisir une API du guide. Alternatives à cette fonction :

Pour compiler, utiliser tout simplement l'option de configuration --with-mysql[=DIR] où le paramètre optionnel [DIR] pointe vers le dossier d'installation de MySQL.

Bien que cette extension MySQL soit compatible avec MySQL 4.1.0 et supérieur, elle ne supporte pas les fonctionnalités supplémentaires que cette version fournit. Pour cela, utiliser plutôt l'extension MySQLi.

Pour installer l'extension mysqli en même temps que l'extension mysql, il faut utiliser la même bibliothèque client afin d'éviter les conflits.

Installation sur les systèmes Linux

Note : [DIR] est le chemin vers la bibliothèque cliente MySQL (en-têtes et bibliothèques), qui peut être téléchargée depuis le site de » MySQL.

**Matrice du support d'ext/mysql**
PHP Version	Défaut	Options de configuration : mysqlnd	Options de configuration : `libmysqlclient`	Historique
4.x.x	libmysqlclient	Indisponible	--without-mysql pour désactiver	MySQL est actif par défaut, les bibliothèques clientes MySQL sont incluses en interne
5.0.x, 5.1.x, 5.2.x	libmysqlclient	Indisponible	--with-mysql=[DIR]	MySQL n'est pas actif par défaut, et les bibliothèques clientes MySQL ne sont plus incluses en interne
5.3.x	libmysqlclient	--with-mysql=mysqlnd	--with-mysql=[DIR]	mysqlnd est maintenant disponible
5.4.x	mysqlnd	--with-mysql	--with-mysql=[DIR]	mysqlnd est maintenant incluse par défaut

Installation sur les systèmes Windows

PHP 5.0.x, 5.1.x, 5.2.x

MySQL n'est plus activé par défaut, ainsi, la bibliothèque php_mysql.dll doit être activée dans le php.ini. De plus, PHP doit avoir accès à la bibliothèque cliente MySQL. Un fichier nommé libmysql.dll est inclus dans la distribution de PHP pour Windows et pour que PHP puisse discuter avec MySQL, ce fichier doit être disponible dans le PATH du système Windows. Consulter la FAQ intitulée "Où dois-je ajouter mon répertoire PHP à la variable PATH sous Windows ?" pour plus d'informations sur la réalisation de cela. Néanmoins, le fait de copier le fichier libmysql.dll dans le répertoire système de Windows fonctionne (car le dossier système est par défaut dans le PATH système), mais cela n'est pas du tout recommandé.

Pour activer n'importe quelle extension PHP (comme php_mysql.dll), la directive PHP extension_dir doit être définie et doit pointer vers le dossier où sont stockées les extensions PHP. Consulter également le manuel d'installation sous Windows. Par exemple, voici une valeur possible pour la directive extension_dir en PHP 5 : c:\php\ext

Note: Si lorsqu'on démarre le serveur web une erreur similaire à ceci apparaît : "Unable to load dynamic library './php_mysql.dll'", c'est parce que php_mysql.dll et/ou libmysql.dll n'ont pu être trouvés par le système.

PHP 5.3.0+

Le driver MySQL natif est activé par défaut. Incluez php_mysql.dll, mais libmysql.dll n'est plus nécessaire, ni utilisé.

Notes sur l'installation de MySQL

Avertissement

Des crashes et des problèmes de démarrage de PHP peuvent être rencontrés lorsqu'on charge cette fonction en même temps que l'extension recode. Voir l'extension recode pour plus de détails.

Note: Si on a besoin d'autres jeux de caractères que celui par défaut (latin), il faut installer la bibliothèque externe libmysqlclient (non fournie), compilée avec ce jeu de caractères.