Permisos de archivos en PrestaShop: solución a errores comunes

¡Hola! Si estás leyendo esto, seguramente te has topado con un mensaje de error molesto en tu tienda PrestaShop que dice algo como "no se puede escribir en el archivo", "error de permisos" o tu tienda se ve en blanco. No te preocupes, es uno de los problemas más comunes y, por suerte, se soluciona con unos pocos pasos. En esta guía extensa y muy detallada, te voy a explicar exactamente qué son los permisos archivos PrestaShop, por qué ocurren los errores permisos PrestaShop y cómo usar el comando chmod PrestaShop para arreglarlo todo.

Vamos a ir paso a paso, como si estuviera sentado contigo frente a la pantalla. No necesitas ser un experto en hosting, solo tener acceso a tu panel de control o a un cliente FTP.

¿Qué son los permisos de archivos y por qué son importantes en PrestaShop?

Imagina que tu servidor es un edificio de oficinas. Cada archivo y carpeta de tu PrestaShop es una habitación con una puerta que tiene tres cerraduras diferentes. Los permisos son como las llaves que decides darle a cada persona (el usuario del servidor, el grupo y el resto del mundo).

Lectura (r): Permite ver el contenido del archivo.
Escritura (w): Permite modificar o borrar el archivo.
Ejecución (x): Permite ejecutar el archivo (como un script PHP).

PrestaShop necesita ciertos permisos para funcionar correctamente. Por ejemplo, necesita poder escribir en la carpeta cache para guardar las páginas que ya has visitado y que carguen más rápido. Si los permisos son demasiado restrictivos, tu tienda no podrá escribir y te mostrará un error. Si son demasiado permisivos, cualquiera podría modificar tus archivos, lo cual es un peligro de seguridad.

Los errores permisos PrestaShop suelen aparecer cuando:

Instalas o actualizas módulos o temas.
Subes imágenes de productos.
La tienda intenta generar archivos de caché.
Migras tu tienda de un servidor a otro.

Identificando el problema: ¿Qué tipo de error de permisos tienes?

Antes de lanzarnos a cambiar permisos, es importante que sepas qué error concreto estás viendo. Los más comunes son:

### Errores típicos en el Back Office (Panel de administración)

"No se puede escribir en el directorio de imágenes" o "Error al subir la imagen". Esto indica que la carpeta img o sus subcarpetas no tienen permisos de escritura.
"El módulo no se puede instalar/desinstalar". Los módulos necesitan escribir en la carpeta modules y a veces en config.
"Error al generar la caché". La carpeta cache (y sus subcarpetas como cache/smarty y cache/tcpdf) necesita permisos de escritura sí o sí.

### Errores típicos en el Front Office (tu tienda visible al público)

Página en blanco (White Screen of Death). A menudo es por permisos incorrectos en los archivos de configuración.
Imágenes que no se cargan (aparecen rotas). La carpeta img no tiene permisos de lectura para el servidor web.
Errores 500 Internal Server Error. Puede deberse a un archivo .htaccess con permisos incorrectos o a la imposibilidad de escribir en la carpeta log.

Herramientas que necesitas para cambiar los permisos

Vas a necesitar una de estas dos herramientas. Te recomiendo la primera si eres principiante.

### Opción 1: Cliente FTP (FileZilla, Cyberduck, etc.)

Es la forma más visual y segura. Te conectas a tu servidor y ves los archivos como en el explorador de Windows.

Descarga e instala FileZilla (es gratuito).
Conéctate a tu servidor con los datos que te dio tu empresa de hosting (usuario, contraseña, servidor FTP). Si no los tienes, mira en el correo de bienvenida o contacta con el soporte.
Una vez conectado, verás dos paneles: el izquierdo es tu ordenador, el derecho es tu servidor. Navega hasta la carpeta donde está instalado PrestaShop (normalmente se llama public_html, www o htdocs).

### Opción 2: Panel de control (cPanel, Syspanel, Plesk)

