Permisos archivos PrestaShop | Arreglar errores

¡Hola! Soy tu técnico de soporte amigable. ¿Tienes problemas con tu tienda PrestaShop? No te preocupes, uno de los errores más comunes que vemos está relacionado con los permisos de archivos y carpetas. Es frustrante, pero te prometo que con esta guía lo solucionarás paso a paso.

Vamos a explicar de forma clara y sencilla cómo funcionan los permisos PrestaShop, cómo usar el comando chmod PrestaShop para corregirlos, y qué hacer cuando aparece el temido error escritura o no puedes subir imágenes PrestaShop. Todo esto, con un tono didáctico y sin tecnicismos complicados.

¿Por qué son importantes los permisos en PrestaShop?

PrestaShop es un software que necesita leer, escribir y ejecutar archivos en tu servidor para funcionar. Por ejemplo, cuando subes un producto, el sistema debe guardar la imagen en una carpeta. Si los permisos no son los correctos, el sistema no puede hacerlo y te muestra un error.

Los permisos se representan con números, como 755 o 644. Piensa en ellos como una "cerradura" para cada archivo o carpeta:

Lectura (4): El archivo se puede ver.
Escritura (2): El archivo se puede modificar o eliminar.
Ejecución (1): El archivo se puede ejecutar (solo para programas).

La suma de estos números da el permiso. Por ejemplo, 7 = 4+2+1 (lectura, escritura y ejecución). 5 = 4+1 (lectura y ejecución). 6 = 4+2 (lectura y escritura).

En PrestaShop, los archivos suelen necesitar 644 (lectura y escritura para el dueño, solo lectura para los demás) y las carpetas 755 (lectura, escritura y ejecución para el dueño, lectura y ejecución para los demás).

[INFO] Los permisos incorrectos son la causa más común del error escritura al instalar módulos, subir imágenes o actualizar la tienda.

Cómo identificar un problema de permisos

Antes de lanzarte a cambiar permisos, primero debes saber si ese es realmente el problema. Aquí tienes las señales más claras:

Error al subir imágenes: Cuando intentas agregar una imagen a un producto y recibes un mensaje como "Error: no se puede escribir en el directorio".
Error al instalar módulos o temas: Aparece un mensaje de "No se puede escribir en la carpeta".
La tienda se ve en blanco o con errores: A veces, un permiso incorrecto en un archivo clave provoca que la web no cargue.
No se pueden generar miniaturas: Las imágenes de productos no se muestran correctamente.

Si tienes alguno de estos síntomas, sigue leyendo. Vamos a solucionarlo.

Solución paso a paso: Corregir permisos con chmod

El comando chmod (change mode) es la herramienta que usaremos para cambiar los permisos. Puedes hacerlo desde el panel de control de tu hosting (como cPanel, Syspanel o un FTP) o mediante la línea de comandos (SSH).

Opción 1: Desde el panel de control (recomendado para principiantes)

Si tu hosting usa Syspanel (recuerda, el acceso es por el puerto 2106), o cPanel, suele tener un gestor de archivos visual.

Accede a tu panel de control: Por ejemplo, si usas Syspanel, ve a https://tudominio.com:2106 e inicia sesión.
Abre el gestor de archivos: Busca la opción "Archivos" o "File Manager".
Navega a la carpeta de PrestaShop: Normalmente es public_html o www.
Selecciona todas las carpetas y archivos: Puedes hacerlo con Ctrl+A (Windows) o Cmd+A (Mac).
Busca la opción "Cambiar permisos" o "chmod": En cPanel suele estar en el menú de la derecha. En Syspanel, puede estar en un botón de "Propiedades".
Establece los permisos correctos:
- Para carpetas: 755.
- Para archivos: 644.
Aplica los cambios y confirma.

[TIP] Si tu hosting tiene la opción "Aplicar a subcarpetas", actívala para que los cambios se propaguen a todo el interior.

Opción 2: Desde FTP (FileZilla, Cyberduck, etc.)

Si prefieres usar un cliente FTP:

Conéctate a tu servidor con tus credenciales FTP.
Selecciona la carpeta raíz de PrestaShop (normalmente public_html).
Haz clic derecho sobre la carpeta y elige "Atributos de archivo" o "File permissions".
Marca las casillas según el permiso que necesites:
- Para carpetas: Marca "Lectura", "Escritura" y "Ejecución" para el dueño; solo "Lectura" y "Ejecución" para grupo y públicos (esto da 755).
- Para archivos: Marca "Lectura" y "Escritura" para el dueño; solo "Lectura" para grupo y públicos (esto da 644).
Selecciona "Aplicar a subdirectorios" y elige "Solo directorios" para carpetas, o "Solo archivos" para archivos. Repite el proceso dos veces (una para carpetas, otra para archivos).

