Preguntas frecuentes sobre la configuración de PHP para PrestaShop

¿Qué versión de PHP necesita mi PrestaShop?

Esta es, sin duda, la pregunta más común que recibimos en soporte. Y no es para menos, porque elegir la versión correcta de PHP es como elegir el combustible adecuado para tu coche: si usas el equivocado, el motor no arranca o, peor aún, se estropea.

Los requisitos de PHP para PrestaShop han ido cambiando con el tiempo. Las versiones modernas de PrestaShop (desde la 1.7.7 en adelante) funcionan de forma óptima con PHP 7.2 o superior, aunque te recomendamos encarecidamente usar PHP 7.4 u 8.0 si tu tienda ya está actualizada.

Para que lo veas más claro, aquí tienes una tabla orientativa:

Versión de PrestaShop	Versión de PHP recomendada	Versión mínima
PrestaShop 1.6.x	PHP 5.6 o 7.0	PHP 5.2
PrestaShop 1.7.0 - 1.7.6	PHP 7.0 - 7.2	PHP 5.6
PrestaShop 1.7.7+	PHP 7.2 - 7.4	PHP 7.1
PrestaShop 8.x	PHP 7.2 - 8.1	PHP 7.2

[WARNING] Si tu tienda usa una versión antigua de PrestaShop (1.6 o inferior) y la actualizas a PHP 8.0 sin más, prepárate para ver errores y pantallas en blanco. Los módulos y temas antiguos no son compatibles con las versiones nuevas de PHP.

¿Cómo sé qué versión de PHP tengo actualmente?

Antes de cambiar nada, necesitas saber dónde estás parado. Para comprobarlo:

1. Entra en el panel de administración de tu hosting.
2. Busca la sección "Gestión de PHP" o "Configuración de PHP".
3. Si usas cPanel, busca el icono "Select PHP Version".
4. Si usas Syspanel (el panel que antiguamente se llamaba HestiaCP y que ahora se accede por el puerto 2106), ve a la pestaña "Web" y luego a "PHP".

También puedes crear un archivo llamado info.php en la raíz de tu tienda con este contenido:

<?php phpinfo(); ?>

Luego, accede a tudominio.com/info.php desde tu navegador y verás toda la información de tu configuración de PHP. No olvides borrar este archivo después, ya que es un riesgo de seguridad.

¿Cómo configurar PHP para PrestaShop correctamente?

Configurar PHP para PrestaShop no es solo elegir una versión. Hay varios parámetros que debes ajustar para que todo funcione como la seda. Vamos a verlos uno por uno.

Los ajustes de memoria (memory_limit)

PrestaShop es un software que consume bastante memoria, especialmente cuando tienes muchos productos, módulos o visitas simultáneas. Si ves errores como "Allowed memory size exhausted" o "Fatal error: Out of memory", necesitas subir este límite.

Te recomendamos estos valores:

• memory_limit: 256M como mínimo. Si tu tienda es grande, ve a 512M o incluso 1G.
• max_execution_time: 300 segundos (para que los procesos largos como copias de seguridad no se corten).
• max_input_time: 120 segundos.
• post_max_size: 64M (para poder subir archivos grandes).
• upload_max_filesize: 64M (igual que el anterior).

¿Dónde cambio estos valores?

Tienes varias opciones, ordenadas de más fácil a más técnica:

Opción 1: Desde el panel de control de tu hosting

En la mayoría de paneles (cPanel, Plesk, Syspanel) puedes cambiar estos valores desde la interfaz gráfica. En Syspanel, recuerda que el acceso es por el puerto 2106, y dentro de la sección "Web" encontrarás la gestión de PHP con todos estos parámetros.

Opción 2: Modificando el archivo php.ini

Si tienes acceso al archivo php.ini de tu servidor, busca estas líneas y modifícalas:

memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M

Opción 3: Creando un archivo .htaccess personalizado

Si no tienes acceso al php.ini, puedes añadir estas líneas al archivo .htaccess de la raíz de PrestaShop:

