Permisos de archivos en PrestaShop: errores y correcciones en Plesk

Introducción: ¿Por qué aparecen errores de permisos en PrestaShop con Plesk?

Si alguna vez has visto un mensaje como "Error de escritura en el directorio /cache" o "No se puede crear el archivo /config/settings.inc.php" en tu tienda PrestaShop, probablemente estés enfrentando un problema de permisos de archivos. Esto es especialmente común cuando el servidor usa Plesk como panel de control, ya que la configuración de usuarios y grupos puede diferir de otros entornos.

En este artículo, aprenderás a identificar, diagnosticar y solucionar los problemas de permisos archivos PrestaShop Plesk de forma segura y efectiva. Incluye comandos chmod PrestaShop, pasos para corregir errores escritura PrestaShop y buenas prácticas para evitar futuros bloqueos.

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

En sistemas Linux (donde suele funcionar Plesk), cada archivo y carpeta tiene tres niveles de permisos: lectura (r), escritura (w) y ejecución (x). Estos se asignan a tres grupos de usuarios: propietario (owner), grupo (group) y otros (others).

PrestaShop necesita que ciertos directorios sean escribibles por el servidor web (Apache o Nginx) para funcionar correctamente. Por ejemplo:

/cache: guarda archivos temporales de plantillas y configuración.
/config: almacena settings.inc.php, clave para la conexión a la base de datos.
/img: para subir imágenes de productos.
/modules: donde se instalan y actualizan módulos.
/themes: para personalizar la apariencia.

Si alguno de estos directorios tiene permisos incorrectos, aparecerán errores que pueden bloquear la tienda.

Diagnóstico rápido: ¿Cómo saber si hay un problema de permisos?

Antes de modificar nada, verifica si el problema es realmente de permisos. Sigue estos pasos:

1. Revisa el mensaje de error exacto

PrestaShop suele indicar la ruta afectada. Por ejemplo:

"Cannot write to the directory /var/www/vhosts/tutienda.com/httpdocs/cache"
"Error: /config/settings.inc.php is not writable"

2. Accede al panel de administración de PrestaShop

Si puedes entrar al back office, ve a Parámetros Avanzados > Rendimiento y haz clic en Limpiar caché. Si aparece un error de escritura, confirma el problema.

3. Usa el explorador de archivos de Plesk

En Plesk, ve a Archivos y navega hasta la carpeta de tu tienda. A la derecha de cada archivo/carpeta verás los permisos en formato numérico (ej: 755, 644). Si ves valores extraños como 000 o 777, hay un problema.

4. Prueba con un comando SSH (si tienes acceso)

Conéctate por SSH a tu servidor y ejecuta:

ls -la /var/www/vhosts/tutienda.com/httpdocs/

Busca líneas como:

drwxr-xr-x (755) → correcto para carpetas
-rw-r--r-- (644) → correcto para archivos estáticos
-rw-rw-rw- (666) → peligroso, cualquier usuario puede escribir

[WARNING] No modifiques permisos sin entender el contexto. Un error puede exponer tu tienda a ataques.

Solución paso a paso: Cómo corregir permisos en PrestaShop con Plesk

A continuación, te presentamos una guía detallada para solucionar los errores escritura PrestaShop usando Plesk. Hay dos enfoques principales: desde la interfaz gráfica y mediante comandos chmod PrestaShop por SSH.

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

Inicia sesión en Plesk y selecciona tu dominio.
Ve a Archivos en el menú lateral.
Navega hasta la carpeta raíz de tu tienda (normalmente httpdocs o public_html).
Selecciona todas las carpetas y archivos (puedes usar Ctrl+A o la casilla superior).
Haz clic en Cambiar permisos (icono de candado o engranaje).
En la ventana emergente, configura:
- Propietario: el usuario del sistema (suele ser tu-dominio o psaadm).
- Grupo: psacln (típico en Plesk).
- Permisos:
  - Carpetas: 755 (lectura, escritura y ejecución para propietario; lectura y ejecución para grupo y otros).
  - Archivos: 644 (lectura y escritura para propietario; solo lectura para grupo y otros).
Marca la opción Aplicar a todos los subdirectorios y archivos.
Haz clic en Aceptar.

[INFO] Este método es seguro porque respeta la estructura de usuarios de Plesk, evitando conflictos con el servidor web.

Opción 2: Usando comandos SSH (más rápido y preciso)

Si tienes acceso SSH, puedes usar los siguientes comandos. Primero, conéctate:

ssh usuario@tuserver.com

Luego, navega a la carpeta de tu tienda:

cd /var/www/vhosts/tutienda.com/httpdocs

a) Establecer permisos recomendados para PrestaShop 1.7 y 8.x

find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
chmod 777 cache config themes img modules

Explicación:

find . -type d → busca todas las carpetas y les asigna 755.
find . -type f → busca todos los archivos y les asigna 644.
Luego, damos permisos 777 a los directorios que PrestaShop necesita para escribir.

[WARNING] El 777 es peligroso. Solo úsalo temporalmente para solucionar el error. Después, considera cambiarlo a 755 si es posible, o usar un usuario específico.

b) Ajustar propietario y grupo (importante en Plesk)

Plesk suele usar psaadm como usuario del servidor web. Para que PrestaShop pueda escribir, el propietario debe coincidir:

chown -R psaadm:psacln .

Reemplaza psaadm:psacln por el usuario y grupo de tu dominio (lo encuentras en Plesk > Suscripciones > Usuario del sistema).

c) Verificar que todo está correcto

ls -la

Busca que las carpetas tengan drwxr-xr-x y los archivos -rw-r--r--.

Casos comunes y soluciones específicas

Error: "No se puede escribir en /cache" o "El directorio /cache no tiene permisos de escritura"

Causa: El usuario del servidor web no puede crear archivos temporales.
Solución: Asegúrate de que /cache tenga permisos 755 o 777. Si usas Plesk, verifica que el propietario sea psaadm.

Error: "settings.inc.php no se puede modificar"

Causa: Este archivo crítico tiene permisos 644 pero el propietario es incorrecto.
Solución: Cambia el propietario a psaadm:psacln y, temporalmente, dale permisos 666, luego vuelve a 644 después de guardar cambios.

Error: "No se puede subir imágenes"

Causa: La carpeta /img no es escribible.
Solución: Dale permisos 755 o 777, y asegúrate de que el grupo psacln tenga escritura.

Error: "Módulo no se puede instalar"

Causa: /modules no tiene permisos de escritura para el servidor web.
Solución: Aplica chmod 755 a /modules y verifica el propietario.

Buenas prácticas para evitar futuros problemas de permisos

Nunca uses 777 en toda la tienda. Solo en directorios específicos y temporalmente.
Mantén actualizado PrestaShop. Las versiones recientes manejan mejor los permisos.
Usa el usuario correcto. En Plesk, el usuario del sistema suele ser el mismo que el del dominio. Si usas FTP, asegúrate de que coincida.
Configura un cron de seguridad. Puedes programar un script que verifique permisos periódicamente.
Evita mezclar FTP y SSH. Si cambias permisos por FTP, el propietario puede ser diferente al del servidor web.

Preguntas frecuentes (FAQ)

¿Qué permisos debe tener PrestaShop en Plesk?

Carpetas: 755 (excepto /cache, /config, /img, /modules, /themes que pueden ser 777 temporalmente).
Archivos: 644.
Propietario: psaadm (o el usuario del dominio).
Grupo: psacln.

¿Cómo saber el usuario del sistema en Plesk?

Ve a Suscripciones > selecciona tu dominio > en la pestaña General verás Usuario del sistema. Normalmente es tudominio o psaadm.

¿Es seguro usar chmod 777?

No, porque cualquier usuario en el servidor puede escribir en esos directorios. Úsalo solo para solucionar un error y luego bájalo a 755 si el servidor lo permite.

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

Verifica que el propietario sea correcto. En Plesk, el servidor web corre como psaadm. Si el propietario es otro, PrestaShop no podrá escribir aunque los permisos sean 777.

¿Puedo usar un plugin para gestionar permisos?

Sí, existen módulos como "Permisos Manager" para PrestaShop, pero es mejor hacerlo manualmente para entender el problema.

Conclusión

Los permisos archivos PrestaShop Plesk son una causa común de errores, pero con esta guía puedes resolverlos fácilmente. Recuerda siempre:

Diagnosticar primero el error exacto.
Usar permisos 755 para carpetas y 644 para archivos.
Ajustar el propietario a psaadm:psacln en Plesk.
Evitar el 777 permanente.

Si sigues estos pasos, tu tienda funcionará sin problemas de escritura. ¿Aún tienes dudas? Revisa la sección de preguntas frecuentes o contacta a tu proveedor de hosting.

[TIP] Para mantener tu tienda segura, programa una verificación mensual de permisos. Puedes hacerlo desde Plesk con un script personalizado o usando un cron job.

¡Esperamos que este artículo te haya sido útil! Si necesitas más ayuda, no dudes en consultar nuestra base de conocimiento o abrir un ticket de soporte.