Guía de permisos de archivos y carpetas en PrestaShop (cPanel/Plesk)

¿Tu tienda PrestaShop te da errores de permisos al subir imágenes, instalar módulos o al intentar escribir en la caché? No te preocupes, no eres el único. Este es uno de los problemas más comunes al administrar una tienda online, pero también uno de los más fáciles de solucionar si sabes exactamente qué estás haciendo.

En esta guía extensa y práctica, vamos a desglosar todo lo que necesitas saber sobre los permisos PrestaShop, también conocidos como chmod PrestaShop. Aprenderás a configurarlos correctamente tanto en cPanel como en Plesk, entenderás qué significan esos números mágicos (644, 755, 775) y, lo más importante, cómo evitar errores de seguridad en el futuro.

Vamos a ello. No necesitas ser un experto en servidores Linux para seguir esta guía; solo necesitas paciencia y seguir los pasos al pie de la letra.

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

Imagina que tu servidor es un edificio de oficinas. Dentro de ese edificio, hay archivos (documentos) y carpetas (archivadores). Cada uno tiene una puerta con una cerradura que tiene tres llaves diferentes:

• Lectura (r): Permite abrir el documento y leerlo.
• Escritura (w): Permite modificar el contenido del documento o crear nuevos dentro del archivador.
• Ejecución (x): Permite "entrar" a la carpeta o ejecutar un script (un archivo con código).

Ahora, ¿quién tiene esas llaves? El sistema operativo del servidor (Linux) define tres tipos de usuarios:

• Propietario (u): El usuario dueño del archivo (normalmente el que creó el archivo o el usuario de FTP).
• Grupo (g): Un grupo de usuarios que pueden tener acceso (a menudo el grupo del servidor web, como www-data).
• Otros (o): Todos los demás usuarios del servidor.

Cuando hablamos de permisos PrestaShop, nos referimos a asignar correctamente estas llaves a cada archivo y carpeta para que la tienda funcione sin problemas. Si un archivo necesita ser escrito por la tienda (por ejemplo, para guardar una imagen de producto) y no tiene el permiso de escritura, obtendrás un error fatal.

Los números mágicos: Entendiendo el chmod (644, 755, 775)

En lugar de escribir cartas y "rwx", los servidores usan números. Cada permiso tiene un valor:

• Lectura (r) = 4
• Escritura (w) = 2
• Ejecución (x) = 1

Sumamos estos valores para cada tipo de usuario (propietario, grupo, otros) y obtenemos un número de tres dígitos. Por ejemplo:

• 7 (4+2+1): Lectura, escritura y ejecución. Acceso total.
• 6 (4+2): Lectura y escritura.
• 5 (4+1): Lectura y ejecución.
• 4: Solo lectura.

Por eso, cuando veas 644, significa que el propietario tiene lectura y escritura (6), pero el grupo y otros solo pueden leer (4 y 4). Este es el permiso estándar para archivos en PrestaShop.

Para carpetas, el estándar es 755 (el propietario tiene acceso total, y el grupo y otros pueden leer y entrar). A veces, para que la tienda funcione correctamente con la caché o la subida de archivos, necesitamos permisos más flexibles como 775 o incluso 777, pero este último es peligroso.

[WARNING]
NUNCA uses permisos 777 en toda tu tienda. Esto significa que cualquier persona en el mundo puede escribir y ejecutar archivos en tu servidor. Es como dejar la puerta de tu casa abierta de par en par. Es la causa principal de inyección de malware y hackeos.

¿Cuáles son los permisos correctos para PrestaShop?

Antes de tocar nada, es crucial que sepas qué permisos debe tener cada cosa. No es lo mismo un archivo que una carpeta.

Permisos para archivos (configuración estándar)

• Archivos PHP (como index.php, config.inc.php): 644
• Archivos de imagen y estáticos (.jpg, .png, .css, .js): 644
• Archivos de configuración específicos (.htaccess): 644 (aunque a veces se requiere 444 para solo lectura, pero 644 es seguro).

Permisos para carpetas (configuración estándar)

• Directorios raíz (como img, modules, themes): 755
• Directorios de caché y compilación (como var/cache, var/logs en versiones modernas): 775 (para que el servidor web pueda escribir en ellos).
• Directorios para subir archivos (como img/tmp, download): 775

[INFO]
En PrestaShop 1.7 y 1.8, la estructura de carpetas es ligeramente distinta. La carpeta var es la más importante para permisos de escritura (caché, logs, sesiones). Asegúrate de que el usuario de FTP y el usuario del servidor web (PHP) tengan acceso de escritura ahí.

Cómo cambiar los permisos PrestaShop en cPanel (paso a paso)

cPanel es el panel de control más común en el hosting compartido. Vamos a ver cómo ajustar los permisos archivos PrestaShop cPanel.