Si tu hosting te da acceso a un panel como cPanel o Syspanel (el antiguo HestiaCP, que se accede por el puerto 2106), también puedes cambiar permisos desde el administrador de archivos.

En cPanel: Busca "Administrador de Archivos" (File Manager).
En Syspanel: Accede por tudominio.com:2106, inicia sesión y busca la sección "Archivos" o "Administrador de Archivos".

La solución paso a paso: Cómo usar chmod en PrestaShop

Vamos a arreglarlo. El comando mágico se llama chmod PrestaShop (change mode). Vamos a hacerlo de la forma correcta, sin volvernos locos.

### Paso 1: Conoce la estructura de permisos ideal

PrestaShop recomienda una configuración específica para que funcione bien y sea seguro. La regla general es:

Archivos (como .php, .tpl, .css): Permisos 644 (lectura y escritura para el usuario, solo lectura para el grupo y el resto).
Carpetas (directorios): Permisos 755 (lectura, escritura y ejecución para el usuario; lectura y ejecución para grupo y resto).
Archivos de configuración sensibles (como config/settings.inc.php): Permisos 644 o incluso 444 (solo lectura) después de la instalación.
Carpetas especiales que necesitan escritura: cache, img, log, modules, themes, upload, download, sitemap.xml. Estas deben tener permisos 755 (o 777 en casos extremos, pero no lo recomiendo por seguridad).

[WARNING] Importante: Nunca pongas permisos 777 a todo el sitio. Es como dejar la puerta de tu casa abierta de par en par. Solo hazlo temporalmente si un módulo o tema te lo pide, y luego vuelve a 755.

### Paso 2: Cambiar permisos con FileZilla (el método visual)

En FileZilla, navega a la raíz de tu PrestaShop.
Selecciona todas las carpetas y archivos (puedes usar Ctrl+A). Haz clic derecho y elige "Permisos de archivo...".
Se abrirá una ventana. Aquí tienes que:
- Marcar la casilla "Dirigir a subdirectorios" (Recurse into subdirectories).
- Seleccionar "Aplicar a todos los archivos y directorios" (Apply to all files and directories).
- En la parte numérica (código octal), escribe 755 para las carpetas y 644 para los archivos. Pero ojo, no puedes hacerlo en un solo paso si seleccionas todo junto. Lo mejor es hacerlo por separado.

Método más rápido y seguro para principiantes:

Para las CARPETAS: Selecciona solo las carpetas (puedes filtrar por tipo en FileZilla). Haz clic derecho > Permisos. Marca "Dirigir a subdirectorios", elige "Solo directorios" y escribe 755. Acepta.
Para los ARCHIVOS: Repite el proceso, pero selecciona "Solo archivos" y escribe 644. Acepta.

¡Listo! Has aplicado chmod PrestaShop correctamente.

### Paso 3: Cambiar permisos desde Syspanel (puerto 2106)

Si tu hosting usa Syspanel (HestiaCP), el proceso es igual de sencillo:

Abre tu navegador y ve a tudominio.com:2106.
Inicia sesión con tu usuario y contraseña de Syspanel.
Busca el icono de "Administrador de Archivos" (normalmente es una carpeta).
Navega hasta la carpeta raíz de tu PrestaShop.
Selecciona todos los archivos y carpetas (puedes usar la casilla de selección general).
En la barra superior, busca el botón "Permisos" (o "Chmod").
Te preguntará si quieres aplicar a subcarpetas. Dile que Sí.
En el campo numérico, puedes escribir 755 para todo, pero es mejor que hagas como en FileZilla: primero solo carpetas a 755, luego solo archivos a 644. Syspanel te permite filtrar por tipo de archivo en el administrador.

[TIP] Si no ves la opción de filtrar, pon 755 a todo y luego, manualmente, cambia los archivos .php que sepas que son de configuración a 644. Pero para una solución rápida, 755 en todo suele funcionar.

