Permisos de archivos en PrestaShop: Guía de configuración

¿Por qué son tan importantes los permisos de archivos en PrestaShop?

Cuando hablamos de permisos prestashop, nos referimos a un sistema de seguridad que controla quién puede leer, escribir o ejecutar los archivos y carpetas de tu tienda online. Si estos permisos no están bien configurados, pueden pasar dos cosas: que tu tienda funcione con errores extraños o que un atacante aproveche una brecha para colarse en tu servidor.

Piensa en los permisos archivos prestashop como las llaves de tu casa. Si dejas la puerta abierta (permisos demasiado permisivos), cualquiera puede entrar. Si la cierras con demasiadas llaves (permisos demasiado restrictivos), ni tú mismo podrás entrar para hacer la limpieza. El objetivo es encontrar el equilibrio perfecto.

En este artículo, te voy a explicar paso a paso cómo configurar los chmod prestashop de forma correcta, qué valores usar en cada carpeta y archivo, y cómo evitar los problemas más comunes que surgen cuando estos permisos no están bien ajustados. No necesitas ser un experto en servidores para lograrlo, solo sigue estas instrucciones y tendrás tu tienda funcionando de manera segura y estable.

¿Qué es CHMOD y cómo funciona?

CHMOD es un comando de los sistemas Linux (donde se aloja la mayoría de las tiendas PrestaShop) que permite cambiar los permisos de acceso a archivos y directorios. Se representa con tres dígitos numéricos que van del 0 al 7. Cada dígito corresponde a un tipo de usuario:

El primer dígito: permisos del propietario (tú o tu usuario FTP).
El segundo dígito: permisos del grupo (generalmente el grupo del servidor web).
El tercer dígito: permisos del resto de usuarios (el público).

Cada dígito se calcula sumando valores:

4: lectura (read)
2: escritura (write)
1: ejecución (execute)

Así, un valor de 644 significa que el propietario puede leer y escribir (4+2=6), mientras que el grupo y los demás solo pueden leer (4). Un valor de 755 da al propietario lectura, escritura y ejecución (4+2+1=7), y a los demás solo lectura y ejecución (4+1=5).

Para configurar permisos prestashop, vamos a trabajar principalmente con dos valores: 644 para archivos y 755 para directorios. Estos son los valores recomendados por la documentación oficial de PrestaShop para la mayoría de las instalaciones.

Preparación: antes de cambiar cualquier permiso

Antes de empezar a modificar los chmod prestashop, necesitas tener acceso a tu servidor. Puedes hacerlo mediante:

Un cliente FTP (como FileZilla, que es gratuito).
El administrador de archivos de tu hosting (cPanel, Plesk, o el panel que use tu proveedor).
La terminal si tienes acceso SSH.

Además, es fundamental que hagas una copia de seguridad completa de tu tienda antes de tocar nada. Un cambio incorrecto en los permisos puede dejar tu tienda inaccesible, y necesitarás poder restaurarla rápidamente.

[WARNING] No cambies los permisos de todos los archivos a la vez sin saber lo que haces. Hazlo por secciones y verifica que todo sigue funcionando después de cada cambio.

Permisos recomendados para una instalación estándar de PrestaShop

PrestaShop tiene una estructura de carpetas bastante predecible. Aquí te dejo los valores correctos para cada zona de tu instalación:

Archivos en la raíz

En la carpeta principal de tu PrestaShop (donde están los archivos como index.php, config.inc.php, etc.), los archivos deben tener permisos 644. Esto permite que el servidor los lea, pero no que cualquiera los pueda modificar.

Los directorios que están en la raíz (como /cache, /classes, /config, /controllers, /download, /img, /js, /mails, /modules, /override, /themes, /tools, /translations, /upload, /var y /webservice) deben tener permisos 755.

Carpetas con escritura habilitada

PrestaShop necesita que algunas carpetas sean escribibles para poder generar archivos temporales, guardar caché, subir imágenes o instalar módulos. Estas son las carpetas que deben tener permisos 755 (o incluso 777 en algunos casos, aunque te recomiendo evitarlo si es posible):

/cache
/config
/download
/img
/log
/mails
/modules
/themes
/translations
/upload
/var

Dentro de estas carpetas, los archivos que se generan automáticamente (como los archivos de caché) pueden tener permisos 644.

