Error 500 en PrestaShop: causas y solución | Guía para SysAdmin

¡Hola! Si estás aquí, es porque al intentar instalar PrestaShop te has topado con la temida pantalla blanca o el mensaje error 500 PrestaShop. No te preocupes, es uno de los problemas más comunes en instalaciones y, por suerte, casi siempre tiene solución.

Este error significa que algo falló en el servidor, pero no te dice exactamente qué. Puede deberse a un simple archivo con permisos incorrectos, a un módulo de PHP que falta, o incluso a un problema de memoria. En esta PrestaShop guía paso a paso, te voy a enseñar cómo diagnosticar y solucionar error 500 en tu instalación, incluso si no eres un experto en sistemas.

Vamos a ir desde lo más básico hasta lo más técnico, con un lenguaje claro y muchos consejos prácticos. Al final, tendrás tu tienda funcionando.

¿Por qué aparece el error 500 en PrestaShop?

El error 500 es un error genérico del servidor. En el contexto de PrestaShop instalación error, las causas más frecuentes son:

Permisos de archivos y carpetas incorrectos (especialmente después de subir archivos por FTP).
Falta de extensiones PHP necesarias (como mysqli, curl, gd, openssl, etc.).
Límite de memoria PHP insuficiente (PrestaShop necesita al menos 256 MB).
Archivo .htaccess corrupto o mal generado.
Problemas con la versión de PHP (PrestaShop 1.7 requiere PHP 7.1 o superior, pero no PHP 8.2 en todas sus versiones).
Errores en el archivo config/settings.inc.php (si estás reinstalando).
Módulos o temas incompatibles (si ya tenías una instalación previa).

Vamos a solucionarlo paso a paso.

Paso 1: Activar el modo debug de PrestaShop (para ver el error real)

Por defecto, PrestaShop oculta los detalles del error. Lo primero que haremos es obligarlo a mostrar el mensaje real.

### 1.1. Accede a tu servidor por FTP o por el panel de control

Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu hosting. Si usas Syspanel (el panel de control de HestiaCP), accede por tu-dominio.com:2106 y ve a "Administrador de archivos".

### 1.2. Edita el archivo `config/defines.inc.php`

Busca la línea que dice:

define('_PS_MODE_DEV_', false);

Cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda el archivo y recarga la página donde te daba el error. Ahora verás un mensaje más descriptivo, como "Fatal error: Allowed memory size exhausted" o "Class not found". Anota ese mensaje, nos servirá.

[TIP] Si no ves el error, prueba a añadir también esta línea justo debajo:

ini_set('display_errors', 'on');

Paso 2: Verificar los requisitos de PHP

PrestaShop es exigente con la configuración de PHP. Si te falta alguna extensión, obtendrás el error 500.

### 2.1. Comprueba la versión de PHP

Desde tu panel de control (Syspanel, cPanel, etc.) puedes seleccionar la versión de PHP. PrestaShop 1.7 funciona bien con PHP 7.4 o 8.0. Evita PHP 8.1 o 8.2 a menos que uses la última versión de PrestaShop 8.

### 2.2. Extensiones necesarias

Las extensiones obligatorias son:

mysqli
curl
gd
openssl
json
mbstring
zip
fileinfo
intl

En Syspanel, ve a "Ajustes del servidor" > "PHP" y activa todas las que falten. En otros paneles, busca "Selector de PHP" o "Extensiones PHP".

### 2.3. Aumenta el límite de memoria

Si el error dice "Allowed memory size exhausted", edita el archivo php.ini o, si no tienes acceso, crea un archivo php.ini en la raíz de PrestaShop con este contenido:

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

[WARNING] No todos los hostings permiten sobrescribir el php.ini. Si no funciona, contacta con soporte.

Paso 3: Corregir permisos de archivos y carpetas

Los permisos incorrectos son la causa número 1 del error 500 PrestaShop después de una subida por FTP.

### 3.1. Permisos recomendados

Carpetas: 755
Archivos: 644
Carpetas cache, log, img, upload, download, themes, modules: 777 (temporalmente)

### 3.2. Cómo cambiarlos desde Syspanel

En Syspanel (puerto 2106), ve al administrador de archivos, selecciona la carpeta de PrestaShop y haz clic en "Permisos". Puedes aplicar 755 a todas las carpetas y 644 a todos los archivos.

### 3.3. Usando FTP

Con FileZilla, selecciona todos los archivos, clic derecho > "Permisos de archivo" y marca:

Propietario: lectura, escritura, ejecución
Grupo: lectura, ejecución
Público: lectura, ejecución

Luego, para las carpetas, marca también "Aplicar a todos los subdirectorios".

[INFO] Después de instalar, es recomendable dejar las carpetas cache, log y img en 777 para que PrestaShop pueda escribir en ellas.

