Permisos de archivos en PrestaShop: Guía para corregirlos

¿Por qué aparecen errores de permisos en PrestaShop?

Si estás leyendo esto, probablemente te has encontrado con mensajes como "No se puede escribir en el archivo", "Error al crear carpeta" o una pantalla en blanco tras intentar actualizar tu tienda. No te preocupes: los errores de permisos en PrestaShop son uno de los problemas más comunes y, afortunadamente, tienen solución.

Los permisos de archivos determinan quién puede leer, escribir o ejecutar cada archivo y carpeta de tu servidor. Cuando estos permisos no son los correctos, PrestaShop no puede crear archivos de caché, subir imágenes de productos, instalar módulos o actualizar la tienda. En este artículo te explicaré paso a paso cómo solucionarlo, incluso si no eres un experto técnico.

¿Qué son exactamente los permisos de archivos?

En un servidor Linux (el más habitual en hosting), cada archivo y carpeta tiene tres tipos de permisos:

Lectura (r): Permite ver el contenido del archivo.
Escritura (w): Permite modificar o eliminar el archivo.
Ejecución (x): Permite ejecutar el archivo si es un script.

Estos permisos se asignan a tres grupos de usuarios:

Propietario (dueño del archivo)
Grupo (usuarios del grupo al que pertenece el archivo)
Otros (el resto de usuarios)

Para simplificar, en el mundo del hosting se usa una notación numérica llamada chmod. Por ejemplo, chmod 755 significa que el propietario tiene permisos completos (7 = lectura + escritura + ejecución), y el grupo y otros solo lectura y ejecución (5 = lectura + ejecución).

[INFO] En PrestaShop, los archivos suelen necesitar permisos 644 y las carpetas 755. Sin embargo, hay excepciones que veremos más adelante.

Síntomas comunes de errores de permisos en PrestaShop

Antes de lanzarte a cambiar permisos, identifica si tu problema realmente está relacionado con esto. Estos son los síntomas más típicos:

Error al subir imágenes: No puedes añadir fotos a productos o categorías.
Error al instalar o desinstalar módulos: La tienda no permite modificar su estructura.
Error al vaciar la caché: Aparece un mensaje indicando que no se puede eliminar la carpeta var/cache.
Pantalla en blanco al intentar acceder al panel de administración.
Error al actualizar PrestaShop: El proceso de actualización se detiene a mitad.
No se pueden crear archivos de log o de configuración.

Si tienes alguno de estos síntomas, sigue leyendo. Vamos a por la solución.

Cómo comprobar los permisos actuales de tus archivos

Para saber qué permisos tienen tus archivos, puedes usar dos métodos: el administrador de archivos de tu hosting o un cliente FTP como FileZilla.

Usando el administrador de archivos del hosting

La mayoría de los paneles de control (cPanel, Plesk, Syspanel, etc.) incluyen un administrador de archivos gráfico. Si tu hosting usa Syspanel (recuerda que se accede por el puerto 2106), busca la opción "Administrador de archivos".