[INFO] Si tu hosting usa PHP como módulo de Apache (mod_php), los permisos 755 suelen ser suficientes. Si usas PHP-FPM o CGI, es posible que necesites permisos 775 o 777 en algunas carpetas. Pregunta a tu proveedor de hosting si no estás seguro.

Cómo cambiar los permisos con FileZilla (paso a paso)

FileZilla es la herramienta más utilizada para gestionar archivos en un servidor. Aquí tienes el proceso completo para configurar permisos prestashop con este programa:

Paso 1: Conéctate a tu servidor

Abre FileZilla y conéctate usando los datos FTP que te dio tu proveedor de hosting (servidor, usuario, contraseña y puerto, generalmente 21).

Paso 2: Navega hasta tu instalación de PrestaShop

En el panel derecho (servidor remoto), localiza la carpeta donde tienes instalada tu tienda. Normalmente será algo como /public_html o /www.

Paso 3: Selecciona los archivos o carpetas

Haz clic derecho sobre la carpeta o archivo que quieras modificar. En el menú contextual, selecciona "Permisos de archivo..." (o "File permissions...").

Paso 4: Introduce el valor numérico

En la ventana que aparece, verás un campo para el valor numérico. Escribe el número correspondiente (por ejemplo, 644 para archivos o 755 para carpetas). También puedes marcar las casillas de lectura, escritura y ejecución manualmente.

Paso 5: Aplica a subcarpetas

Si estás cambiando permisos en una carpeta que contiene muchas subcarpetas (como /modules), marca la opción "Recurse into subdirectories" y selecciona "Apply to directories only" para que solo se modifiquen las carpetas, o "Apply to files only" para solo archivos. Después, repite el proceso con la opción contraria.

[TIP] Para no volverte loco, primero cambia los permisos de todas las carpetas a 755 (marcando "Apply to directories only") y luego cambia los archivos a 644 (marcando "Apply to files only"). Así en dos pasos tienes todo configurado.

Paso 6: Verifica que todo funciona

Después de cada cambio, entra a tu tienda y navega por la página principal, el panel de administración y prueba a subir una imagen o instalar un módulo. Si algo falla, revisa los permisos de esa zona concreta.

Cómo cambiar los permisos con cPanel (administrador de archivos)

Si tu hosting usa cPanel, el proceso es similar:

Entra a cPanel y busca la herramienta "Administrador de archivos" (File Manager).
Navega hasta la carpeta de tu PrestaShop.
Selecciona el archivo o carpeta que quieras modificar.
Haz clic derecho y selecciona "Permisos" (Permissions).
Introduce el valor numérico (644 o 755) y haz clic en "Cambiar permisos".
Si es una carpeta, te preguntará si quieres aplicar los cambios de forma recursiva. Elige la opción adecuada según lo que necesites.

Permisos especiales: la carpeta /var y el entorno de desarrollo

En versiones recientes de PrestaShop (1.7 y superiores), existe una carpeta /var que contiene archivos de caché, logs y sesiones. Esta carpeta debe ser escribible por el servidor web. Normalmente con permisos 755 es suficiente, pero si tu hosting usa PHP-FPM, es posible que necesites 775 o 777.

Para saber qué permisos necesita tu servidor, puedes crear un archivo test.php en la raíz con el siguiente contenido:

<?php
echo 'Funciona correctamente';

Si al acceder a ese archivo ves el mensaje, los permisos generales están bien. Después borra ese archivo de prueba.

[WARNING] Nunca dejes la carpeta /var o /cache con permisos 777 de forma permanente. Es un riesgo de seguridad grave. Úsalo solo temporalmente y vuelve a bajar los permisos a 755 en cuanto resuelvas el problema.

Errores comunes al configurar permisos en PrestaShop

Error 1: La tienda muestra un error 500 o pantalla en blanco

Esto suele pasar cuando los permisos de los archivos de la raíz son demasiado restrictivos (por ejemplo, 600 o 400). El servidor no puede leer los archivos PHP y devuelve un error.

Solución: Asegúrate de que todos los archivos .php de la raíz tengan permisos 644 y las carpetas 755.

Error 2: No puedo subir imágenes o instalar módulos

Si los permisos de las carpetas /img, /modules o /themes son demasiado restrictivos, PrestaShop no podrá escribir en ellas. El error típico es: "No se puede escribir en la carpeta /img".

Solución: Cambia los permisos de esas carpetas a 755 (o 775 si el error persiste) y comprueba que los archivos dentro de ellas tienen 644.

