Las extensiones de PHP permiten ampliar las funciones disponibles en el lenguaje y añadir capacidades que no vienen necesariamente activadas en una instalación básica. Desde trabajar con bases de datos hasta procesar imágenes o utilizar determinadas funcionalidades, muchas aplicaciones necesitan tener instaladas y habilitadas extensiones específicas.

En Windows, instalar una extensión de PHP no suele ser complicado, aunque es importante utilizar una versión compatible con la instalación de PHP que tenemos en el equipo.

¿Qué es una extensión de PHP?

Una extensión de PHP es un componente que añade funcionalidades adicionales al lenguaje.

PHP incluye muchas funciones de forma predeterminada, pero otras se proporcionan mediante extensiones. Algunas son especialmente habituales en proyectos web, como las relacionadas con bases de datos, imágenes, XML o determinadas operaciones matemáticas.

Por ejemplo, una aplicación puede necesitar la extensión cURL para realizar determinadas conexiones, mientras que otros proyectos pueden requerir extensiones como GD, mbstring o OpenSSL.

Antes de instalar una extensión concreta, conviene consultar la documentación oficial de PHP para comprobar qué requisitos tiene.

Comprobar qué versión de PHP tenemos instalada

Antes de descargar cualquier archivo, es fundamental saber qué versión de PHP utilizamos.

Podemos comprobarlo desde la consola de Windows ejecutando:

php -v

El sistema mostrará información similar a:

PHP 8.3.x (cli)

La versión es importante porque una extensión compilada para una versión diferente puede no funcionar correctamente.

También debemos conocer otros datos de nuestra instalación, como si utilizamos una versión Thread Safe (TS) o Non Thread Safe (NTS) y si PHP funciona con una arquitectura de 64 o 32 bits.

Puedes consultar información más detallada en la documentación oficial sobre la instalación de PHP en Windows.

Localizar el archivo php.ini

La configuración de PHP se controla principalmente mediante el archivo php.ini.

Para saber qué archivo está utilizando nuestra instalación, podemos ejecutar:

php --ini

El comando mostrará la ubicación del archivo de configuración cargado.

También podemos crear un pequeño archivo PHP con:

<?php
phpinfo();
?>

Al ejecutarlo desde un servidor web podremos consultar diferentes parámetros de la instalación, incluida la ubicación del archivo php.ini.

Es importante modificar el archivo php.ini que realmente está utilizando nuestra instalación y no otro archivo situado en una carpeta diferente.

Descargar la extensión adecuada

Una vez conocemos nuestra versión de PHP, debemos obtener una versión de la extensión que sea compatible con ella.

En Windows, muchas extensiones se distribuyen como archivos .dll.

La compatibilidad debe coincidir con las características de nuestra instalación. No basta con que la extensión sea para PHP: también hay que comprobar que corresponda con la versión y configuración utilizadas.

La página oficial de extensiones PECL para Windows permite encontrar diferentes extensiones disponibles para PHP.

Copiar el archivo DLL

Después de descargar la extensión correspondiente, normalmente tendremos que copiar su archivo .dll al directorio de extensiones de PHP.

Esta carpeta suele llamarse:

ext

Por ejemplo:

C:\php\ext

La ubicación exacta dependerá de dónde esté instalada nuestra versión de PHP.

Si no sabemos cuál es el directorio utilizado, podemos revisar el valor de extension_dir en php.ini.

Por ejemplo:

extension_dir="ext"

También puede aparecer una ruta absoluta.

Activar la extensión en php.ini

Copiar el archivo .dll no siempre es suficiente. Después debemos indicar a PHP que debe cargarlo.

En versiones actuales de PHP, la configuración suele utilizar una línea como:

extension=nombre_extension

Por ejemplo, si la extensión correspondiente fuese php_curl.dll, la configuración podría ser:

extension=curl

La forma exacta de configuración puede variar dependiendo de la extensión y de la versión de PHP, por lo que siempre conviene seguir las instrucciones específicas de la extensión.

