Cómo compilar módulos de PHP

Al desarrollar PHP con ServBay, es posible que necesite compilar e instalar módulos adicionales de PHP para ampliar las funcionalidades de PHP. Este documento explica cómo compilar módulos de PHP en el entorno de ServBay, específicamente incluye la compilación del módulo imagick y del módulo sqlsrv.

Prerrequisitos

Antes de comenzar a compilar módulos de PHP, asegúrese de haber completado la inicialización del entorno de compilación. Para obtener información detallada sobre cómo inicializar el entorno de compilación, consulte la documentación Uso de ServBay para recompilación.

La importancia de especificar la versión de PHP

ServBay incluye varias versiones de PHP, por lo que al usar phpize, php-config y otras herramientas de compilación, es fundamental especificar la versión de PHP que está utilizando. Esto se debe a que diferentes versiones de PHP pueden tener diferentes configuraciones y dependencias, eligiendo la versión correcta se pueden evitar errores de compilación y problemas en tiempo de ejecución.

Este ejemplo utiliza PHP 8.3.

Compilar el módulo PHP imagick

El módulo imagick es una extensión de PHP utilizada para operaciones de imagen. Los pasos para compilar el módulo imagick son los siguientes:

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 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. En este proceso, asegúrese de especificar la versión de PHP que está utilizando. Por ejemplo, si está utilizando 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 a través del panel de administración de ServBay y luego verifique en la línea de comandos si el módulo se cargó correctamente:

php-8.3 -m | grep imagick

Si el módulo se ha cargado correctamente, debería ver imagick en la salida.

Compilar el módulo PHP sqlsrv

El módulo sqlsrv es una extensión de PHP utilizada para interactuar con Microsoft SQL Server. Los pasos para compilar el módulo sqlsrv son los siguientes:

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 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. En este proceso, asegúrese de especificar la versión de PHP que está utilizando. Por ejemplo, si está utilizando 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 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 a través del panel de administración de ServBay y luego verifique en la línea de comandos si el módulo se cargó correctamente:

php-8.3 -m | grep sqlsrv

Si el módulo se ha cargado correctamente, debería ver sqlsrv en la salida.

Resumen

Mediante 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 garantizar la compatibilidad del módulo con su entorno PHP. Espero que este documento le ayude a completar con éxito la compilación y habilitación de módulos de PHP.