&reftitle.setup;
&reftitle.required;
Esta extensão requer um Servidor MySQL 8+ com o plugin X
habilitado (padrão).
Bibliotecas que são pré-requisitos para esta extensão:
Boost (1.53.0 ou superior), OpenSSL e Protobuf.
&reftitle.install;
&pecl.moved;
Um procedimento de exemplo de instalação no Ubuntu 18.04 com PHP 7.2:
O comando pecl install não habilita as extensões PHP (por padrão)
e as habilitações de extensões podem ser feitas de várias formas.
Um outro exemplo do PHP 7.2 no Ubuntu 18.04:
/etc/php/7.2/mods-available/mysql_xdevapi.ini
// Usa o comando 'phpenmod' (nota: específico para Debian/Ubuntu)
$ phpenmod -v 7.2 -s ALL mysql_xdevapi
// Uma alternativa ao 'phpenmod' é criar uma ligação simbólica manualmente
// $ ln -s /etc/php/7.2/mods-available/mysql_xdevapi.ini /etc/php/7.2/cli/conf.d/20-mysql_xdevapi.ini
// Vejamos agora que extensões do MySQL estão habilitadas
$ php -m |grep mysql
mysql_xdevapi
mysqli
mysqlnd
pdo_mysql
]]>
&pecl.info;
&url.pecl.package;mysql_xdevapi.
&reference.mysql-xdevapi.ini;
Construindo / Compilando a Partir da Fonte
Considerations for compiling this extension from source.
O nome da extensão é 'mysql_xdevapi', portanto use --enable-mysql-xdevapi.
Boost: requerido, opcionalmente use a opção de configuração --with-boost=DIR
ou defina a variável de ambiente MYSQL_XDEVAPI_BOOST_ROOT. Somente os arquivos de cabeçalho
Boost são necessários, não os binários.
Google Protocol Buffers (protobuf): requerido, opcionalmente use a opção de configuração
--with-protobuf=DIR ou defina a variável de ambiente MYSQL_XDEVAPI_PROTOBUF_ROOT.
Opcionamente, use make protobufs para gerar arquivos protobuf (*.pb.cc/.h),
e make clean-protobufs para remover os arquivos protobuf gerados.
Nota do protobuf específica para Windows: dependendo do ambiente,
a biblioteca estática com um DLL multi-thread pode ser necessária.
Para preparar, use as seguintes opções:
-Dprotobuf_MSVC_STATIC_RUNTIME=OFF -Dprotobuf_BUILD_SHARED_LIBS=OFF
Google Protocol Buffers / compilador de protocolo (protoc): requerido, deve-se garantir que
o 'protoc' apropriado esteja disponível na variável de ambiente PATH durante a construção. É especialmente
importante porque os scripts em lote do Windows PHP SDK podem sobrescrever o ambiente.
Bison: requerido, e disponível a partir do PATH.
Nota do bison específica para o Windows: recomenda-se fortemente o uso do bison fornecido com o
SDK do PHP escolhido, ou pode resultar em um erro similar a "zend_globals_macros.h(39):
error C2375: 'zendparse': redefinition; different linkage
Zend/zend_language_parser.h(214): note: see declaration of 'zendparse'".
Além disso, os scripts em lote do Windows PHP SDK podem sobrescrever o ambiente.
Notas específicas para Windows: Para preparar o ambiente, consulte a documentação de compilação
oficial do Windows para
o SDK atual.
Recomenda-se usar a barra invertida '\\' ao invés da barra normal '/' para todos os caminhos.