Como Compilar Módulos PHP

Ao desenvolver PHP com o ServBay, pode ser necessário compilar e instalar módulos PHP adicionais para expandir suas funcionalidades. Este artigo irá explicar como compilar módulos PHP no ambiente ServBay, incluindo os módulos imagick e sqlsrv.

Pré-requisitos

Aviso

Certifique-se de inicializar o ambiente de compilação de acordo com o artigo abaixo e configure as variáveis de ambiente do sistema; caso contrário, as operações a seguir falharão!

Antes de começar a compilar os módulos PHP, verifique se você completou a inicialização do ambiente de compilação. Para detalhes sobre como inicializar o ambiente de compilação, consulte o documento Utilizando o ServBay para Recompilar.

Importância de Especificar a Versão do PHP

O ServBay acompanha várias versões do PHP. Ao usar phpize, php-config e outras ferramentas para compilar, é fundamental especificar a versão do PHP em uso. Isso se deve ao fato de que versões diferentes do PHP podem ter configurações e dependências distintas; escolher a versão correta pode evitar erros de compilação e problemas em tempo de execução.

Este exemplo usa o PHP 8.3.

Compilando o Módulo imagick do PHP

O módulo imagick é uma extensão do PHP para manipulação de imagens. A seguir estão as etapas 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 o arquivo de configuração

Use phpize para gerar o arquivo de configuração. Durante este processo, é essencial especificar a versão do PHP em uso. Por exemplo, se você estiver utilizando o PHP 8.3, execute o seguinte comando:

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

Passo 4: Configurar 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: Ativar o módulo

Crie um arquivo imagick.ini no diretório conf.d do PHP para ativar 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 gerenciamento do ServBay e, em seguida, use o terminal para verificar 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.

Compilando o Módulo sqlsrv do PHP

Aviso

Pré-requisitos: Para compilar o sqlsrv no macOS, você precisará instalar o driver ODBC da Microsoft msodbcsql18 e mssql-tools18.

O ServBay não inclui o MS ODBC, portanto, utilize o homebrew para instalá-lo.

brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18 mssql-tools18

O módulo sqlsrv é uma extensão do PHP para interagir com o Microsoft SQL Server. A seguir estão as etapas 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 o arquivo de configuração

Use phpize para gerar o arquivo de configuração. Durante este processo, é essencial especificar a versão do PHP em uso. Por exemplo, se você estiver utilizando o PHP 8.3, execute o seguinte comando:

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

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

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

export LDFLAGS="-L/opt/homebrew/lib ${LDFLAGS}"
export CPPFLAGS="-I/opt/homebrew/opt/unixodbc/include ${CPPFLAGS}"
./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: Ativar o módulo

Crie um arquivo sqlsrv.ini no diretório conf.d do PHP para ativar 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 gerenciamento do ServBay e, em seguida, use o terminal para verificar 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.

Conclusão

Com as etapas acima, você pode compilar e instalar os módulos PHP necessários no ambiente ServBay. Durante o processo de compilação, é fundamental especificar a versão correta do PHP para garantir a compatibilidade dos módulos com seu ambiente PHP. Esperamos que este artigo ajude você a concluir com sucesso a compilação e ativação dos módulos PHP.