Instalação no Linux
As distribuições comuns do Unix incluem versões binárias do PHP que podem
ser instaladas. Embora estas versões binárias sejam tipicamente construídas com
suporte às extensões MySQL, as próprias bibliotecas das extensões
podem precisar de pacote adicional para instalação. Verifique
o gerenciador de pacote que vem com sua distribuição escolhida para
disponibilidade.
Por exemplo, no Ubuntu o pacote php5-mysql
instala
as extensões do PHP ext/mysql, ext/mysqli e pdo_mysql. No CentOS,
o pacote php-mysql
também instala estas três
extensões PHP.
Alternativamente, pode-se compilar esta extensão. Construir o PHP a partir
do código-fonte permite que se especifique as extensões MySQL que se deseja usar,
bem como pode-se escolher a biblioteca cliente para cada extensão.
O MySQL Native Driver é a opção de biblioteca cliente recomendada, pois
resulta em melhor desempenho e dá acesso a recursos não disponíveis
ao usar a Biblioteca Cliente MySQL. Consulte a página
O que é o Driver Nativo do MySQL?
para uma visão breve das vantagens do Driver Nativo
MySQL.
/path/to/mysql_config
representa a localização do
programa mysql_config
que vem com o Servidor
MySQL.
Matriz de suporte ao mysqli em tempo de compilação
Versão do PHP |
Padrão |
Opções de Configuração: mysqlnd |
Opções de Configuração: libmysqlclient |
Registro de Alterações |
5.4.x e acima |
mysqlnd |
--with-mysqli |
--with-mysqli=/path/to/mysql_config |
mysqlnd é o padrão |
5.3.x |
libmysqlclient |
--with-mysqli=mysqlnd |
--with-mysqli=/path/to/mysql_config |
mysqlnd é suportada |
5.0.x, 5.1.x, 5.2.x |
libmysqlclient |
Não Disponível |
--with-mysqli=/path/to/mysql_config |
mysqlnd não é suportada |
Observe que é possível misturar livremente extensões MySQL e bibliotecas
cliente. Por exemplo, é possível habilitar a extensão MySQL
para usar a biblioteca cliente MySQL (libmysqlclient), enquanto configura
a extensão mysqli
para usar o driver nativo MySQL.
No entanto, todas as permutações de extensão e biblioteca cliente são
possíveis.
Instalação em Sistemas Windows
No Windows, a DLL php_mysqli.dll deve ser habilitada no
php.ini.
Como em qualquer habilitação de extensão PHP (como
php_mysqli.dll), a diretiva PHP
extension_dir seve ser definida
para o diretório onde as extensões do PHP estão localizadas. Consulte também as
Instruções de Instalação Manual no Windows.
Um exemplo de valor para extension_dir
é c:\php\ext.
Nota:
Se ao iniciar o servidor web um erro parecido com este ocorrer:
"Unable to load dynamic library './php_mysqli.dll'"
,
é porque
php_mysqli.dll não pôde ser encontrada no sistema.