Error 3: El panel de administración no carga los estilos CSS

Esto suele deberse a permisos incorrectos en la carpeta /themes o en los archivos de caché. El navegador no puede cargar los archivos CSS/JS.

Solución: Verifica que todos los archivos de /themes tengan permisos 644 y las carpetas 755. También puedes vaciar la carpeta /var/cache (dejando solo los archivos .htaccess e index.php) para forzar la regeneración de la caché.

Permisos y seguridad: lo que NO debes hacer

El error más grave que cometen muchos usuarios es poner permisos 777 en todo el directorio de PrestaShop para "arreglar" problemas rápidamente. Esto es un riesgo de seguridad enorme, porque significa que cualquier usuario del sistema puede leer, escribir y ejecutar cualquier archivo de tu tienda.

Un atacante podría subir un script malicioso, modificar tu código o robar datos de tus clientes. Si tu hosting es compartido, también podría afectar a otras cuentas del mismo servidor.

[WARNING] Nunca uses permisos 777 en producción. Si tu hosting te obliga a usarlos para que funcionen ciertas funciones, es mejor cambiar de proveedor de hosting que comprometer la seguridad de tu tienda.

Cómo automatizar la corrección de permisos

Si tienes acceso SSH a tu servidor, puedes usar comandos para cambiar los permisos de forma rápida y recursiva. Estos son los comandos que utilizo yo:

# Cambiar todos los directorios a 755
find /ruta/a/tu/prestashop -type d -exec chmod 755 {} \;

# Cambiar todos los archivos a 644
find /ruta/a/tu/prestashop -type f -exec chmod 644 {} \;

Sustituye /ruta/a/tu/prestashop por la ruta real de tu instalación. Estos comandos son seguros y aplican los valores recomendados a toda la estructura.

Preguntas frecuentes sobre permisos en PrestaShop

¿Qué permisos necesita la carpeta /modules?

Las carpetas de módulos deben tener permisos 755 y los archivos dentro de ellas 644. Si un módulo necesita escribir archivos de configuración, esa subcarpeta concreta puede necesitar 775, pero es raro.

¿Cómo sé si mis permisos son correctos?

La forma más fácil es ir a Parámetros avanzados > Información en el panel de administración de PrestaShop. Allí verás una sección que te indica los permisos de las carpetas principales. Si algo está mal, te lo mostrará en rojo.

¿Puedo usar permisos 775 en lugar de 755?

Sí, pero solo si tu hosting usa PHP-FPM o CGI. El valor 775 permite al grupo del servidor escribir en los archivos, lo que puede ser necesario en algunas configuraciones. Si tu tienda funciona con 755, no lo cambies.

¿Qué hago si después de cambiar los permisos mi tienda sigue dando errores?

Primero, comprueba que no has cambiado los permisos de los archivos de configuración (config/settings.inc.php en PrestaShop 1.6 o app/config/parameters.php en 1.7). Estos archivos deben tener permisos 644 (lectura y escritura solo para el propietario). Si están en 444, PrestaShop no podrá escribir en ellos y fallará.

¿Afectan los permisos al rendimiento de mi tienda?

Los permisos no afectan al rendimiento directamente, pero unos permisos incorrectos pueden provocar errores que ralenticen la tienda o impidan que funcione correctamente. Lo importante es que sean los adecuados para tu configuración de servidor.

Conclusión: el equilibrio perfecto

Configurar correctamente los permisos archivos prestashop es una tarea que solo lleva unos minutos, pero que puede ahorrarte muchos dolores de cabeza. Los valores estándar de 644 para archivos y 755 para carpetas son el punto de partida recomendado para la mayoría de las instalaciones.

Recuerda siempre:

Haz una copia de seguridad antes de cambiar nada.
Cambia los permisos por zonas y verifica que todo funciona.
Nunca uses 777 en producción.
Si tienes dudas, consulta con tu proveedor de hosting.

Con estos consejos, tu PrestaShop estará bien protegida y funcionando sin errores. Si tienes alguna duda sobre cómo configurar permisos prestashop en tu caso concreto, déjala en los comentarios y te ayudaré a resolverla.

[TIP] Si tu hosting utiliza Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106. Puedes usar su administrador de archivos integrado para cambiar permisos sin necesidad de FTP, siguiendo los mismos pasos que te he explicado con cPanel.

Espero que esta guía te haya sido útil. ¡Buena suerte con tu tienda online!