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.

Note:

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.