Cambiar versión PHP en Syspanel: Guía por dominio y global

¿Por qué es importante saber cambiar la versión de PHP en Syspanel?

Cada sitio web tiene necesidades técnicas diferentes. Una tienda online con un plugin antiguo puede necesitar PHP 7.4, mientras que una aplicación moderna construida con Laravel o Symfony funcionará mejor con PHP 8.2 o superior. Cambiar la versión de PHP por dominio en Syspanel te permite ajustar el rendimiento, la seguridad y la compatibilidad de cada sitio web de forma independiente, sin afectar a los demás dominios alojados en tu servidor.

Syspanel (antes conocido como HestiaCP) es un panel de control de hosting potente y gratuito que incluye esta funcionalidad de forma nativa. A diferencia de otros paneles donde el cambio de PHP es global, Syspanel te da la flexibilidad de asignar una versión específica de PHP a cada dominio o subdominio. Esto es especialmente útil si gestionas proyectos con requisitos técnicos distintos.

En esta guía completa aprenderás, paso a paso, cómo cambiar la versión de PHP en Syspanel por dominio, qué versiones están disponibles, cómo solucionar problemas comunes y qué precauciones debes tomar antes de realizar el cambio. Vamos a ello.

Requisitos previos antes de cambiar la versión de PHP

Antes de lanzarte a cambiar la versión de PHP en Syspanel, asegúrate de cumplir con estos requisitos básicos:

Tener acceso al panel de Syspanel con permisos de administrador o de usuario con privilegios suficientes sobre el dominio.
Conocer la URL de acceso a tu panel: normalmente es https://tu-servidor:2106. El puerto 2106 es la puerta de entrada a Syspanel.
Tener a mano las credenciales de acceso (usuario y contraseña).
Saber qué versión de PHP necesita tu aplicación. Consulta la documentación de tu CMS, framework o script para verificar la compatibilidad.
Realizar una copia de seguridad completa del sitio web (archivos y base de datos) antes de cualquier cambio. Este paso es fundamental para evitar pérdidas de datos si algo sale mal.

[WARNING]
No cambies la versión de PHP en un sitio de producción sin antes probarlo en un entorno de desarrollo o staging. Un cambio incorrecto puede provocar errores críticos como pantallas blancas, incompatibilidades con plugins o caídas del sitio.

Paso 1: Accede a Syspanel

El primer paso es entrar en tu panel de control. Abre tu navegador web favorito y escribe la dirección de tu servidor seguida del puerto 2106. Por ejemplo:

https://192.168.1.100:2106

Si tienes un nombre de dominio asociado al panel, también puedes usar algo como https://panel.tudominio.com:2106.

Al cargar la página, verás la pantalla de inicio de sesión. Introduce tu usuario y contraseña. Si es tu primera vez, es posible que debas usar el usuario admin y la contraseña que configuraste durante la instalación de Syspanel.

Una vez dentro, verás el escritorio principal con un resumen de tu servidor, el uso de recursos y la lista de dominios alojados.

Paso 2: Localiza el dominio que quieres modificar

En el menú lateral izquierdo de Syspanel, busca la sección "Web" o "Sitios Web". Aquí se listan todos los dominios y subdominios que tienes configurados en tu servidor.

Identifica el dominio o subdominio al que deseas cambiar la versión de PHP. Puedes usar el buscador interno si tienes muchos sitios web. Haz clic sobre el nombre del dominio para abrir su panel de configuración.

[INFO]
En Syspanel, cada dominio puede tener configuraciones independientes. No solo la versión de PHP, sino también el directorio raíz, los certificados SSL, las redirecciones y los archivos de configuración personalizados.

Paso 3: Accede a la configuración de PHP del dominio

Dentro de la página de configuración del dominio, busca la pestaña o sección que se llama "Configuración", "Ajustes" o directamente "PHP". Dependiendo de la versión de Syspanel que estés utilizando, la ubicación exacta puede variar ligeramente, pero normalmente encontrarás una opción clara como "Versión de PHP" o "Editar PHP".

Al hacer clic, se abrirá un menú desplegable con todas las versiones de PHP que tienes instaladas en tu servidor. Las versiones más comunes son:

PHP 7.4
PHP 8.0
PHP 8.1
PHP 8.2
PHP 8.3

Si no ves alguna versión, es posible que necesites instalarla previamente desde la sección de administración de paquetes de Syspanel (más adelante te explicamos cómo hacerlo).

Paso 4: Selecciona la nueva versión de PHP y guarda los cambios

Despliega el menú y selecciona la versión de PHP que necesitas para tu dominio. Por ejemplo, si tu sitio requiere PHP 8.1, elige esa opción.

Después de seleccionar la versión, verás un botón para "Guardar" o "Actualizar". Haz clic en él.

Syspanel aplicará el cambio de forma casi instantánea. En algunos casos, puede tardar unos segundos mientras se regenera la configuración del servidor web (Apache o Nginx) y se reinicia el proceso de PHP-FPM correspondiente.

[TIP]
Después de guardar, es recomendable esperar entre 30 segundos y 1 minuto antes de comprobar tu sitio web. Esto da tiempo a que los cambios se propaguen correctamente.

Paso 5: Verifica que el cambio se ha aplicado correctamente

Para confirmar que la versión de PHP se ha cambiado correctamente en tu dominio, puedes hacer lo siguiente:

Crea un archivo llamado phpinfo.php en el directorio raíz de tu dominio (normalmente public_html o web).
En ese archivo, escribe el siguiente código:
```
<?php phpinfo(); ?>
```
Guarda el archivo y accede a él desde tu navegador: https://tudominio.com/phpinfo.php.
Busca la línea que dice "PHP Version". Debería mostrar la versión que seleccionaste.

[WARNING]
Elimina el archivo phpinfo.php después de la comprobación. Dejarlo en el servidor es un riesgo de seguridad, ya que expone información detallada sobre tu configuración de PHP y del servidor.

Cómo instalar versiones adicionales de PHP en Syspanel

Si en el menú desplegable no aparece la versión que necesitas, tendrás que instalarla primero. Syspanel facilita este proceso desde su interfaz.

Ve al menú lateral y busca la sección "Servidor" o "Configuración del servidor".
Dentro, busca la opción "PHP" o "Versiones de PHP".
Verás una lista de versiones instaladas y un botón para "Instalar" o "Añadir".
Selecciona la versión que deseas instalar (por ejemplo, PHP 8.3) y haz clic en instalar.
El proceso puede tardar unos minutos, ya que Syspanel descargará e instalará los paquetes necesarios.

Una vez finalice la instalación, la nueva versión aparecerá en el menú desplegable de configuración de cada dominio.

[INFO]
Puedes tener instaladas varias versiones de PHP simultáneamente en el mismo servidor. Cada dominio puede usar una distinta, lo que maximiza la compatibilidad y el rendimiento.

Solución de problemas comunes al cambiar la versión de PHP

Error 500 o pantalla blanca

Este es el problema más habitual. Si después de cambiar la versión de PHP tu sitio muestra un error 500 o una página en blanco, significa que el código de tu aplicación no es compatible con la nueva versión.

Solución: Vuelve a la versión anterior de PHP desde el mismo menú de configuración. Luego, revisa los logs de error del servidor (normalmente en /var/log/ o a través de la sección de logs de Syspanel) para identificar qué archivo o función está causando el problema. Actualiza tu código o consulta con el desarrollador de tu aplicación.

Extensiones de PHP que no se cargan

Al cambiar de versión, es posible que algunas extensiones (como mysqli, gd, curl) no estén habilitadas en la nueva versión.

Solución: Desde la configuración de PHP en Syspanel, busca la sección de "Extensiones" o "Módulos". Activa las que necesites y guarda los cambios. Si la extensión no aparece, deberás instalarla desde la terminal del servidor con el gestor de paquetes correspondiente.

El sitio carga muy lento

Si notas una caída de rendimiento, puede que la nueva versión de PHP no esté optimizada para tu aplicación o que necesites ajustar los límites de memoria.

Solución: Revisa la configuración de memory_limit, max_execution_time y post_max_size en la configuración de PHP para ese dominio. Syspanel permite editar estos valores desde la interfaz.

Preguntas frecuentes (FAQ)

¿Puedo cambiar la versión de PHP sin afectar a otros dominios?

Sí, esa es precisamente la ventaja de Syspanel. Cada dominio tiene su propia configuración de PHP independiente. Cambiar la versión en un dominio no afecta a los demás.

¿Qué versión de PHP debería usar?

Depende de tu aplicación. En general, PHP 8.2 y 8.3 ofrecen mejor rendimiento y seguridad. Sin embargo, si usas software antiguo, es posible que necesites PHP 7.4. Consulta siempre la documentación oficial de tu CMS o framework.

¿Cómo puedo saber qué versión de PHP está usando mi sitio actualmente?

Puedes usar el método del archivo phpinfo.php descrito anteriormente. Otra opción es consultar los logs de Syspanel o usar herramientas online como whatphpversion.com.

¿Syspanel es compatible con PHP 8.3?

Sí, las versiones recientes de Syspanel (basadas en HestiaCP) soportan PHP 8.3. Si no ves la opción, actualiza Syspanel a la última versión.

¿Necesito reiniciar el servidor después de cambiar la versión de PHP?

No es necesario. Syspanel gestiona automáticamente el reinicio de PHP-FPM y la recarga de la configuración del servidor web. En la mayoría de los casos, el cambio es inmediato.

¿El puerto 2106 es seguro para acceder a Syspanel?

Sí, el puerto 2106 es el puerto por defecto de Syspanel. Puedes cambiarlo por otro si lo deseas, pero siempre es recomendable mantenerlo oculto y usar un firewall para restringir el acceso.

Conclusión

Cambiar la versión de PHP en Syspanel por dominio es un proceso sencillo pero que requiere atención y precaución. Siguiendo los pasos que te hemos mostrado, podrás ajustar cada sitio web a sus necesidades específicas, mejorando la compatibilidad, el rendimiento y la seguridad.

Recuerda siempre hacer una copia de seguridad antes de realizar cambios, probar en un entorno de desarrollo si es posible y verificar que todo funciona correctamente después del cambio. Syspanel te ofrece la flexibilidad necesaria para gestionar múltiples versiones de PHP sin complicaciones, y con esta guía ya tienes todo lo necesario para aprovecharla al máximo.

Si encuentras algún problema o tienes dudas adicionales, no dudes en consultar la documentación oficial de Syspanel o contactar con tu proveedor de hosting. ¡Buena suerte con la configuración!