Permisos archivos PrestaShop cPanel | Solución

¿Te has encontrado con el temido error permisos PrestaShop al intentar subir un producto, instalar un módulo o simplemente al cargar tu tienda? No te preocupes, es uno de los problemas más comunes al gestionar una tienda online. En esta guía completa y paso a paso, te explicaré cómo resolver problemas de permisos en PrestaShop en cPanel de una manera sencilla, incluso si no eres un experto técnico.

Vamos a desglosar todo lo que necesitas saber: desde entender qué son los permisos hasta cómo cambiar permisos archivos PrestaShop de forma segura para que tu tienda vuelva a funcionar perfectamente.

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

Imagina que tu servidor es un edificio con muchas puertas. Los permisos son las reglas que deciden quién puede abrir cada puerta (leer), quién puede entrar y modificar lo que hay dentro (escribir) y quién puede ejecutar un programa (ejecutar). En PrestaShop, estos permisos controlan cómo el sistema, los módulos y tú mismo interactuáis con los archivos de la tienda.

Si los permisos no son los correctos, pueden aparecer errores como:

“No se puede escribir en la carpeta cache”.
“Error al subir la imagen del producto”.
“Módulo no se puede instalar: error de permisos”.
Pantalla en blanco al intentar guardar cambios.
Mensajes de “Acceso denegado” o “Forbidden”.

Por eso, resolver problemas de permisos en PrestaShop en cPanel es una habilidad fundamental para cualquier dueño de tienda.

Primeros pasos: Accede a tu cPanel y localiza el archivo de PrestaShop

Antes de empezar a cambiar permisos archivos PrestaShop, necesitas acceder a la herramienta principal: cPanel.

Inicia sesión en cPanel: Normalmente accedes a través de tudominio.com/cpanel o la URL que te haya proporcionado tu proveedor de hosting. Introduce tu usuario y contraseña.
Busca el Administrador de Archivos: Una vez dentro, busca el icono de “Administrador de Archivos” (File Manager). Está en la sección de “Archivos” del panel de control.
Navega hasta tu tienda: En el Administrador de Archivos, busca la carpeta public_html (o www). Dentro de ella, busca la carpeta donde instalaste PrestaShop. Por ejemplo, si tu tienda está en tutienda.com, los archivos estarán directamente en public_html. Si está en tutienda.com/tienda, estarán en public_html/tienda.

[TIP] Si no ves la carpeta public_html, busca la carpeta de tu dominio principal. Normalmente es esa.

Cómo cambiar permisos de archivos y carpetas en cPanel (Método visual)

Este es el método más amigable para principiantes. Usaremos la interfaz gráfica de cPanel.

Paso 1: Selecciona los archivos o carpetas

Dentro de la carpeta raíz de tu PrestaShop, verás muchas carpetas como img, modules, themes, override, cache, etc. Para corregir un error específico, es mejor actuar sobre la carpeta o el archivo que da el problema.

Para un archivo específico: Haz clic derecho sobre el archivo y selecciona “Cambiar permisos”.
Para una carpeta entera (y todo su interior): Haz clic derecho sobre la carpeta y elige “Cambiar permisos”. Luego, marca la casilla “Cambiar permisos de subdirectorios” para que se aplique a todo lo que contiene.

Paso 2: Establece los permisos correctos

Se abrirá una ventana con casillas de verificación. Los permisos se representan con tres grupos de números (por ejemplo, 755, 644, 777). Cada número corresponde a:

Usuario (Owner): Tú, el propietario de la tienda.
Grupo (Group): El grupo al que pertenece el usuario.
Público (World): Cualquier persona en internet.

Los valores más comunes y seguros para PrestaShop son:

Para carpetas (directorios): 755 (Lectura y ejecución para todos, escritura solo para el usuario).
Para archivos (como .php, .tpl, .css): 644 (Lectura para todos, escritura solo para el usuario).

¿Cómo se marca?

Permiso 755: Marca Lectura y Ejecución para Usuario, Grupo y Público. Marca Escritura solo para Usuario. El número resultante será 755.
Permiso 644: Marca Lectura para Usuario, Grupo y Público. Marca Escritura solo para Usuario. NO marques Ejecución para nadie. El número será 644.

[WARNING] ¡NUNCA uses el permiso 777 (todos los permisos para todos) en archivos de producción! Es un agujero de seguridad enorme. Solo es aceptable temporalmente en entornos de desarrollo o en carpetas muy concretas como cache o img durante un minuto, y luego debes revertirlo a 755.

Paso 3: Aplica los cambios

Haz clic en “Cambiar permisos”. Si elegiste “Cambiar permisos de subdirectorios”, el proceso puede tardar unos segundos dependiendo del tamaño de tu tienda.

Soluciones rápidas para errores comunes de permisos PrestaShop

Aquí tienes ataques directos a los problemas más frecuentes.

Error: “No se puede escribir en la carpeta cache” o “Error en la compilación”

Este es uno de los errores más típicos.