[WARNING] No uses 777 (permisos totales) a menos que sea estrictamente necesario y solo temporalmente. Es un riesgo de seguridad.

Opción 3: Desde SSH (avanzado)

Si tienes acceso SSH, es más rápido. Conéctate y ejecuta:

# Para carpetas (755)
find /ruta/a/prestashop -type d -exec chmod 755 {} \;

# Para archivos (644)
find /ruta/a/prestashop -type f -exec chmod 644 {} \;

Reemplaza /ruta/a/prestashop con la ruta real (ej: /home/usuario/public_html).

Permisos especiales: Las carpetas que necesitan 777

Aunque la regla general es 755/644, hay algunas carpetas que PrestaShop necesita con permisos de escritura total (777) para funcionar correctamente. Esto es común cuando ves el error escritura al subir imágenes o instalar módulos.

Estas carpetas deben tener 777:

/img – Para subir imágenes de productos, categorías, etc.
/mails – Para que el sistema pueda escribir plantillas de correo.
/modules – Para instalar y actualizar módulos.
/themes – Para instalar y modificar temas.
/translations – Para traducciones.
/upload – Para subir archivos.
/download – Para productos descargables.
/sitemap.xml – No es carpeta, pero el archivo necesita permisos de escritura.

También el archivo /config/settings.inc.php (o parameters.php en versiones modernas) debe tener 644 o 777 temporalmente durante la instalación.

[TIP] Si no puedes subir imágenes PrestaShop, céntrate en la carpeta /img y sus subcarpetas. Dale 777 y prueba de nuevo.

Cómo cambiar a 777

Sigue los mismos pasos que antes, pero en lugar de 755, pon 777. Recuerda: solo para las carpetas mencionadas.

¿Qué hacer si el error persiste?

A veces, incluso con los permisos correctos, el problema sigue. Aquí tienes más causas y soluciones:

1. Propietario de los archivos (owner)

Los permisos no sirven de nada si el dueño del archivo no es el usuario del servidor web (normalmente www-data, nobody o apache). En muchos hostings compartidos, esto se configura automáticamente, pero si usas un VPS, puede que necesites cambiarlo.

Desde SSH, usa:

chown -R www-data:www-data /ruta/a/prestashop

Reemplaza www-data por el usuario de tu servidor (pregunta a tu soporte si no sabes).

2. Modo de seguridad de PHP

Algunos hostings tienen activado open_basedir o disable_functions que bloquean la escritura. Contacta a tu proveedor de hosting para verificarlo.

3. Espacio en disco

A veces el error no es de permisos, sino de que no hay espacio. Revisa tu panel de control.

4. Cache de PrestaShop

Después de cambiar permisos, limpia la caché de PrestaShop: ve a Parámetros Avanzados > Rendimiento y haz clic en "Limpiar caché".

Preguntas frecuentes (FAQ)

¿Puedo usar 777 en todas las carpetas?

No. Es un riesgo de seguridad enorme. Solo úsalo en las carpetas que mencionamos y cámbialo de vuelta a 755 cuando termines.

¿Cada cuánto debo revisar los permisos?

Solo cuando tengas errores. Si tu tienda funciona bien, no toques nada.

¿El error "no se puede escribir en el directorio" siempre es por permisos?

Casi siempre, sí. Pero también puede ser por falta de espacio en disco o por un bloqueo de seguridad del hosting.

Uso Syspanel, ¿cómo accedo al gestor de archivos?

Entra a https://tudominio.com:2106 con tus credenciales de Syspanel. Luego ve a "Archivos" > "Gestor de archivos". Ahí podrás cambiar permisos fácilmente.

¿Qué hago si no veo la opción de permisos en mi panel?

Algunos paneles básicos no lo muestran. En ese caso, usa un cliente FTP como FileZilla.

Resumen rápido: Checklist para solucionar problemas de permisos

Identifica el error: ¿Es al subir imágenes, instalar módulos o al cargar la tienda?
Cambia permisos generales: Carpetas a 755, archivos a 644.
Da 777 a carpetas especiales: /img, /modules, /themes, /mails, etc.
Verifica el propietario: Asegúrate de que el usuario del servidor web sea el dueño.
Limpia la caché de PrestaShop.
Prueba de nuevo.

Si después de todo esto sigues con el error, contacta a tu soporte técnico. Pero te aseguro que el 90% de los casos se solucionan con los pasos de esta guía.

[INFO] Recuerda: los permisos PrestaShop son como las llaves de tu tienda. Si están bien puestas, todo funciona. Si no, toca ajustarlas.

Espero que este artículo te haya sido de ayuda. ¡Ahora ya sabes cómo solucionar el error escritura y subir imágenes PrestaShop sin problemas! Si tienes dudas, déjalas en los comentarios y te responderé encantado.