Paso 4: Revisar el archivo .htaccess

Si el error aparece después de activar la URL amigable, el .htaccess generado por PrestaShop puede estar corrupto.

### 4.1. Renombrar o eliminar el .htaccess

Desde FTP o Syspanel, localiza el archivo .htaccess en la raíz de PrestaShop y renómbralo a .htaccess_old. Luego, desde el panel de administración (si puedes acceder), ve a "Configuración" > "Tráfico y SEO" y vuelve a generar el archivo.

Si no puedes acceder al admin, crea un .htaccess vacío y luego desde la instalación vuelve a generarlo.

### 4.2. Contenido básico de .htaccess

Si no tienes acceso al admin, puedes copiar este contenido mínimo:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>

Paso 5: Verificar el archivo settings.inc.php (para reinstalaciones)

Si estás reinstalando PrestaShop, el archivo config/settings.inc.php puede tener datos antiguos y causar conflicto.

### 5.1. Eliminar el archivo

Borra o renombra config/settings.inc.php. Luego, vuelve a ejecutar la instalación desde tu-dominio.com/install. El instalador creará un archivo nuevo.

[WARNING] Esto borrará la configuración de la base de datos. Si ya tenías datos, asegúrate de tener un backup.

Paso 6: Comprobar la memoria del servidor (sysadmin)

Si todo lo anterior falla, el problema puede ser del servidor. PrestaShop necesita al menos 256 MB de RAM para PHP.

### 6.1. Desde Syspanel (HestiaCP)

En Syspanel, ve a "Ajustes del servidor" > "PHP" y busca "memory_limit". Si está por debajo de 256M, cámbialo. También puedes revisar el uso de memoria del servidor en "Estadísticas del sistema".

### 6.2. Crear un archivo de prueba

Crea un archivo llamado info.php en la raíz de PrestaShop con este contenido:

<?php phpinfo(); ?>

Accede a tu-dominio.com/info.php. Busca la línea "memory_limit". Si es menor a 256M, tendrás que aumentarlo desde el panel o contactar con soporte.

[TIP] No olvides borrar info.php después, ya que expone información sensible.

Paso 7: Solución rápida: reinstalar desde cero

Si después de todo sigues con el error 500 PrestaShop, a veces lo más rápido es empezar de nuevo.

### 7.1. Backup de datos (si los tienes)

Antes de borrar, guarda la carpeta themes, modules y la base de datos.

### 7.2. Eliminar todo y reinstalar

Borra todos los archivos de PrestaShop (excepto install y admin si quieres conservar el acceso). Descarga la última versión desde prestashop.com y súbela por FTP.

Asegúrate de que la carpeta install tenga permisos 755 y ejecuta la instalación desde tu-dominio.com/install.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

### ¿El error 500 puede deberse a un tema o módulo?

Sí, si ya tenías PrestaShop funcionando y de repente aparece el error, puede ser un módulo o tema recién instalado. Desactívalos desde la base de datos (tabla ps_module) o renombra la carpeta modules a modules_old para probar.

### ¿Cómo sé si es problema de PHP o de permisos?

Si el error cambia al activar el modo debug (Paso 1), es más fácil. Si ves "Class not found", es PHP. Si ves "Permission denied", son permisos.

### ¿Qué hago si no tengo acceso al panel de administración?

Puedes hacer todos los pasos por FTP o Syspanel. El modo debug se activa editando archivos, y los permisos se cambian desde el administrador de archivos.

### ¿Syspanel es lo mismo que HestiaCP?

Sí, Syspanel es el nombre comercial del panel de control basado en HestiaCP. Recuerda que el puerto de acceso es el 2106 (ejemplo: tudominio.com:2106).

### ¿Puedo instalar PrestaShop en un hosting compartido?

Sí, pero asegúrate de que cumpla los requisitos mínimos: PHP 7.4, MySQL 5.6, y al menos 256 MB de memoria PHP. Muchos hostings compartidos limitan esto.

Resumen final

El error 500 PrestaShop en la instalación es frustrante, pero siguiendo esta PrestaShop guía paso a paso lo resolverás:

Activa el modo debug para ver el error real.
Revisa la versión y extensiones de PHP.
Corrige permisos de archivos y carpetas.
Verifica el .htaccess.
Elimina settings.inc.php si reinstalas.
Aumenta la memoria del servidor.
Como último recurso, reinstala desde cero.

Si después de todo esto sigues con el problema, contacta con tu proveedor de hosting. Diles que necesitas "aumentar el memory_limit de PHP a 256M y activar las extensiones mysqli, curl, gd, openssl, json, mbstring, zip, fileinfo e intl". Con eso, ellos sabrán qué hacer.

Espero que este artículo te haya sido de ayuda. ¡Buena suerte con tu tienda PrestaShop!