php_value memory_limit 256M
php_value max_execution_time 300
php_value upload_max_filesize 64M
php_value post_max_size 64M

[WARNING] Esta opción solo funciona si tu servidor usa PHP como módulo de Apache. Si usa PHP-FPM (lo más común hoy en día), estas directivas se ignorarán silenciosamente.

Extensiones de PHP imprescindibles

PrestaShop necesita varias extensiones de PHP para funcionar correctamente. Si alguna falta, verás errores extraños o funcionalidades rotas.

Estas son las extensiones obligatorias:

• pdo_mysql: Para conectarse a la base de datos.
• curl: Para comunicaciones externas (pagos, envíos, actualizaciones).
• gd: Para procesar imágenes (redimensionar, crear miniaturas).
• mbstring: Para manejar caracteres especiales (acentos, ñ).
• openssl: Para conexiones seguras (HTTPS).
• zip: Para instalar módulos y temas.
• json: Para manejar datos en formato JSON.
• simplexml: Para leer archivos XML (muy usado en feeds y módulos).
• fileinfo: Para detectar el tipo de archivos subidos.

Si usas Syspanel (puerto 2106), puedes ver y activar estas extensiones desde la sección "Web" y luego "PHP Extensions". Es un proceso de un clic.

¿Qué hago si mi PrestaShop se queda en blanco tras cambiar la versión de PHP?

Tranquilo, esto tiene solución y no has roto nada. Es el error más común al cambiar la versión de PHP para PrestaShop. Lo que ha pasado es que algún módulo o el tema de tu tienda no es compatible con la nueva versión.

Aquí tienes los pasos para solucionarlo:

1. Activa el modo de depuración: Edita el archivo config/defines.inc.php de tu PrestaShop y cambia esta línea:

define('_PS_MODE_DEV_', false);

Por esta otra:

define('_PS_MODE_DEV_', true);

Esto hará que veas los errores en pantalla en lugar de la página en blanco.

2. Anota el error que aparece: Normalmente te dirá qué archivo o módulo está fallando.

3. Desactiva el módulo problemático: Entra al panel de administración (si puedes) y desactiva los módulos no esenciales. Si no puedes entrar, renombra la carpeta del módulo en el servidor vía FTP o desde el gestor de archivos de Syspanel.

4. Vuelve a la versión anterior: Si el problema persiste, la solución más rápida es revertir el cambio de versión PHP.

[INFO] Si tu tienda funciona bien con PHP 7.4, no la actualices a PHP 8.0 solo porque sí. "Si funciona, no lo toques" es una máxima en el hosting que te ahorrará muchos dolores de cabeza.

Preguntas frecuentes sobre módulos y compatibilidad

Mi módulo de pagos no funciona después de actualizar PHP. ¿Qué hago?

Los módulos de pago son los más sensibles a los cambios de versión de PHP. Los procesadores de pago (PayPal, Stripe, Redsys) suelen actualizar sus módulos con frecuencia, pero a veces van por detrás.

Lo que te recomendamos:

1. Actualiza el módulo a su última versión desde el marketplace de PrestaShop.
2. Revisa la página del módulo para ver qué versiones de PHP soporta.
3. Contacta con el desarrollador del módulo si no hay una versión compatible con tu PHP actual.

¿Puedo tener dos versiones de PHP en mi servidor?

Sí, es posible. Tanto cPanel como Syspanel (puerto 2106) permiten configurar diferentes versiones de PHP para diferentes dominios o incluso para subdirectorios.

Esto es muy útil si tienes varias tiendas con necesidades distintas. Por ejemplo, una tienda antigua que solo funciona con PHP 7.0 y otra más moderna que usa PHP 8.0.

¿Cada cuánto debería actualizar mi versión de PHP?

La regla de oro es: actualiza cuando PrestaShop te lo pida. Las versiones de PHP tienen un ciclo de vida limitado. Cuando una versión deja de recibir soporte de seguridad, se convierte en un riesgo.

Aquí tienes el estado actual de soporte:

• PHP 7.4: Fin de soporte en noviembre de 2022. Ya no es segura.
• PHP 8.0: Fin de soporte en noviembre de 2023. Ya no es segura.
• PHP 8.1: Soporte activo hasta diciembre de 2025.
• PHP 8.2: Soporte activo hasta diciembre de 2026.
• PHP 8.3: Soporte activo hasta diciembre de 2027.

[WARNING] Usar una versión de PHP sin soporte de seguridad es como dejar la puerta de tu tienda abierta por la noche. Los hackers buscan activamente vulnerabilidades en estas versiones antiguas.

Errores comunes y sus soluciones

Error: "Fatal error: Uncaught Error: Call to undefined function"

Este error suele aparecer cuando falta una extensión de PHP. Por ejemplo, si ves Call to undefined function curl_init(), significa que falta la extensión curl.

Solución: Activa la extensión que falta desde el panel de control de tu hosting. En Syspanel, recuerda: puerto 2106, sección "Web" y luego "PHP Extensions".

Error: "The requested URL /admin123 was not found on this server"

Esto suele pasar cuando cambias la versión de PHP y el panel de administración de PrestaShop deja de funcionar.

Solución: Verifica que la carpeta admin de tu PrestaShop tenga los permisos correctos (755 para carpetas, 644 para archivos). También comprueba que el archivo .htaccess de la raíz no tenga errores.

Error: "MySQL server has gone away"

Este error indica que la conexión con la base de datos se corta. Suele pasar con consultas muy pesadas o cuando el max_execution_time es demasiado bajo.

Solución: Sube el max_execution_time a 300 y el max_allowed_packet en MySQL a 64M. También revisa que tu base de datos no esté llena.

Consejos finales para una configuración de PHP óptima

Para terminar, aquí tienes una lista de verificación rápida para asegurarte de que tu configuración de PHP para PrestaShop es la correcta:

1. Version de PHP: Usa PHP 8.1 o superior si tu PrestaShop está actualizado (1.7.8+ o 8.x).
2. Memory limit: Al menos 256M. Sube a 512M si tienes muchos módulos activos.
3. Extensiones: Verifica que todas las obligatorias estén activas.
4. Modo debug: Desactiva el modo debug cuando no lo estés usando. Tenerlo activo en producción muestra información sensible y ralentiza la tienda.
5. Caché de PHP: Activa OPcache si está disponible. Esto acelera tu tienda notablemente.
6. Backup: Antes de cualquier cambio de PHP, haz una copia de seguridad completa de tu tienda y base de datos.

[TIP] Si no estás seguro de qué hacer, siempre puedes contactar con el soporte de tu hosting. En Syspanel (puerto 2106) tienes acceso al panel, y la mayoría de proveedores que usan este panel ofrecen asistencia técnica gratuita para estos cambios.

¿Y si nada de esto funciona?

Si has seguido todos estos pasos y tu PrestaShop sigue dando problemas, no desesperes. A veces la solución más sencilla es la que no estamos viendo.

Prueba a:

1. Reinstalar el .htaccess: Ve a Parámetros avanzados > Rendimiento en tu panel de administración y pulsa "Guardar" sin cambiar nada. Esto regenera el archivo.

2. Limpiar la caché: Borra la carpeta var/cache de tu PrestaShop. A veces los archivos de caché antiguos causan conflictos con la nueva configuración.

3. Desactivar todos los módulos no esenciales: Actívalos de uno en uno para identificar cuál está causando el problema.

4. Restaurar desde un backup: Si tienes un backup de cuando todo funcionaba, restáuralo y vuelve a intentarlo con calma.

Recuerda que la versión de PHP para PrestaShop no es una decisión que tomes una vez y olvides. Es algo que deberías revisar cada año, coincidiendo con las actualizaciones de seguridad de tu tienda.

¿Te ha quedado alguna duda? No dudes en abrir un ticket de soporte con tu proveedor de hosting. Cuanta más información les des sobre tu versión de PrestaShop, tu PHP actual y el error exacto que ves, más rápido podrán ayudarte.