Localiza la carpeta: En la raíz de tu PrestaShop, busca la carpeta var/cache (en versiones 1.7+) o cache (en versiones 1.6).
Cambia permisos: Haz clic derecho sobre cache (o var/cache), selecciona Cambiar permisos, pon 755 y marca “Cambiar permisos de subdirectorios”.
Borra el contenido: Dentro de cache, hay carpetas como dev, prod, etc. Puedes borrar todo su contenido (no las carpetas, solo los archivos de dentro) para forzar a PrestaShop a regenerar la caché. Esto suele resolver el problema al instante.

Error: “No se puede escribir la imagen” o “Error al subir imágenes de producto”

Las imágenes se guardan en la carpeta img.

Ve a la carpeta img en la raíz de tu tienda.
Cambia permisos: Pon la carpeta img en 755 y, dentro de ella, busca la carpeta p (productos) o c (categorías). Pon también 755 con subdirectorios.
Verifica el dueño: A veces el problema no son los permisos, sino el dueño (owner) de los archivos. Si tu usuario de cPanel es, por ejemplo, usuario1, la carpeta img debe pertenecer a usuario1. Si ves que pertenece a otro usuario (como nobody), puedes cambiarlo desde el Administrador de Archivos: haz clic derecho > Cambiar propietario y pon tu usuario.

Error: “Módulo no se puede instalar o actualizar”

Los módulos necesitan escribir en la carpeta modules y a veces en override.

Carpeta modules: Pon la carpeta modules en 755 (con subdirectorios).
Carpeta override: Si el módulo necesita sobrescribir archivos, la carpeta override debe tener permisos 755.
Carpeta config: A veces el módulo necesita escribir en config/defines.inc.php o en config/settings.inc.php. Asegúrate de que estos archivos tengan 644 (no 444, ya que no podrías escribir).

Solución avanzada: Usar comandos SSH (para usuarios con experiencia)

Si te sientes cómodo con la línea de comandos, esta es la forma más rápida y eficaz de cambiar permisos archivos PrestaShop de forma masiva.

Conéctate por SSH a tu servidor. Necesitarás un cliente como PuTTY (Windows) o la terminal (Mac/Linux). Las credenciales SSH suelen ser las mismas que las de cPanel.
Navega a la carpeta de tu tienda:
```
cd /home/tuusuario/public_html
```
Ejecuta los comandos mágicos:
- Para carpetas (permisos 755):
```
find . -type d -exec chmod 755 {} \;
```
- Para archivos (permisos 644):
```
find . -type f -exec chmod 644 {} \;
```
- Para carpetas especiales que necesitan escritura (como cache, img, modules, override, themes):
```
chmod -R 755 var/cache img modules override themes
```
  (Cambia var/cache por cache si usas PrestaShop 1.6).

[INFO] Estos comandos arreglan el 99% de los problemas de permisos. Son seguros y restauran los valores por defecto de PrestaShop.

Preguntas Frecuentes (FAQ) sobre permisos en PrestaShop y cPanel

¿Cada cuánto debo revisar los permisos?

No es necesario hacerlo a diario. Solo cuando instales un módulo nuevo, actualices PrestaShop, o notes algún error extraño. Es buena práctica hacer una revisión después de una actualización mayor.

¿Qué hago si después de cambiar los permisos sigo teniendo el error?

Limpia la caché: Ve a tu panel de administración de PrestaShop > Parámetros Avanzados > Rendimiento > Forzar compilación y Limpiar caché.
Verifica el dueño: Como mencioné antes, el propietario de los archivos debe coincidir con tu usuario de cPanel.
Desactiva módulos: A veces un módulo conflictivo fuerza errores de permisos. Desactiva todos los módulos no esenciales y vuelve a probar.
Revisa el archivo .htaccess: Un archivo .htaccess corrupto puede bloquear el acceso. Renómbralo a .htaccess_old y luego ve a Parámetros Avanzados > SEO y URLs > Guardar (esto regenerará uno nuevo).

¿Es seguro usar permisos 777 aunque sea por un momento?

Solo en casos muy extremos y por segundos. Por ejemplo, si estás instalando un módulo muy complejo y te pide permisos 777 para una carpeta temporal, puedes hacerlo, pero inmediatamente después revierte a 755. No lo dejes así.

Mi hosting usa Syspanel (HestiaCP), ¿cómo accedo?

Si tu hosting usa Syspanel (el nombre que le damos a HestiaCP), el acceso es diferente. No uses /cpanel. En su lugar, accede a través de tudominio.com:2106. Una vez dentro, busca el Administrador de Archivos en el menú. La lógica para cambiar permisos es la misma que en cPanel, solo cambia la interfaz.

Consejo final: Mantén tu tienda segura

Resolver problemas de permisos en PrestaShop en cPanel es sencillo una vez que entiendes la lógica. Recuerda la regla de oro: lo mínimo necesario. No des más permisos de los que necesita cada carpeta.

Si sigues estos pasos, podrás solucionar la mayoría de los errores que te aparezcan. Y si el problema persiste, no dudes en contactar a tu soporte técnico, pero ahora ya tienes las herramientas para intentarlo por ti mismo.

¡Tu tienda volverá a funcionar en poco tiempo!