A carregar os drivers da Microsoft para PHP para SQL Server

Descarregar o driver PHP

Esta página fornece instruções para carregar os Microsoft Drivers para PHP para SQL Server no espaço de processos PHP.

Pode descarregar os drivers pré-criados para a sua plataforma na página de projeto Microsoft Drivers for PHP para o SQL Server no GitHub. Cada pacote de instalação contém ficheiros de driver SQLSRV e PDO_SQLSRV em variantes threaded e não-threaded. No Windows, também estão disponíveis em variantes de 32 e 64 bits. Consulte Requisitos de Sistema para os Microsoft Drivers for PHP para SQL Server para uma lista dos ficheiros de drivers contidos em cada pacote. O ficheiro do driver deve ser compatível com a versão PHP, arquitetura e modo de segmentação do seu ambiente PHP.

No Linux e macOS, os drivers podem ser instalados alternativamente usando PECL, como encontrado no tutorial de instalação.

Também podes construir os drivers a partir do código-fonte, seja ao compilar PHP ou usando phpize. Se escolheres construir os drivers a partir da fonte, tens a opção de os compilar estaticamente em PHP em vez de os construir como extensões partilhadas, adicionando --enable-sqlsrv=static --with-pdo_sqlsrv=static (no Linux e macOS) ou --enable-sqlsrv=static --with-pdo-sqlsrv=static (no Windows) ao ./configure comando ao compilar PHP. Para mais informações sobre o sistema de compilação PHP e phpize, consulte a documentação PHP.

Mover o ficheiro do driver para o seu diretório de extensões

O ficheiro do driver deve estar localizado num diretório onde o runtime PHP o possa encontrar. É mais fácil colocar o ficheiro do driver no diretório de extensões PHP predefinido – para encontrar o diretório predefinido, correr php -i | sls extension_dir no Windows ou php -i | grep extension_dir no Linux/macOS. Se não estiver a usar o diretório de extensão predefinido, especifique um diretório no ficheiro de configuração PHP (php.ini), usando a opção extension_dir . Por exemplo, no Windows, se colocou o ficheiro do driver na sua c:\php\ext diretoria, adicione a seguinte linha à php.ini:

extension_dir = "c:\PHP\ext"  

Carregamento do Driver no Início do PHP

Para carregar o driver SQLSRV quando o PHP for iniciado, primeiro mova um ficheiro do driver para o seu diretório de extensões. Em seguida, siga estes passos:

1. Para ativar o driver SQLSRV , modifiquephp.ini adicionando a seguinte linha à secção de extensão, alterando o nome do ficheiro conforme apropriado:

   No Windows:

   extension=php_sqlsrv_82_ts.dll  
   

   No Linux, se descarregaste os binários pré-construídos para a tua distribuição:

   extension=php_sqlsrv_82_nts.so  
   

   Se tiver compilado o binário SQLSRV a partir da fonte ou com PECL, será nomeado sqlsrv.so:

   extension=sqlsrv.so
   

2. Para ativar o driver PDO_SQLSRV , a extensão PHP Data Objects (PDO) deve estar disponível, seja como extensão incorporada, quer como extensão carregada dinamicamente.

   No Windows, os binários PHP pré-construídos vêm com PDO incorporado, por isso não é necessário modificar php.ini para o carregar. Se, no entanto, tiver compilado PHP a partir da fonte e especificado uma extensão PDO separada a ser construída, ela será chamada php_pdo.dll, e deve copiá-la para o seu diretório de extensões e adicionar a seguinte linha à php.ini:

   extension=php_pdo.dll  
   

   No Linux, se instalou PHP usando o gestor de pacotes do seu sistema, o PDO provavelmente está instalado como uma extensão carregada dinamicamente chamada pdo.so. A extensão PDO deve ser carregada antes da extensão PDO_SQLSRV, caso contrário o carregamento falhará. As extensões são normalmente carregadas usando ficheiros .ini individuais, e estes ficheiros são lidos após php.ini. Portanto, se pdo.so for carregado através do seu próprio ficheiro .ini, é necessário um ficheiro separado que carregue o driver de PDO_SQLSRV após o PDO.

   Para descobrir em que diretório se encontram os ficheiros de .ini específicos da extensão, execute php --ini e anote o diretório listado em Scan for additional .ini files in:. Encontre o ficheiro que carrega pdo.so. É provável que seja precedido por um número, como 10-pdo.ini. O prefixo numérico indica a ordem de carregamento dos ficheiros .ini, enquanto os ficheiros que não têm prefixo numérico são carregados alfabeticamente. Crie um ficheiro para carregar o ficheiro do driver PDO_SQLSRV chamado 30-pdo_sqlsrv.ini (qualquer número maior do que aquele que prefixa pdo.ini funciona) ou pdo_sqlsrv.ini (se pdo.ini não tiver prefixo por um número), e adicione a seguinte linha, alterando o nome do ficheiro conforme apropriado:

   extension=php_pdo_sqlsrv_82_nts.so
   

   Tal como no SQLSRV, se tiver compilado o binário PDO_SQLSRV a partir do código-fonte ou com PECL, ele será nomeado pdo_sqlsrv.so:

   extension=pdo_sqlsrv.so
   

   Copie este ficheiro para o diretório que contém os outros ficheiros .ini.

   Se tiver PHP compilado a partir do código-fonte com suporte PDO incorporado, não precisa de um ficheiro .ini separado, e pode adicionar a linha apropriada acima para php.ini.

3. Reinicie o servidor Web.

Observação

Para determinar se o driver foi carregado com sucesso, execute um script que chama phpinfo().

Para mais informações sobre php.ini diretivas, veja Descrição das diretivas php.ini centrais.

Ver também

Começar com os drivers Microsoft para PHP para SQL Server

Requisitos de Sistema para os Drivers Microsoft para PHP no SQL Server

Guia de Programação para os Microsoft Drivers for PHP para SQL Server

Referência da API do Driver SQLSRV

Referência da API do Driver PDO_SQLSRV