Permisos de archivos PrestaShop | DirectAdmin

¿Tu tienda PrestaShop te está dando dolores de cabeza con errores de permisos? No te preocupes, es uno de los problemas más comunes al gestionar una tienda online, especialmente cuando usas un panel de control como DirectAdmin. Ver mensajes como "No se puede escribir en el archivo de caché" o "Error al subir la imagen" puede ser frustrante, pero la solución es más sencilla de lo que parece. En esta guía extensa y paso a paso, te voy a explicar exactamente cómo resolver los problemas de permisos prestashop en un entorno DirectAdmin, sin necesidad de ser un experto en Linux.

Vamos a desglosar todo, desde qué son estos permisos hasta cómo corregirlos de forma segura, evitando errores futuros. Al final, serás capaz de diagnosticar y arreglar los típicos errores escritura prestashop tú mismo.

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

Antes de lanzarnos a los comandos, es crucial entender el concepto. En un servidor Linux (que es lo que usa la mayoría del hosting, incluido DirectAdmin), cada archivo y carpeta tiene un "propietario" y un conjunto de permisos. Estos permisos definen quién puede leer, escribir (modificar) o ejecutar (ejecutar scripts como PHP) cada archivo.

Piensa en ello como las cerraduras de tu tienda: el propietario es el dueño, el grupo son los empleados y el resto son los clientes. Si las cerraduras (permisos) están mal configuradas, los empleados (el servidor web) no podrán entrar a la trastienda (escribir archivos de caché, subir productos, etc.).

PrestaShop es una aplicación muy dinámica que necesita crear y modificar archivos constantemente: caché de Smarty, logs, imágenes subidas por ti, archivos de configuración, etc. Si los permisos prestashop no son los correctos, la tienda falla al intentar escribir en esos archivos, generando los temidos errores escritura prestashop.

La Configuración Correcta (La Regla de Oro)

Para PrestaShop 1.6, 1.7 y 8.x, la configuración estándar y segura es la siguiente:

Archivos (ficheros): Permisos 644. Esto significa que el propietario puede leer y escribir, y el grupo y otros solo pueden leer.
Carpetas (directorios): Permisos 755. El propietario puede leer, escribir y entrar, y el grupo y otros pueden leer y entrar.

Pero, ¿a quién pertenecen estos archivos? Aquí está el quid de la cuestión. Deben pertenecer al usuario de FTP/SSH que tienes en DirectAdmin. Normalmente, si tu dominio es mitienda.com, tu usuario será algo como mitiend o similar. La clave es que el propietario de los archivos debe ser tu usuario de DirectAdmin, no root ni nobody.

Diagnóstico: ¿Cómo saber si el problema son los permisos?

Antes de cambiar nada, vamos a confirmar que el problema es efectivamente de directadmin permisos y no otra cosa (como un error de PHP o una base de datos corrupta). Los síntomas típicos son:

Errores de caché: "Error: No se puede escribir en el archivo de caché" o "El directorio de caché no es escribible".
Problemas al subir imágenes: Al intentar subir el logo o fotos de productos, sale un error genérico.
No se guardan los cambios: Modificas un ajuste en el panel de administración y al recargar, el cambio no se ha guardado.
Pantalla en blanco (WSOD): A veces, un permiso incorrecto en un archivo crítico puede causar una página completamente en blanco.
Errores en el instalador de módulos: No puedes instalar o desinstalar módulos y temas.

Cómo comprobarlo con el Administrador de Archivos de DirectAdmin

La forma más visual y fácil para no expertos es usar el Administrador de Archivos integrado en DirectAdmin. Sigue estos pasos:

