&reftitle.setup;
&reftitle.required;
Für diese Erweiterung wird ein MySQL 8+-Server benötigt, auf dem das
X-Plugin aktiviert ist (Standard).
Folgende Bibliotheken werden benötigt, um diese Erweiterung zu kompilieren:
Boost (1.53.0 oder höher), OpenSSL und Protobuf.
&reftitle.install;
&pecl.moved;
Ein Beispiel für die Installation auf Ubuntu 18.04 mit PHP 7.2:
Der Befehl pecl install aktiviert keine
PHP-Erweiterungen (standardmäßig). Die Aktivierung kann auf verschiedene
Arten erfolgen. Hier ein weiteres Beispiel für PHP 7.2 auf Ubuntu 18.04:
/etc/php/7.2/mods-available/mysql_xdevapi.ini
// Den Befehl 'phpenmod' verwenden (Achtung: ist Debian/Ubuntu-spezifisch)
$ phpenmod -v 7.2 -s ALL mysql_xdevapi
// Alternativ zu 'phpenmod' kann der Symlink auch manuell gesetzt werden
// $ ln -s /etc/php/7.2/mods-available/mysql_xdevapi.ini /etc/php/7.2/cli/conf.d/20-mysql_xdevapi.ini
// Schauen wir uns an, welche MySQL-Erweiterungen nun aktiviert sind
$ php -m |grep mysql
mysql_xdevapi
mysqli
mysqlnd
pdo_mysql
]]>
&pecl.info;
&url.pecl.package;mysql_xdevapi.
&reference.mysql-xdevapi.ini;
Erstellen/Kompilieren aus dem Quellcode
Hinweise zum Kompilieren dieser Erweiterung aus dem Quellcode:
Der Name der Erweiterung ist 'mysql_xdevapi', also muss
--enable-mysql-xdevapi verwendet werden.
Boost: erforderlich; verwenden Sie wahlweise die Konfigurationsoption
--with-boost=DIR oder setzen Sie die Umgebungsvariable
MYSQL_XDEVAPI_BOOST_ROOT. Benötigt werden nur die Boost-Header-Dateien,
nicht die Binärdateien.
Google Protocol Buffers (protobuf): erforderlich; verwenden Sie die
Konfigurationsoption --with-protobuf=DIR oder setzen Sie die
Umgebungsvariable MYSQL_XDEVAPI_PROTOBUF_ROOT.
Verwenden Sie optional make protobufs, um die
Protobuf-Dateien (*.pb.cc/.h) zu erstellen, und make
clean-protobufs, um die erstellten Protobuf-Dateien zu löschen.
Windows-spezifischer protobuf-Hinweis: Je nach Umgebung kann die
statische Bibliothek mit einer Multi-Threaded-DLL-Laufzeit erforderlich
sein. Zur Vorbereitung verwenden Sie die folgenden Optionen:
-Dprotobuf_MSVC_STATIC_RUNTIME=OFF
-Dprotobuf_BUILD_SHARED_LIBS=OFF
Google Protocol Buffers / Protocol-Compiler (protoc): erforderlich;
stellen Sie sicher, dass während des Erstellens das korrekte 'protoc' in
PATH vorhanden ist. Dies ist besonders wichtig, weil Windows PHP SDK
Batch-Skripte die Umgebung überschreiben können.
Bison: erforderlich und im PATH vorhanden.
Windows-spezifischer Bison Hinweis: Wir empfehlen dringend, dass das mit
dem verwendeten PHP SDK gelieferte Bison verwendet wird, da andernfalls
ein Fehler ähnlich wie "zend_globals_macros.h(39): error C2375:
'zendparse': redefinition; different linkage
Zend/zend_language_parser.h(214): note: see declaration of 'zendparse'"
die Folge sein kann. Außerdem können Windows PHP SDK Batch-Skripte die
Umgebung überschreiben.
Windows-spezifische Hinweise: Um die Umgebung vorzubereiten, siehe die
offizielle Windows-Build-Dokumentation für
das aktuelle SDK.
Wir empfehlen, bei allen Pfaden den Backslash '\\' anstelle eines
Schrägstrichs '/' zu verwenden.