En versiones antiguas también era frecuente encontrar configuraciones como:

extension=php_curl.dll

Reiniciar el servidor web

Después de modificar php.ini, los cambios no se aplicarán necesariamente de forma inmediata.

Si utilizamos PHP junto con Apache, IIS u otro servidor web, debemos reiniciar el servicio correspondiente.

Por ejemplo, si utilizamos un entorno de desarrollo como XAMPP, normalmente tendremos que detener y volver a iniciar Apache.

Esto permite que PHP vuelva a cargar su configuración y detecte la nueva extensión.

¿Cómo comprobar si la extensión está instalada?

Una de las formas más sencillas de comprobarlo desde la consola es ejecutar:

php -m

Este comando muestra las extensiones cargadas por PHP.

También podemos buscar una extensión concreta:

php -m | findstr curl

Si aparece curl en el resultado, significa que la extensión está cargada en esa instalación de PHP.

Otra posibilidad consiste en utilizar:

php -i

que muestra una gran cantidad de información sobre la configuración de PHP.

¿Qué ocurre si aparece un error al cargar la extensión?

Uno de los problemas más habituales es utilizar una extensión que no coincide con nuestra instalación de PHP.

Por ejemplo, podemos tener una extensión destinada a una versión diferente de PHP o a una arquitectura distinta.

También puede existir un problema con alguna DLL de la que dependa la extensión.

Si PHP muestra un mensaje similar a:

Unable to load dynamic library

hay que revisar la ruta del archivo, la configuración de extension_dir, la compatibilidad de la extensión y sus posibles dependencias.

La documentación de PHP incluye información específica sobre la instalación de extensiones en Windows.

Diferencias entre PHP de consola y PHP del servidor

Otro aspecto que puede provocar confusión es que una instalación de PHP utilizada desde la consola no siempre utiliza exactamente la misma configuración que PHP utilizado por Apache u otro servidor.

Por ejemplo, al ejecutar:

php --ini

podemos comprobar qué php.ini utiliza el ejecutable de PHP de la consola.

Sin embargo, el servidor web podría estar utilizando otra instalación de PHP y, por tanto, otro archivo de configuración.

Por eso, si una extensión aparece disponible mediante php -m pero una página web indica que no está instalada, conviene comprobar qué instalación de PHP está utilizando realmente el servidor.

Instalar extensiones PECL en Windows

PECL es un repositorio y sistema relacionado con extensiones de PHP.

En Windows existen paquetes precompilados de determinadas extensiones, lo que facilita su instalación sin tener que compilar manualmente el código fuente.

No obstante, hay que seleccionar cuidadosamente el paquete correspondiente a nuestra versión de PHP y a sus características.

La documentación de PECL en PHP explica el funcionamiento general de este sistema.

Consejos antes de instalar una extensión

Antes de modificar la instalación de PHP, conviene comprobar varios puntos:

• La versión exacta de PHP.
• Si utilizamos TS o NTS.
• La arquitectura de PHP.
• La ubicación del archivo php.ini.
• El directorio configurado mediante extension_dir.
• La compatibilidad de la extensión.
• Las dependencias necesarias.
• Si estamos modificando la instalación utilizada por la consola o por el servidor web.

Comprobar estos datos previamente puede evitar muchos errores.

En resumen

Instalar una extensión de PHP en Windows consiste normalmente en localizar nuestra instalación de PHP, comprobar su versión y características, obtener una extensión compatible, colocar su archivo correspondiente en el directorio adecuado y activarla desde php.ini.

Después de reiniciar el servidor web, podemos utilizar comandos como:

php -m

para comprobar si PHP está cargando correctamente la extensión.

La clave está en utilizar siempre una extensión compatible con nuestra versión y configuración de PHP. Si aparece un error al cargarla, lo primero que debemos revisar son la versión, la arquitectura, el tipo TS/NTS, la ruta de las extensiones y las dependencias necesarias.

Con estos pasos, podemos ampliar las capacidades de PHP en Windows sin necesidad de realizar una instalación completamente nueva del lenguaje.