Accede a tu panel de DirectAdmin (normalmente en https://tu-dominio.com:2222).
Busca el icono "Administrador de Archivos" (File Manager).
Navega hasta la carpeta donde está instalado PrestaShop. Suele ser domains/tudominio.com/public_html.
Haz clic derecho sobre una carpeta, por ejemplo var/cache, y selecciona "Cambiar permisos" o "Permisos".
Verás una ventana con casillas de verificación. Comprueba si los valores numéricos (como 755 o 644) coinciden con los esperados. Si ves algo como 000, 600 o 444, tienes un problema.

También puedes usar el acceso SSH (si lo tienes) y ejecutar el comando ls -la en la carpeta de PrestaShop para ver los permisos en formato simbólico (-rw-r--r-- para 644, drwxr-xr-x para 755).

Solución Paso a Paso: Corrigiendo los Permisos en DirectAdmin

Ahora sí, vamos a arreglarlo. Tienes dos opciones principales: usar el Administrador de Archivos (para cambios puntuales) o usar SSH (para una corrección masiva y rápida). Te recomiendo la segunda si tienes acceso, pero te explico ambas.

Método 1: Corregir Permisos con el Administrador de Archivos (Manual)

Este método es útil si solo tienes unos pocos archivos problemáticos, pero es tedioso para toda la tienda.

En el Administrador de Archivos, selecciona todos los archivos y carpetas de tu instalación de PrestaShop. Puedes usar Ctrl+A dentro de la carpeta public_html.
Haz clic en el botón "Cambiar permisos" en la barra superior.
En la ventana emergente, verás una opción para aplicar los permisos de forma recursiva (a todas las subcarpetas y archivos). Asegúrate de marcar la casilla "Recursivo".
Primero, establece los permisos para carpetas. Pon el valor 755 y aplica.
Después, repite el proceso, pero esta vez selecciona solo los archivos (puede que tengas que hacerlo en dos partes si el gestor no distingue). En la misma ventana, pon el valor 644 y aplica de forma recursiva.

[WARNING]
Este método manual es propenso a errores si no seleccionas bien. Si marcas 755 en todos los archivos (incluidos los .php), no es un problema grave, pero no es lo más óptimo. La mejor práctica es 644 para archivos y 755 para carpetas.

Método 2: La Solución Rápida y Efectiva con SSH (Recomendado)

Si tu plan de hosting incluye acceso SSH, esta es la forma más limpia y rápida. Conecta a tu servidor usando un cliente como PuTTY (en Windows) o la terminal (en Mac/Linux).

Una vez conectado, navega a la raíz de tu tienda:

cd ~/domains/tudominio.com/public_html

Paso 1: Cambiar propietario (Opcional pero muy importante)

Asegúrate de que todos los archivos te pertenecen a ti (tu usuario de DirectAdmin). Ejecuta:

chown -R tu_usuario:tu_usuario .

Reemplaza tu_usuario por tu nombre de usuario real de DirectAdmin. El punto . significa "aquí, en esta carpeta".

Paso 2: Establecer permisos de carpetas a 755

find . -type d -exec chmod 755 {} \;

Este comando busca todas las carpetas (-type d) y les aplica el permiso 755.

Paso 3: Establecer permisos de archivos a 644

find . -type f -exec chmod 644 {} \;

Este comando hace lo mismo pero con todos los archivos (-type f), aplicándoles 644.

[TIP]
Estos dos comandos find son la solución mágica para el 90% de los problemas de permisos prestashop. Son rápidos y hacen exactamente lo que necesitas.

Paso 4: Permisos especiales para carpetas de escritura

PrestaShop necesita que algunas carpetas sean escribibles por el servidor web, pero al ser propietario, con 755 es suficiente en la mayoría de los casos con PHP-FPM (que es lo que usa DirectAdmin). Si sigues teniendo errores en var/cache, img, log o config, dales permisos más flexibles:

chmod -R 775 var/ img/ log/ config/ download/ upload/

[INFO]
El permiso 775 permite que el grupo (que suele ser el del servidor web) también escriba. Es un buen equilibrio entre seguridad y funcionalidad para las carpetas dinámicas.

Errores Comunes y Soluciones Específicas

A veces, aunque tengas los permisos correctos, el problema persiste. Aquí tienes los casos más especiales.

El problema de la caché de Smarty

Si el error persiste en la caché, no basta con cambiar permisos. Debes vaciar la caché. Puedes hacerlo desde el panel de administración en Parámetros Avanzados > Rendimiento, pero si el error impide acceder, hazlo por FTP o SSH:

rm -rf var/cache/*

O si usas PrestaShop 1.6:

rm -rf cache/smarty/compile/*
rm -rf cache/smarty/cache/*

El problema de los archivos "nobody" o "apache"

Si al ejecutar ls -la ves que los archivos pertenecen a nobody o apache, significa que el servidor web los creó. Esto pasa a menudo con los archivos subidos por el panel de administración. La solución es cambiar el propietario de nuevo a tu usuario:

chown -R tu_usuario:tu_usuario .

Después, vuelve a aplicar los comandos find para asegurar los permisos.

El problema de los módulos que no se instalan

Muchos módulos fallan porque la carpeta modules no es escribible. Asegúrate de que tiene 755 y que es tuya. Si el módulo necesita escribir durante la instalación, puedes darle 775 temporalmente.

chmod -R 775 modules/

Una vez instalado, vuelve a poner 755 para mayor seguridad.

El error de subida de imágenes (máximo de tamaño)

A veces no es un problema de permisos, sino de límite de PHP. Pero si te sale "Error al copiar la imagen", revisa que la carpeta img tenga permisos 755 y que el propietario sea correcto. También verifica que tienes espacio en disco.

Cómo evitar futuros problemas de permisos en PrestaShop

Prevenir es mejor que curar. Aquí tienes algunas buenas prácticas:

Configura bien el FTP: Cuando subas archivos con FileZilla, asegúrate de que está configurado para usar "Solo transferencia binaria" y que los permisos predeterminados son 644 para archivos y 755 para carpetas.
Evita usar el panel de administración para editar archivos: Si necesitas cambiar un archivo .tpl o .php, hazlo por FTP y luego cambia los permisos a 644. No lo dejes en 777 (permisos universales de escritura) porque es un agujero de seguridad enorme.
Actualiza PrestaShop con cuidado: Las actualizaciones a veces cambian los permisos. Después de actualizar, ejecuta siempre los comandos find para restablecerlos.
Revisa los logs: Si vuelve a ocurrir, mira el archivo de logs de tu dominio en DirectAdmin (en la sección "Logs") para ver exactamente qué carpeta está dando el error.

[WARNING]
Nunca, jamás, pongas todos los permisos en 777. Esto permite que cualquier usuario del servidor (o un hacker) modifique tus archivos. Es la causa número uno de sitios pirateados. Si necesitas 777, es mejor que uses 775 y ajustes el grupo.

Preguntas Frecuentes (FAQ) sobre Permisos en PrestaShop

P: ¿Qué permisos debe tener el archivo settings.inc.php?
R: En PrestaShop 1.6, este archivo debe tener permisos 644 (lectura y escritura para el propietario, y solo lectura para los demás). Debe ser propiedad de tu usuario de DirectAdmin. En PrestaShop 1.7 y 8, esta configuración está en la base de datos, así que no hay un archivo crítico equivalente, pero los permisos generales de config/ deben ser 755.

P: ¿Por qué DirectAdmin muestra permisos como 750 y no 755?
R: Algunos servidores tienen una configuración de seguridad más estricta (con umask). 750 significa que el grupo no puede escribir, pero sí leer y ejecutar. Es válido, pero para evitar problemas con el servidor web, es más seguro usar 755 o 775 en las carpetas dinámicas.

P: He cambiado los permisos y ahora la tienda está en blanco. ¿Qué hago?
R: No entres en pánico. Vuelve a conectar por SSH y ejecuta exactamente los comandos que te di antes:

find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;

Recuerda que el propietario debe ser tu usuario. Si sigue en blanco, el problema no es de permisos, sino de PHP (revisa la versión de PHP en DirectAdmin) o de un error de sintaxis en un archivo que hayas modificado.

P: Mi tienda usa "Syspanel" (antes conocido como HestiaCP), ¿es diferente?
R: Si tu hosting usa Syspanel, el puerto de acceso al panel es el 2106 en lugar del 2222. La lógica de los permisos es exactamente la misma, ya que ambos paneles usan Linux. Los comandos chmod y chown que te he explicado funcionan de forma idéntica. La única diferencia es la interfaz gráfica para acceder a los archivos, pero el concepto de directadmin permisos (o permisos en Syspanel) es universal en servidores Linux.

P: ¿Cada cuánto tiempo debo revisar los permisos?
R: No hay una regla fija. Te recomiendo hacerlo después de cada actualización mayor de PrestaShop, después de instalar varios módulos nuevos o si empiezas a ver errores de escritura. Una revisión mensual con los comandos find es una buena rutina de mantenimiento.

Conclusión: Domina los Permisos y Olvídate de los Errores

Resolver los problemas de permisos prestashop en DirectAdmin no es una ciencia espacial. Con los dos comandos mágicos de find y un poco de comprensión sobre el propietario de los archivos, puedes solucionar el 99% de los errores escritura prestashop. Recuerda siempre la regla de oro: archivos 644, carpetas 755, y todo debe pertenecer a tu usuario de DirectAdmin.

La próxima vez que veas un error de caché o de subida de imágenes, ya sabes qué hacer: conecta por SSH, ejecuta los comandos, limpia la caché y listo. Si no tienes SSH, el Administrador de Archivos de DirectAdmin es tu aliado, aunque sea un poco más lento.

Espero que esta guía te haya sido de gran ayuda. Si has seguido todos los pasos y aún tienes problemas, no dudes en contactar con tu proveedor de hosting, pero ahora podrás explicarles exactamente qué has hecho y en qué punto exacto falla, lo que acelerará muchísimo la solución. ¡A vender se ha dicho!