### Paso 4: Casos especiales (cuando 755 no es suficiente)

A veces, incluso con 755, PrestaShop se queja. Esto suele pasar con las carpetas cache, img y log. En ese caso:

Ve a la carpeta problemática (por ejemplo, cache).
Selecciona TODOS los archivos y subcarpetas dentro de ella.
Cambia los permisos a 777 (pero solo para esa carpeta y de forma temporal).
Prueba tu tienda. Si funciona, es que el problema era que el servidor necesita permisos de escritura total. Inmediatamente después, vuelve a cambiar los permisos de esa carpeta a 755 (dejando los archivos internos en 644). Si con 755 vuelve el error, déjalo en 777 solo para esa carpeta, pero asegúrate de que el resto del sitio esté en 644/755.

Preguntas Frecuentes (FAQ) sobre permisos en PrestaShop

### ¿Por qué después de cambiar los permisos sigue saliendo el error?

Olvidaste limpiar la caché de PrestaShop. Ve a tu Back Office > Parámetros de la tienda > Rendimiento > Limpiar caché. A veces el error se queda "grabado". También puedes borrar manualmente la carpeta cache/smarty/cache y cache/smarty/compile (no las borres, solo su contenido).
El propietario del archivo es incorrecto. No solo importan los permisos, sino a quién pertenecen. Si el usuario del servidor web (www-data, apache, etc.) no es el dueño de los archivos, aunque tengas 777, no podrá escribir. Esto lo soluciona tu hosting o tú si tienes acceso a la terminal (comando chown). Si usas Syspanel, revisa la sección de "Usuarios del sistema".

### ¿Qué permisos debe tener el archivo .htaccess?

El archivo .htaccess debe tener permisos 644 (o 444 si ya no vas a modificarlo). Si lo pones en 755, podría ser un riesgo de seguridad.

### ¿Cómo sé si mi hosting tiene PHP como módulo de Apache o como CGI?

Esto afecta a los permisos. Si tu hosting usa PHP como módulo de Apache (mod_php), los archivos deben ser propiedad del usuario del hosting y los permisos suelen ser 644/755. Si usa PHP como CGI/FastCGI, a menudo necesitas permisos 755 para las carpetas y 644 para los archivos, pero a veces 777 en cache e img. Pregunta a tu soporte técnico si no estás seguro.

### ¿Puedo usar un plugin para arreglar los permisos?

Sí, existen módulos en el marketplace de PrestaShop que escanean y corrigen permisos automáticamente. Sin embargo, es mejor que aprendas a hacerlo manualmente, ya que así entiendes tu servidor y puedes resolver problemas más rápido.

### ¿Qué hago si no tengo acceso FTP ni a Syspanel?

Entonces necesitas contactar con el soporte de tu hosting. Diles: "Necesito que corrijan los permisos de mi PrestaShop a 644 para archivos y 755 para directorios, y que me aseguren que el usuario del servidor web tiene permisos de escritura en las carpetas cache, img y log". Ellos lo harán en segundos.

Conclusión: Ya sabes cómo resolver los problemas de permisos

Como has visto, los errores permisos PrestaShop no son para tanto. Con un poco de paciencia y siguiendo estos pasos, puedes solucionarlos tú mismo sin tener que llamar a un técnico. Recuerda:

Identifica el error (imágenes, caché, módulos).
Conéctate por FTP o a Syspanel (puerto 2106).
Aplica permisos 755 a carpetas y 644 a archivos.
Para casos extremos, usa 777 temporalmente en carpetas específicas.
Limpia la caché de PrestaShop.

Con estos conocimientos, ya eres un pequeño experto en permisos archivos PrestaShop y en el uso del comando chmod PrestaShop. ¡Tu tienda volverá a funcionar como un reloj!

Si te ha quedado alguna duda, repasa los pasos o consulta la FAQ. Y recuerda: en el mundo del hosting, la paciencia y el orden son tus mejores aliados. ¡Buena suerte con tu tienda!