Escritura de una extensión básica de PHP en C

Cuando PHP puro es demasiado lento o necesita vincular una biblioteca de C, puede escribir una extensión de PHP en C usando la API de Zend. La extensión expone funciones y clases nativas que PHP llama directamente, sin la sobrecarga de la VM.

En esta lección se crea una extensión hello mínima de principio a fin: esqueleto, función, compilación, carga y prueba.

Las extensiones se compilan con el phpize de PHP, que prepara una compilación basada en autoconf usando las cabeceras de su instalación de PHP. Necesita php-dev/php-devel (proporciona phpize y php-config), además de un compilador de C y make.

Toda extensión necesita un archivo config.m4 que registre una opción de compilación y declare los archivos de código fuente. phpize lo utiliza para generar el script de configuración.

El código fuente en C incluye las cabeceras de Zend/PHP y declara la entrada del módulo. php.h incorpora la API principal; ext/standard/info.h se utiliza para la salida de phpinfo(). Toda extensión define un zend_module_entry.

PHP moderno genera los metadatos de los argumentos a partir de un archivo .stub.php. Usted escribe la firma de la función con una sintaxis similar a PHP; gen_stub.php produce hello_arginfo.h. Esto mantiene precisas la reflexión y la información de tipos.

Una función nativa es una función de C marcada con PHP_FUNCTION. Los argumentos recibidos se analizan mediante macros de ZEND_PARSE_PARAMETERS y los valores se devuelven mediante macros de RETURN_*. Aquí se construye una cadena de saludo.

La entrada zend_module_entry lo reúne todo: el nombre, la versión, la tabla de funciones (a partir de arginfo) y los hooks del ciclo de vida (MINIT, RINIT, MINFO). ZEND_GET_MODULE exporta el símbolo de entrada que busca el cargador.

Dentro de una extensión, asigne memoria con duración de la solicitud mediante emalloc/efree (gestionada por el administrador de memoria de Zend y liberada al finalizar la solicitud), no mediante malloc sin procesar. Para asignaciones persistentes (entre solicitudes), use pemalloc. Devolver un zend_string mediante RETURN_STR transfiere la propiedad al motor, que lo libera.

La compilación clásica consta de tres pasos: phpize para preparar la estructura inicial, ./configure con su opción de activación y, después, make. Recuerde ejecutar primero gen_stub.php para generar la cabecera de arginfo.

Cargue el archivo .so compilado con -d extension=... (o añádalo a un archivo ini). Después, llame a la función nativa desde PHP exactamente igual que a una función integrada. Este es el aspecto de su script de prueba/verificación una vez instalada la extensión.

Las extensiones nativas tienen un coste de mantenimiento: errores de memoria en C, recompilaciones para cada versión menor de PHP y rupturas de ABI. Antes de optar por código nativo, considere FFI (llamar a bibliotecas de C desde PHP sin compilar una extensión) u optimizar PHP puro. Recurra a una extensión de C cuando necesite la máxima velocidad, una integración profunda con el motor o encapsular limpiamente una biblioteca de C compleja.

Dentro de una extensión, ¿qué asignador se debe utilizar para gestionar la memoria con duración de la solicitud?

Ha creado una extensión mínima en C: config.m4 registra la compilación, un .stub.php genera arginfo, PHP_FUNCTION implementa la lógica analizando los argumentos con ZEND_PARSE_PARAMETERS y devolviendo el resultado mediante RETURN_STR, y una zend_module_entry conecta los hooks del ciclo de vida. Compile con phpize → configure → make, cargue el archivo .so y haga pruebas desde PHP. Use emalloc para la memoria de la solicitud y considere FFI antes de comprometerse con código nativo.