Método 1: Usando el Administrador de Archivos de cPanel

Este es el método más visual y fácil para principiantes.

1. Accede a cPanel: Entra con tus credenciales de hosting.
2. Busca "Administrador de Archivos": En la sección "Archivos", haz clic en el ícono de "Administrador de Archivos".
3. Navega a tu tienda: Ve a la carpeta donde está instalado PrestaShop (normalmente public_html o una subcarpeta como public_html/tienda).
4. Selecciona el archivo o carpeta: Marca la casilla junto al archivo o carpeta que quieres modificar. Haz clic derecho sobre él y selecciona "Cambiar permisos".
5. Introduce el valor numérico: En el cuadro de diálogo, verás casillas de verificación y un campo de texto. Escribe directamente el valor numérico (por ejemplo, 755) o marca las casillas manualmente (marca "Leer", "Escribir" y "Ejecutar" para el propietario, y solo "Leer" y "Ejecutar" para grupo y otros).
6. Aplica los cambios: Haz clic en "Cambiar permisos".

Método 2: Usando un cliente FTP (FileZilla)

Si prefieres una vista más tradicional, FileZilla es una excelente opción.

1. Conecta a tu servidor: Abre FileZilla y conéctate usando tus datos FTP.
2. Navega a la raíz de PrestaShop: En el panel derecho (servidor), ve a la carpeta de tu tienda.
3. Selecciona los archivos: Para cambiar archivos individuales, haz clic derecho sobre ellos y selecciona "Permisos de archivo...".
4. Ingresa el valor: En la ventana emergente, escribe el valor numérico en el campo "Valor numérico" y haz clic en "Aceptar".
5. Para carpetas con subcarpetas (RECOMENDADO): Si quieres cambiar los permisos de una carpeta y todo su contenido (por ejemplo, la carpeta var), haz clic derecho sobre la carpeta, selecciona "Permisos de archivo...", escribe el valor (ej. 755) y marca la casilla "Recursivo en subcarpetas" y luego selecciona "Aplicar a todos los archivos y directorios". ¡Cuidado con esto! Asegúrate de usar el valor correcto.

[TIP]
No apliques permisos recursivos de forma indiscriminada. Por ejemplo, si pones 777 en la carpeta img recursivamente, estarás abriendo una puerta gigante a los hackers. Es mejor cambiar carpetas y archivos por separado.

Cómo cambiar los permisos PrestaShop en Plesk

Plesk es otro panel de control popular, especialmente en servidores VPS o dedicados. El proceso es ligeramente diferente.

1. Accede a Plesk: Inicia sesión en tu panel de Plesk.
2. Ve a "Administrador de archivos": En el menú lateral izquierdo, busca la sección "Archivos" y haz clic en "Administrador de archivos".
3. Navega a tu dominio: Verás la lista de dominios. Haz clic en el dominio donde está instalada tu tienda (ej. midominio.com).
4. Entra en httpdocs o public_html: Dependiendo de la configuración, tu tienda estará en la carpeta httpdocs (en Plesk) o en una subcarpeta.
5. Selecciona y cambia permisos: Marca la casilla del archivo o carpeta. En la barra superior, haz clic en el botón "Permisos" (parece un candado o un engranaje).
6. Configura los permisos: Se abrirá una ventana similar a la de cPanel. Puedes marcar las casillas o escribir el valor numérico. Haz clic en "Aceptar" para guardar.

Importante en Plesk: A veces, el usuario de FTP y el usuario del sistema (el que ejecuta PHP) son diferentes. Si tienes problemas de escritura, puede que necesites cambiar el "propietario" del archivo, pero eso es más avanzado. Para la mayoría de los casos, cambiar los permisos a 755 (carpetas) y 644 (archivos) es suficiente.

Solución de problemas comunes: ¿Por qué me sigue dando error?

Has cambiado los permisos a 755 y 644, pero el error persiste. ¿Qué está pasando?

• El error de "No se puede escribir en la caché": Esto es muy común. La solución no es poner 777 en var/cache. En su lugar, asegúrate de que el usuario de PHP (a menudo nobody o www-data) sea el propietario de la carpeta o que el grupo tenga permisos de escritura. En cPanel, a menudo basta con cambiar la propiedad del archivo a tu usuario y grupo, y luego poner 775.
• El error al subir imágenes: Verifica que la carpeta img y sus subcarpetas (como img/cms, img/p) tengan permisos 755 y que el propietario sea correcto. Si estás en un hosting compartido, el propietario suele ser tu usuario de cPanel.
• Módulos que no se pueden instalar: La carpeta modules necesita permisos de escritura temporalmente. Ponla a 755 y, si el problema persiste, intenta con 775. Después de instalar, vuelve a ponerla a 755 por seguridad.
• Error de "500 Internal Server Error": Esto puede deberse a un archivo .htaccess con permisos incorrectos. Ponlo a 644. Si el error persiste, puede ser un problema de PHP, no de permisos.

