Cómo Compilar Módulos de PHP

Al desarrollar en PHP con ServBay, es posible que necesite compilar e instalar módulos adicionales de PHP para ampliar las funcionalidades de PHP. Este artículo explica cómo compilar módulos de PHP en el entorno de ServBay, incluyendo específicamente los módulos imagick y sqlsrv.

Requisitos Previos

Aviso

¡Asegúrese de seguir el artículo a continuación para inicializar el entorno de compilación y configurar las variables de entorno del sistema; de lo contrario, las operaciones a continuación fallarán!

Antes de comenzar a compilar módulos de PHP, asegúrese de haber completado la inicialización del entorno de compilación. Para obtener los pasos detallados sobre cómo inicializar el entorno de compilación, consulte la documentación Usar ServBay para re-compilar.

Importancia de Especificar la Versión de PHP

ServBay viene con varias versiones de PHP. Al usar phpize, php-config y otras herramientas para compilar, es crucial especificar la versión de PHP que está utilizando. Esto se debe a que diferentes versiones de PHP pueden tener configuraciones y dependencias distintas; elegir la versión correcta puede evitar errores de compilación y problemas en tiempo de ejecución.

Este ejemplo utilizará PHP 8.3.

Compilar el Módulo PHP imagick

El módulo imagick es una extensión de PHP utilizada para procesamiento de imágenes. A continuación se describen los pasos para compilar el módulo imagick:

Paso 1: Descargar el Código Fuente

Primero, descargue el paquete de código fuente del módulo imagick desde PECL.

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

Paso 2: Descomprimir el Paquete de Código Fuente

Descomprima el paquete de código fuente descargado.

tar zxvf imagick-3.7.0.tgz
cd imagick-3.7.0

Paso 3: Generar el Archivo de Configuración

Utilice phpize para generar el archivo de configuración. Asegúrese de especificar la versión de PHP que está utilizando durante este proceso. Por ejemplo, si utiliza PHP 8.3, ejecute el siguiente comando:

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

Paso 4: Configurar las Opciones de Compilación

Configure las opciones de compilación, especificando la ruta de configuración de PHP.

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

Paso 5: Compilar e Instalar

Compile e instale el módulo imagick.

make -j ${CPU_NUMBER}
make install

Paso 6: Habilitar el Módulo

Cree un archivo imagick.ini en el directorio conf.d de PHP para habilitar el módulo imagick. Por ejemplo:

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

Paso 7: Verificar la Carga del Módulo

Reinicie el servicio PHP desde el panel de administración de ServBay y luego verifique desde la línea de comandos si el módulo se cargó correctamente:

php-8.3 -m | grep imagick

Si el módulo se cargó correctamente, debería ver imagick en los resultados de salida.

Compilar el Módulo PHP sqlsrv

Aviso

Requisitos Previos: Para compilar sqlsrv en macOS, primero debe instalar el controlador ODBC de Microsoft msodbcsql18 y mssql-tools18.

ServBay no incluye MS ODBC, así que use homebrew para instalarlo.

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

El módulo sqlsrv es una extensión de PHP que permite interactuar con Microsoft SQL Server. A continuación se describen los pasos para compilar el módulo sqlsrv:

Paso 1: Descargar el Código Fuente

Primero, descargue el paquete de código fuente del módulo sqlsrv desde PECL.

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

Paso 2: Descomprimir el Paquete de Código Fuente

Descomprima el paquete de código fuente descargado.

tar zxvf sqlsrv-5.12.0.tgz
cd sqlsrv-5.12.0

Paso 3: Generar el Archivo de Configuración

Utilice phpize para generar el archivo de configuración. Asegúrese de especificar la versión de PHP que está utilizando durante este proceso. Por ejemplo, si está usando PHP 8.3, ejecute el siguiente comando:

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

Paso 4: Configurar las Opciones de Compilación

Configure las opciones de compilación, especificando la ruta de configuración de 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

Paso 5: Compilar e Instalar

Compile e instale el módulo sqlsrv.

make -j ${CPU_NUMBER}
make install

Paso 6: Habilitar el Módulo

Cree un archivo sqlsrv.ini en el directorio conf.d de PHP para habilitar el módulo sqlsrv. Por ejemplo:

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

Paso 7: Verificar la Carga del Módulo

Reinicie el servicio PHP desde el panel de administración de ServBay y luego verifique desde la línea de comandos si el módulo se cargó correctamente:

php-8.3 -m | grep sqlsrv

Si el módulo se cargó correctamente, debería ver sqlsrv en los resultados de salida.

Resumen

Siguiendo los pasos anteriores, puede compilar e instalar los módulos de PHP necesarios en el entorno de ServBay. Durante el proceso de compilación, asegúrese de especificar la versión correcta de PHP para asegurar la compatibilidad del módulo con su entorno PHP. Esperamos que este artículo le ayude a completar la compilación y habilitación de módulos de PHP sin problemas.