&reftitle.setup;
&reftitle.required;
Cette extension nécessite un serveur MySQL 8+ avec le plugin X
activé (par défaut).
Les bibliothèques prérequises pour compiler cette extension sont :
Boost (1.53.0 ou supérieur), OpenSSL et Protobuf.
&reftitle.install;
&pecl.moved;
Un exemple de procédure d'installation sur Ubuntu 18.04 avec PHP 7.2 :
La commande pecl install n'active pas les extensions PHP (par défaut)
et activer les extensions PHP peut se faire de plusieurs manières.
Un autre exemple avec PHP 7.2 sur Ubuntu 18.04 :
/etc/php/7.2/mods-available/mysql_xdevapi.ini
// Utiliser la commande 'phpenmod' (note: spécifique à Debian/Ubuntu)
$ phpenmod -v 7.2 -s ALL mysql_xdevapi
// Une alternative à 'phpenmod' est de créer un lien symbolique manuellement
// $ ln -s /etc/php/7.2/mods-available/mysql_xdevapi.ini /etc/php/7.2/cli/conf.d/20-mysql_xdevapi.ini
// Voyons quelles extensions MySQL sont activées maintenant
$ php -m |grep mysql
mysql_xdevapi
mysqli
mysqlnd
pdo_mysql
]]>
&pecl.info;
&url.pecl.package;mysql_xdevapi.
&reference.mysql-xdevapi.ini;
Compiler à partir des sources
Considérations pour compiler cette extension à partir des sources.
Le nom de l'extension est 'mysql_xdevapi', donc utiliser --enable-mysql-xdevapi.
Boost; requis, utiliser optionnellement l'option de configuration --with-boost=DIR
ou définir la variable d'environnement MYSQL_XDEVAPI_BOOST_ROOT. Seuls les
fichiers d'en-tête boost sont requis; pas les binaires.
Google Protocol Buffers (protobuf): requis, utiliser optionnellement l'option de configuration
--with-protobuf=DIR ou définir la variable d'environnement MYSQL_XDEVAPI_PROTOBUF_ROOT.
Optionnellement utiliser make protobufs pour générer les fichiers protobuf (*.pb.cc/.h),
et make clean-protobufs pour supprimer les fichiers protobuf générés.
Note spécifique à Windows : selon l'environnement, la bibliothèque statique avec
un runtime DLL multi-thread peut être nécessaire.
Pour préparer, utiliser les options suivantes :
-Dprotobuf_MSVC_STATIC_RUNTIME=OFF -Dprotobuf_BUILD_SHARED_LIBS=OFF
Google Protocol Buffers / protoc: requis, il faut s'assurer que le bon
'protoc' est disponible dans le PATH lors de la compilation. C'est particulièrement
important car les scripts batch du SDK PHP Windows peuvent écraser l'environnement.
Bison: requis, et disponible dans le PATH.
Note spécifique à bison Windows: nous recommandons fortement d'utiliser bison
fourni avec le SDK PHP choisi, sinon une erreur similaire à "zend_globals_macros.h(39):
error C2375: 'zendparse': redefinition; different linkage
Zend/zend_language_parser.h(214): note: see declaration of 'zendparse'" peut
être le résultat. De plus, les scripts batch du SDK PHP Windows peuvent écraser l'environnement.
Note spécifique à Windows: pour préparer l'environnement, voir la documentation officielle
de construction Windows pour
le SDK actuel.
Nous recommandons d'utiliser les antislash '\\' au lieu d'un slash '/' pour tous les chemins.