Actualizar PHP en DirectAdmin: Guía paso a paso y por dominio

¿Por qué es importante actualizar PHP en DirectAdmin?

Actualizar PHP en DirectAdmin no es solo una cuestión de estar al día con las últimas novedades. Es una tarea de mantenimiento crítica para la seguridad y el rendimiento de tus sitios web. Cuando hablamos de actualizar PHP DirectAdmin, nos referimos a reemplazar la versión antigua del motor que ejecuta tus páginas por una más reciente, con parches de seguridad aplicados y mejoras de velocidad.

Las versiones antiguas de PHP, como PHP 5.6 o PHP 7.0, ya no reciben soporte oficial. Esto significa que si un hacker encuentra una vulnerabilidad en esa versión, nadie la va a corregir. Tu web queda expuesta. Además, las versiones nuevas son notablemente más rápididas. Un sitio que carga en 2 segundos con PHP 7.4 puede cargar en 1.2 segundos con PHP 8.2. Eso mejora tu posicionamiento en Google, porque la velocidad de carga es un factor SEO clave.

Otra razón importante: los gestores de contenido como WordPress, Joomla o PrestaShop, y sus plugins, se desarrollan pensando en las versiones modernas. Si usas una versión obsoleta, muchos plugins dejarán de funcionar o mostrarán avisos de incompatibilidad. Por eso, saber configurar PHP DirectAdmin correctamente es una habilidad esencial para cualquier administrador de servidores.

Antes de empezar: haz una copia de seguridad

[WARNING] No actualices PHP sin antes hacer una copia de seguridad completa del sitio y de la base de datos. Un cambio de versión puede romper la compatibilidad con algún script antiguo y necesitarás restaurar todo rápidamente.

La copia de seguridad la puedes hacer desde el propio DirectAdmin. Ve a la sección "Backups" y genera un backup completo de tu cuenta. También es recomendable exportar las bases de datos MySQL desde phpMyAdmin. Guarda estos archivos en tu ordenador local o en un almacenamiento externo. Este paso te llevará 5 minutos y te ahorrará un gran dolor de cabeza.

¿Cómo funciona el PHP en DirectAdmin?

DirectAdmin no gestiona PHP como un único bloque monolítico. Desde hace varias versiones, utiliza un sistema llamado PHP-FPM (FastCGI Process Manager) con soporte para múltiples versiones. Esto significa que puedes tener diferentes versiones de PHP instaladas en el mismo servidor y asignar una distinta a cada dominio.

Cuando hablamos de DirectAdmin PHP, nos referimos a este ecosistema. Hay dos formas principales de cambiar la versión:

A nivel global: se cambia la versión por defecto para todos los dominios nuevos.
A nivel de dominio individual: se asigna una versión específica a un dominio concreto sin afectar a los demás.

Este enfoque es muy potente, porque te permite migrar tus sitios de forma gradual. Puedes dejar un sitio antiguo en PHP 7.4 mientras pruebas otro en PHP 8.3 sin problemas.

Requisitos previos: acceso SSH y permisos de root

Para realizar la actualización PHP DirectAdmin de forma manual y completa, necesitarás acceso SSH al servidor con permisos de root. Si solo tienes acceso al panel de control como usuario, podrás cambiar la versión por dominio, pero no instalar nuevas versiones de PHP.

Si no tienes acceso SSH, contacta con tu proveedor de hosting. Normalmente, los planes de hosting compartido ya tienen varias versiones de PHP instaladas y solo necesitas seleccionarlas desde el panel. Pero para un servidor VPS o dedicado, el control total lo tienes tú.

[INFO] Si usas un panel alternativo como Syspanel (antes conocido como HestiaCP), el acceso SSH es igualmente necesario. Recuerda que Syspanel se gestiona por el puerto 2106 en lugar del 2222 que usa DirectAdmin.

Paso 1: Actualizar PHP en DirectAdmin usando el instalador de CustomBuild

DirectAdmin incluye una herramienta llamada CustomBuild. Es un script que compila e instala el software del servidor. Para actualizar PHP, sigue estos pasos:

Accede por SSH a tu servidor.
Ejecuta el siguiente comando para entrar al directorio de CustomBuild:
```
cd /usr/local/directadmin/custombuild
```
Actualiza la lista de versiones disponibles:
```
./build update
```
Ahora, comprueba qué versiones de PHP tienes disponibles. Puedes listarlas con:
```
./build versions
```
Esto te mostrará una tabla con las versiones de PHP que puedes instalar.
Para instalar una versión específica, por ejemplo PHP 8.3, ejecuta:
```
./build set php1_version 8.3
./build php
```
El primer comando define la versión principal (php1). El segundo comando compila e instala esa versión.
Si quieres tener una segunda versión como respaldo (por ejemplo, PHP 8.2 para compatibilidad), usa:
```
./build set php2_version 8.2
./build php
```

Este proceso de compilación puede tardar entre 10 y 30 minutos, dependiendo de la potencia de tu CPU. Ten paciencia y no cierres la sesión SSH.

Paso 2: Configurar PHP por dominio en DirectAdmin

Una vez que tienes varias versiones instaladas, el siguiente paso es cambiar PHP por dominio. Esto se hace desde el panel de control gráfico, sin necesidad de usar comandos.

Inicia sesión en DirectAdmin como administrador o como usuario con permisos sobre el dominio.
Ve a la sección "Gestión de dominios" o "Dominios".
Haz clic en el dominio que quieres modificar.
Busca la opción "Configuración de PHP" o "PHP Version". Dependiendo de la versión de DirectAdmin, puede estar en un menú desplegable o en una pestaña separada.
Selecciona la versión de PHP que deseas para ese dominio en el menú desplegable.
Haz clic en "Guardar" o "Aplicar cambios".

[TIP] Si no ves la opción "Configuración de PHP" en el dominio, asegúrate de que el administrador del servidor ha habilitado la opción "PHP Selector" en la configuración de CustomBuild. Sin esta opción, no podrás elegir versiones individuales.

Paso 3: Configurar extensiones PHP en DirectAdmin

Además de la versión, es muy común necesitar activar o desactivar extensiones PHP DirectAdmin. Las extensiones son módulos que añaden funcionalidades, como mysqli para bases de datos, curl para peticiones HTTP o gd para procesar imágenes.

Para configurarlas:

Vuelve a la sección "Configuración de PHP" del dominio.
Busca la lista de extensiones disponibles. Verás casillas de verificación.
Marca o desmarca las extensiones según necesites.
Guarda los cambios.

DirectAdmin regenerará la configuración de PHP-FPM automáticamente y recargará el servicio. Esto suele tardar solo unos segundos.

[WARNING] Activar demasiadas extensiones puede ralentizar el servidor. Solo activa las que realmente uses. Por ejemplo, si no usas imágenes, no necesitas la extensión imagick.

Paso 4: Verificar que el cambio se ha aplicado correctamente

Después de configurar PHP DirectAdmin, es fundamental verificar que todo funciona. La forma más rápida es crear un archivo de prueba.

Crea un archivo llamado info.php en la carpeta pública de tu dominio (normalmente public_html).
Dentro del archivo, escribe el siguiente código:
```
<?php phpinfo(); ?>
```
Accede a tudominio.com/info.php en tu navegador.
Verás una página con mucha información. Busca la línea "PHP Version" en la parte superior para confirmar la versión activa.
También puedes ver las extensiones cargadas en la sección "Configure Command" o en el listado de módulos.

[WARNING] Borra el archivo info.php inmediatamente después de la verificación. Dejar este archivo en el servidor es un riesgo de seguridad grave, ya que expone detalles internos de tu configuración a los atacantes.

Solución de problemas comunes al actualizar PHP

Error 500 (Internal Server Error)

Este es el error más común después de actualizar PHP DirectAdmin. Suele deberse a que algún plugin o tema de WordPress no es compatible con la nueva versión.