La herramienta de PrestaShop para verificar permisos

PrestaShop tiene una herramienta de diagnóstico integrada que te dice exactamente qué carpetas necesitan permisos de escritura. Es una maravilla.

1. Accede a tu Administrador de PrestaShop (el back office).
2. Ve a Parámetros avanzados > Información.
3. Pestaña "Permisos de archivos" (o similar).
4. Verás una lista de archivos y carpetas con el estado: "Válido" o "No escribible".

Si ves algo en rojo, anota la ruta exacta y el permiso que te sugiere. La herramienta te dirá qué permisos necesita (generalmente 775 o 755).

[TIP]
Si la herramienta de PrestaShop no te deja entrar al back office porque el error es grave, puedes usar el archivo config/defines.inc.php para activar el modo depuración y ver el error exacto, pero eso es un tema más avanzado. Para esta guía, con cambiar los permisos de var y img suele ser suficiente.

Seguridad: Después de arreglar los permisos, vuelve a cerrar

Este es el consejo más importante de toda la guía.

Cuando instales un módulo, actualices la tienda o subas archivos, es común que necesites permisos de escritura amplios (775 o incluso 777 temporalmente). Pero una vez que termines, vuelve a poner los permisos seguros:

• Carpetas: 755
• Archivos: 644

Dejar todo en 775 o 777 es una invitación abierta a los bots maliciosos. Los hackers escanean constantemente Internet buscando sitios con permisos incorrectos para inyectar código malicioso (como redirecciones a farmacias online o mineros de criptomonedas).

[WARNING]
Si ves que tu tienda ha sido hackeada, lo primero que debes hacer es cambiar TODOS los permisos a 755 (carpetas) y 644 (archivos) para detener el sangrado. Después, limpia los archivos infectados.

Preguntas frecuentes (FAQ) sobre permisos en PrestaShop

¿Qué permisos debe tener la carpeta config en PrestaShop?

La carpeta config debe tener permisos 755. El archivo settings.inc.php (en versiones antiguas) o parameters.php (en versiones nuevas) debe tener 644. Nunca lo pongas a 777, ya que contiene las contraseñas de tu base de datos.

¿Por qué no puedo cambiar los permisos desde el FTP?

A veces, el servidor está configurado para que los cambios de permisos desde FTP no sean efectivos si el archivo pertenece a otro usuario. En ese caso, usa el Administrador de Archivos de cPanel o Plesk, que actúa directamente en el servidor.

¿Es lo mismo "chmod" que "permisos"?

Sí. chmod es el comando de Linux para cambiar permisos, y se ha popularizado como sinónimo. Cuando digo "haz un chmod 755", significa "cambia los permisos a 755".

¿Qué pasa si pongo 777 en una carpeta de PrestaShop?

Pone en riesgo inmediato la seguridad de tu tienda. Cualquier persona podría subir un archivo PHP malicioso y ejecutarlo, tomando control de tu sitio. Evítalo siempre.

¿Los permisos son iguales en un hosting Windows?

No. Esta guía es para hosting Linux, que es el más común para PrestaShop. En Windows, los permisos se gestionan de forma diferente (ACL). Si tienes un hosting Windows, contacta con tu proveedor.

¿Cómo afecta Syspanel a los permisos?

Si tu hosting utiliza Syspanel (anteriormente conocido como HestiaCP), el proceso es muy similar al de Plesk. Accede a través del puerto 2106 (ej. https://tu-dominio.com:2106), navega al Administrador de Archivos y sigue los mismos pasos que en Plesk para cambiar los permisos. La lógica de los números (755, 644) es idéntica.

Conclusión: Domina los permisos y tendrás una tienda estable

Gestionar los permisos PrestaShop no es ciencia espacial, pero requiere atención. Es un equilibrio entre darle a la tienda lo que necesita para funcionar (escribir caché, subir imágenes) y protegerla de amenazas externas.

Resumen rápido:

• Archivos: Usa 644.
• Carpetas: Usa 755.
• Carpetas de escritura intensiva (var, img, modules): Usa 775 si es necesario, pero nunca 777.
• Siempre usa la herramienta de "Información" de PrestaShop para diagnosticar problemas.
• Después de cualquier instalación, vuelve a los permisos base.

Con esta guía, ya tienes el conocimiento para solucionar el 90% de los errores de permisos en tu tienda. Si el problema persiste después de verificar todo, puede que el problema no sea de permisos sino de configuración del servidor (como PHP-FPM o el usuario de Apache), pero eso ya es una historia para otro artículo.

¡Esperamos que tu tienda func