Como compilar módulos PHP

Ao desenvolver em PHP usando o ServBay, você pode precisar compilar e instalar módulos PHP adicionais para expandir as funcionalidades do PHP. Este artigo vai mostrar como compilar módulos PHP no ambiente ServBay, incluindo especificamente os módulos imagick e sqlsrv.

Pré-requisitos

Antes de começar a compilar os módulos PHP, certifique-se de ter completado a inicialização do ambiente de compilação. Para mais detalhes sobre como inicializar o ambiente de compilação, consulte o documento Usando ServBay para recompilar.

Importância de especificar a versão do PHP

O ServBay vem com várias versões de PHP; ao usar phpize, php-config e outras ferramentas para compilar, é essencial especificar a versão de PHP que você está usando. Isto é importante porque diferentes versões de PHP podem ter diferentes configurações e dependências, e escolher a versão correta pode evitar erros de compilação e problemas em tempo de execução.

Neste exemplo, usaremos PHP 8.3.

Compilando o módulo PHP imagick

O módulo imagick é uma extensão do PHP usada para manipulação de imagens. Aqui estão os passos para compilar o módulo imagick:

Passo 1: Baixar o código-fonte

Primeiro, baixe o pacote de código-fonte do módulo imagick do PECL.

wget https://pecl.php.net/get/imagick-3.7.0.tgz

Passo 2: Descompactar o pacote de código-fonte

Descompacte o pacote de código-fonte baixado.

tar zxvf imagick-3.7.0.tgz
cd imagick-3.7.0

Passo 3: Gerar os arquivos de configuração

Use phpize para gerar os arquivos de configuração. Durante este processo, certifique-se de especificar a versão de PHP que você está usando. Por exemplo, se você está usando o PHP 8.3, execute o seguinte comando:

${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/phpize

Passo 4: Configurar as opções de compilação

Configure as opções de compilação, especificando o caminho de configuração do PHP.

./configure --with-php-config=${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/php-config

Passo 5: Compilar e instalar

Compile e instale o módulo imagick.

make -j ${CPU_NUMBER}
make install

Passo 6: Habilitar o módulo

Crie um arquivo imagick.ini no diretório conf.d do PHP para habilitar o módulo imagick. Por exemplo:

echo "extension=imagick.so" > /Applications/ServBay/package/etc/php/8.3/conf.d/imagick.ini

Passo 7: Verificar o carregamento do módulo

Reinicie o serviço PHP através do painel de administração do ServBay, e então verifique através da linha de comando se o módulo foi carregado com sucesso:

php-8.3 -m | grep imagick

Se o módulo foi carregado com sucesso, você deverá ver imagick na saída do comando.

Compilando o módulo PHP sqlsrv

O módulo sqlsrv é uma extensão do PHP usada para interagir com o Microsoft SQL Server. Aqui estão os passos para compilar o módulo sqlsrv:

Passo 1: Baixar o código-fonte

Primeiro, baixe o pacote de código-fonte do módulo sqlsrv do PECL.

wget https://pecl.php.net/get/sqlsrv-5.12.0.tgz

Passo 2: Descompactar o pacote de código-fonte

Descompacte o pacote de código-fonte baixado.

tar zxvf sqlsrv-5.12.0.tgz
cd sqlsrv-5.12.0

Passo 3: Gerar os arquivos de configuração

Use phpize para gerar os arquivos de configuração. Durante este processo, certifique-se de especificar a versão de PHP que você está usando. Por exemplo, se você está usando o PHP 8.3, execute o seguinte comando:

${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/phpize

Passo 4: Configurar as opções de compilação

Configure as opções de compilação, especificando o caminho de configuração do PHP.

./configure --with-php-config=${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/php-config

Passo 5: Compilar e instalar

Compile e instale o módulo sqlsrv.

make -j ${CPU_NUMBER}
make install

Passo 6: Habilitar o módulo

Crie um arquivo sqlsrv.ini no diretório conf.d do PHP para habilitar o módulo sqlsrv. Por exemplo:

echo "extension=sqlsrv.so" > /Applications/ServBay/package/etc/php/8.3/conf.d/sqlsrv.ini

Passo 7: Verificar o carregamento do módulo

Reinicie o serviço PHP através do painel de administração do ServBay, e então verifique através da linha de comando se o módulo foi carregado com sucesso:

php-8.3 -m | grep sqlsrv

Se o módulo foi carregado com sucesso, você deverá ver sqlsrv na saída do comando.

Conclusão

Seguindo os passos acima, você pode compilar e instalar os módulos PHP necessários no ambiente ServBay. Durante o processo de compilação, lembre-se de especificar a versão correta do PHP para garantir que o módulo seja compatível com o seu ambiente PHP. Espero que este artigo ajude você a compilar e ativar com sucesso os módulos PHP que você precisa.