Accede a tu panel de control (por ejemplo, https://tu-dominio.com:2106 para Syspanel).
Entra en el administrador de archivos.
Navega hasta la carpeta raíz de tu PrestaShop.
Haz clic derecho sobre un archivo o carpeta y selecciona "Permisos" o "Cambiar permisos".

Usando FileZilla (FTP)

Si prefieres FTP:

Conecta con FileZilla a tu servidor usando tus credenciales FTP.
Navega hasta la carpeta donde está instalado PrestaShop.
Haz clic derecho sobre un archivo y selecciona "Permisos de archivo".
Verás una ventana con casillas y un campo numérico.

[TIP] Anota los permisos que tienen actualmente los archivos antes de cambiarlos. Así podrás revertir los cambios si algo sale mal.

La solución definitiva: los permisos correctos para PrestaShop

Ahora vamos a lo importante. PrestaShop necesita permisos específicos para funcionar correctamente. Esta es la configuración recomendada:

Permisos para archivos

Archivos PHP (como index.php, config.php): 644
Archivos de configuración (como parameters.php): 644
Archivos .htaccess: 644

Permisos para carpetas

Carpetas raíz (como admin, modules, themes): 755
Carpeta var (contiene caché y logs): 755 (a veces 775)
Carpetas de caché (var/cache, var/logs): 755 o 775
Carpeta img (imágenes de productos): 755
Carpeta download (archivos descargables): 755
Carpeta upload (si existe): 755

Excepciones importantes

Si tu servidor usa PHP como módulo de Apache (lo más común), los archivos deben ser propiedad de tu usuario FTP. En este caso, 644 y 755 son suficientes.
Si usas PHP-FPM o CGI, a veces necesitas permisos 775 en carpetas y 664 en archivos para que el servidor web pueda escribir.

[WARNING] Nunca uses permisos 777 en producción. Aunque "arreglan" temporalmente los problemas, dejan tu tienda expuesta a ataques de seguridad. Úsalos solo de forma temporal y revierte los cambios después.

Cómo cambiar los permisos paso a paso

Método 1: Desde el administrador de archivos de Syspanel

Si tu hosting usa Syspanel, este método es el más fácil:

Accede a Syspanel usando el puerto 2106 (ejemplo: https://tu-dominio.com:2106).
Ve a la sección "Archivos" o "Administrador de archivos".
Navega hasta la raíz de tu PrestaShop.
Selecciona todos los archivos y carpetas (Ctrl+A o el botón de seleccionar todo).
Haz clic en "Cambiar permisos".
Introduce 755 para carpetas y 644 para archivos. Algunos paneles te permiten aplicar permisos recursivos (a todas las subcarpetas).
Aplica los cambios y espera a que termine el proceso.

Método 2: Desde FileZilla (FTP)

Este método es muy visual y funciona con cualquier hosting:

Abre FileZilla y conéctate a tu servidor.
En el panel derecho, navega hasta la carpeta raíz de PrestaShop.
Selecciona todos los archivos y carpetas (Ctrl+A).
Haz clic derecho y elige "Permisos de archivo".
Marca las casillas: Lectura y Escritura para propietario, Lectura para grupo y otros (esto da 644).
Para carpetas, marca también Ejecución para propietario, grupo y otros (esto da 755).
Marca la opción "Aplicar a todos los archivos y directorios" (recursivo).
Haz clic en "Aceptar".

[INFO] Si FileZilla te da error al aplicar permisos a muchas carpetas, hazlo por partes: primero todas las carpetas y luego todos los archivos.

Método 3: Usando comandos SSH (solo para avanzados)

Si tienes acceso SSH, puedes hacerlo con un solo comando:

find /ruta/a/tu/prestashop -type f -exec chmod 644 {} \;
find /ruta/a/tu/prestashop -type d -exec chmod 755 {} \;

Este comando aplica 644 a todos los archivos y 755 a todas las carpetas de forma recursiva.

¿Qué hago si después de cambiar permisos sigue el error?

Si has cambiado los permisos y el problema persiste, puede que la causa sea otra. Vamos a repasar las alternativas más comunes:

1. Verifica el propietario de los archivos

A veces los permisos son correctos, pero el propietario de los archivos no es el adecuado. En la mayoría de los hosting compartidos, el propietario debe ser tu usuario FTP.

En FileZilla, mira la columna "Propietario" o "Owner".
Si los archivos pertenecen a otro usuario (por ejemplo, nobody o www-data), necesitarás contactar con tu proveedor de hosting para que lo cambie.

2. Desactiva el modo de mantenimiento

PrestaShop a veces bloquea la tienda si detecta problemas de permisos. Accede a tu panel de administración y desactiva el modo de mantenimiento:

Ve a Parámetros avanzados > Mantenimiento.
Desactiva "Activar modo de mantenimiento".
Guarda los cambios.

3. Borra manualmente la carpeta de caché

Si la caché está corrupta, a veces no se regenera aunque los permisos sean correctos:

Conecta por FTP o administrador de archivos.
Navega a var/cache (en PrestaShop 1.7) o cache (en PrestaShop 1.6).
Elimina el contenido de la carpeta (no la carpeta en sí).
Vuelve a intentar acceder a tu tienda.

[TIP] Si no puedes borrar la caché, renombra la carpeta a cache_old y crea una nueva carpeta vacía llamada cache con permisos 755.

4. Comprueba los permisos de la carpeta `config`

En PrestaShop 1.7, el archivo config/parameters.php es crítico. Asegúrate de que:

Tiene permisos 644.
Es propiedad de tu usuario FTP.
No está vacío (debe contener las credenciales de la base de datos).

Si este archivo está dañado, tu tienda dará un error de conexión a la base de datos.

Errores específicos y sus soluciones

Error: "No se puede escribir en la carpeta img"

Este error es típico al subir imágenes de productos. Solución:

Ve a la carpeta img de tu PrestaShop.
Cambia los permisos a 755.
Si sigue fallando, prueba con 775 temporalmente.
Asegúrate de que la carpeta img/p (para productos) también tenga 755.

Error: "No se puede instalar el módulo"

Al instalar módulos, PrestaShop necesita escribir en varias carpetas:

modules/ (para copiar el módulo)
var/cache (para actualizar la caché)
config/ (para registrar el módulo)

Verifica que todas tengan permisos 755 y que el propietario sea tu usuario FTP.

Error: "No se puede actualizar PrestaShop"

Las actualizaciones son especialmente sensibles a los permisos. Antes de actualizar:

Pon todos los archivos y carpetas a 755 (temporalmente).
Realiza la actualización.
Vuelve a poner los permisos recomendados (644 archivos, 755 carpetas).

[WARNING] Durante la actualización, nunca uses permisos 777 en toda la tienda. Solo en las carpetas que el actualizador te indique.

Cómo evitar futuros errores de permisos

La prevención es clave. Sigue estos consejos:

Usa siempre FTP con tu usuario propio: Evita conectarte como "root" o "admin".
No cambies permisos de forma masiva sin necesidad: Si todo funciona, no toques nada.
Haz copias de seguridad antes de cambiar permisos: Aunque es raro, un cambio incorrecto puede romper tu tienda.
Mantén PrestaShop actualizado: Las versiones nuevas suelen corregir problemas de permisos en el código.
Usa un hosting compatible: Algunos proveedores tienen configuraciones especiales que requieren permisos distintos.

Preguntas frecuentes (FAQ)

¿Puedo usar permisos 777 para arreglar mi tienda rápido?

No es recomendable. Aunque funciona temporalmente, expone tu tienda a vulnerabilidades de seguridad. Úsalo solo como último recurso y revierte los cambios inmediatamente después.

¿Por qué mis archivos cambian de permisos solos?

Esto suele ocurrir por:

El servidor web (Apache/Nginx) modificando archivos.
Scripts de seguridad del hosting.
Actualizaciones automáticas de PrestaShop.

Si ocurre con frecuencia, contacta con tu proveedor de hosting.

¿Qué diferencia hay entre 755 y 775?

755: El propietario tiene todos los permisos; grupo y otros solo lectura y ejecución.
775: El propietario y el grupo tienen todos los permisos; otros solo lectura y ejecución.

Usa 775 si tu servidor usa PHP-FPM y el grupo del servidor web necesita escribir.

¿Cómo sé si mi servidor usa PHP como módulo o PHP-FPM?

Puedes verificarlo en el panel de control de tu hosting. En Syspanel, busca la sección "PHP" o "Versión de PHP". Si no lo encuentras, contacta con soporte.

¿Los permisos afectan al SEO de mi tienda?

Indirectamente sí. Si los errores de permisos provocan páginas en blanco o tiempos de carga lentos, Google penalizará tu sitio. Además, si no puedes actualizar módulos o contenido, tu tienda se estancará.

Conclusión final

Los errores de permisos en PrestaShop son frustrantes, pero casi siempre tienen solución. La clave está en usar los permisos correctos (644 para archivos, 755 para carpetas) y asegurarte de que el propietario sea tu usuario FTP. Si sigues los pasos de esta guía, podrás resolver el problema en la mayoría de los casos.

Recuerda que si tu hosting usa Syspanel, puedes gestionar los permisos desde su administrador de archivos accediendo por el puerto 2106. Y si después de todo sigues con problemas, no dudes en contactar con tu proveedor de hosting: a veces el problema está en la configuración del servidor y no en tu tienda.

[TIP] Guarda esta guía en tus favoritos. Los problemas de permisos tienden a repetirse, especialmente después de actualizaciones o cambios de servidor. Con un poco de práctica, podrás resolverlos en menos de 10 minutos.