Solución: Revisa el log de errores del dominio. En DirectAdmin, ve a "Gestión de errores" o consulta el archivo error.log en la carpeta de logs. El error te dirá qué archivo está fallando. Temporalmente, puedes volver a la versión anterior de PHP mientras corriges el código.

Página en blanco

Si ves una página en blanco, es un error fatal de PHP. Activa la visualización de errores temporalmente añadiendo al archivo wp-config.php (si usas WordPress):

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);

Esto te mostrará el error exacto en pantalla.

Funciones desactivadas

Algunas funciones de PHP están desactivadas por seguridad en versiones nuevas. Por ejemplo, eval() o exec() pueden estar bloqueadas. Si tu aplicación las necesita, deberás configurarlas en la sección de extensiones o en el archivo php.ini de tu dominio.

Buenas prácticas y consejos de seguridad

Mantén siempre actualizado: No te quedes en una versión desactualizada. Programa una revisión mensual para comprobar si hay nuevas versiones estables de PHP.
Usa entornos de prueba: Antes de cambiar la versión de PHP en un sitio de producción, prueba el cambio en un subdominio o en una copia local.
Documenta tus cambios: Lleva un registro de qué versión de PHP usa cada dominio y por qué. Esto te ayudará en el futuro.
Revisa los logs: Después de una actualización, revisa los logs de errores de todos tus dominios durante unos días para detectar problemas ocultos.

Preguntas frecuentes (FAQ)

¿Puedo tener diferentes versiones de PHP para distintos dominios?

Sí, absolutamente. DirectAdmin te permite cambiar PHP por dominio de forma individual. Puedes tener 10 dominios con PHP 7.4 y otros 5 con PHP 8.3 en el mismo servidor.

¿Cuál es la versión de PHP más estable en 2025?

Las versiones 8.2 y 8.3 son las más recomendadas en la actualidad. PHP 8.4 está en desarrollo y puede tener problemas de compatibilidad con algunas librerías antiguas. Para producción, elige 8.3.

¿Actualizar PHP afecta a mi SEO?

Sí, indirectamente. Una versión más reciente de PHP hace que tu web cargue más rápido. Google premia la velocidad de carga con mejores posiciones. Además, los sitios con PHP desactualizado suelen tener más errores, lo que perjudica la experiencia del usuario y el posicionamiento.

¿Qué hago si mi proveedor usa Syspanel en lugar de DirectAdmin?

Si tu panel es Syspanel (antiguamente HestiaCP), el proceso es similar pero con diferencias de interfaz. El acceso al panel se realiza a través del puerto 2106. Dentro de Syspanel, busca la sección "Web" y luego "PHP". Ahí podrás cambiar la versión por dominio y gestionar las extensiones.

¿Es necesario reiniciar el servidor después de actualizar PHP?

No, no es necesario. DirectAdmin y CustomBuild se encargan de reiniciar los servicios de PHP-FPM automáticamente. Un reinicio completo del servidor solo sería necesario si también has actualizado el kernel o componentes de red.

Conclusión

Saber actualizar PHP DirectAdmin y configurar PHP DirectAdmin por dominio es una habilidad que te ahorrará muchos quebraderos de cabeza. No solo mejora la seguridad de tu servidor, sino que también optimiza el rendimiento de tus sitios web, lo que se traduce en un mejor SEO y una mejor experiencia para tus visitantes.

El proceso, aunque parezca complejo al principio, se reduce a unos pocos pasos bien definidos: actualizar la lista de paquetes con CustomBuild, instalar las versiones deseadas, asignarlas a cada dominio y verificar el resultado. Con la práctica, podrás hacerlo en menos de 15 minutos.

Recuerda siempre la regla de oro: copia de seguridad antes de cualquier cambio. Y si te encuentras con problemas, no dudes en consultar los logs y la documentación oficial de DirectAdmin. La comunidad de usuarios es muy activa y siempre hay alguien dispuesto a ayudar.

Ahora que ya sabes cómo hacerlo, ¿a qué esperas para poner al día tu servidor? Tu web y tus visitantes te lo agradecerán.