Permisos de archivos y carpetas correctos para PrestaShop

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

Cuando instalas PrestaShop en tu servidor, el sistema necesita leer, escribir y ejecutar archivos para funcionar correctamente. Los permisos determinan quién puede hacer qué con cada archivo o carpeta. Si los permisos son demasiado restrictivos, tu tienda dará errores como pantallas blancas o imposibilidad de subir imágenes. Si son demasiado permisivos, expones tu tienda a vulnerabilidades de seguridad.

Piensa en los permisos como las cerraduras de tu tienda física. No quieres que cualquiera entre al almacén, pero tampoco quieres quedarte fuera de tu propio local. Los permisos PrestaShop correctos son ese equilibrio perfecto entre seguridad y funcionalidad.

Entendiendo los permisos: chmod, usuarios y grupos

Antes de entrar en materia, necesitas entender tres conceptos básicos. Los permisos se asignan a tres tipos de usuarios: el propietario (dueño del archivo), el grupo (un conjunto de usuarios) y el público (todos los demás). Para cada uno de ellos, puedes dar tres tipos de acceso: lectura (r), escritura (w) y ejecución (x).

El comando chmod es la herramienta que usamos para cambiar estos permisos. Se usa con números que representan combinaciones de permisos: 4 para lectura, 2 para escritura y 1 para ejecución. Sumando estos números, obtenemos el valor final. Por ejemplo, 7 significa lectura + escritura + ejecución (4+2+1), 5 es lectura + ejecución (4+1) y 6 es lectura + escritura (4+2).

Cuando veas una combinación como 755, significa que el propietario tiene todos los permisos (7) y el grupo y el público tienen solo lectura y ejecución (5). Esta es la configuración más común para carpetas en PrestaShop.

Permisos recomendados para PrestaShop: la configuración ideal

Para que PrestaShop funcione correctamente, necesitas una configuración específica. La regla general es que las carpetas deben tener permisos 755 y los archivos deben tener permisos 644. Esta configuración permite al propietario escribir y a los demás usuarios solo leer, lo que es seguro y funcional.

Sin embargo, hay excepciones importantes. Algunas carpetas necesitan permisos más flexibles porque PrestaShop escribe en ellas constantemente. Por ejemplo, la carpeta config, cache, log, img, mails, modules, themes, translations, upload, download y var deben tener permisos 755 para carpetas y 644 para archivos dentro de ellas.

El archivo settings.inc.php dentro de la carpeta config es especialmente delicado. Este archivo contiene la configuración de tu base de datos y debe tener permisos 644 en producción. Si lo pones a 777, cualquier usuario podría leer tu contraseña de la base de datos, lo que es un riesgo grave de seguridad.

Cómo cambiar los permisos en tu servidor

Existen varias formas de cambiar los permisos PrestaShop, dependiendo de cómo accedas a tu servidor. La más común es a través del administrador de archivos de tu panel de control o mediante FTP con un cliente como FileZilla.

Usando el administrador de archivos de tu hosting

La mayoría de los paneles de control, como cPanel o Syspanel, incluyen un administrador de archivos. Para cambiar permisos desde ahí, sigue estos pasos:

1. Accede a tu panel de control (recuerda que Syspanel usa el puerto 2106).
2. Busca el administrador de archivos o "File Manager".
3. Navega hasta la carpeta raíz de tu PrestaShop.
4. Selecciona la carpeta o archivo que quieras modificar.
5. Haz clic derecho y elige "Cambiar permisos" o "Change Permissions".
6. Introduce el valor numérico (755 para carpetas, 644 para archivos).
7. Si quieres aplicar a subcarpetas, marca la opción de "aplicar a subdirectorios".

Usando FTP con FileZilla

Si prefieres usar FTP, FileZilla es una excelente opción gratuita. La ventaja es que puedes ver los permisos actuales de todos los archivos de una vez. Para cambiar permisos:

1. Conéctate a tu servidor con FileZilla.
2. Navega hasta la carpeta de tu PrestaShop.
3. Selecciona los archivos o carpetas que quieras modificar.
4. Haz clic derecho y elige "Permisos de archivos" o "File permissions".
5. Marca las casillas correspondientes o introduce el valor numérico.
6. Si es una carpeta, marca "Recurse into subdirectories" para aplicar a todo el contenido.

Configuración paso a paso para una instalación limpia

Si acabas de instalar PrestaShop, te recomiendo seguir este proceso. Primero, durante la instalación, PrestaShop te pedirá permisos específicos. Asegúrate de que tu servidor los permita. Si la instalación falla, suele ser porque los permisos no son correctos.

Después de la instalación, es fundamental ajustar los permisos. El proceso de instalación suele dejar algunos archivos con permisos demasiado abiertos (777) que debes corregir. La carpeta config y el archivo settings.inc.php son los más críticos.

Paso 1: Configura los permisos base

Ve a la raíz de tu PrestaShop y configura todas las carpetas a 755 y todos los archivos a 644. Esto se hace mejor con un comando en la terminal si tienes acceso SSH:

find /ruta/a/tu/prestashop -type d -exec chmod 755 {} \;
find /ruta/a/tu/prestashop -type f -exec chmod 644 {} \;

Paso 2: Ajusta las carpetas especiales

Después de la configuración base, hay carpetas que necesitan permisos adicionales para que PrestaShop pueda escribir en ellas. Estas son las carpetas cache, log, img, mails, modules, themes y translations. Para estas carpetas, puedes mantener 755, pero si tienes problemas, prueba con 775 (propietario y grupo pueden escribir).

Paso 3: Protege archivos sensibles

El archivo config/settings.inc.php debe tener permisos 644 o incluso 444 (solo lectura para todos) en producción. Si necesitas hacer cambios de configuración, cámbialo temporalmente a 644, haz tus cambios y luego vuelve a 444.

Errores comunes y cómo solucionarlos

Uno de los errores más frecuentes es ver una pantalla blanca en tu tienda. Esto suele indicar que los permisos son demasiado restrictivos. Revisa especialmente la carpeta cache y var/cache, ya que PrestaShop necesita escribir ahí constantemente.

Otro error común es no poder subir imágenes o productos. Esto significa que la carpeta img no tiene permisos de escritura. Asegúrate de que tenga al menos 755 y que el propietario sea el usuario del servidor web (normalmente www-data en Apache o nginx en Nginx).

Si ves mensajes de error que mencionan "no se puede escribir el archivo" o "permiso denegado", el problema es casi siempre un archivo o carpeta con permisos incorrectos. Usa el administrador de archivos para revisar y corregir.

La regla de oro: nunca uses permisos 777

Es tentador poner todos los permisos a 777 para solucionar problemas rápidamente, pero esto es un error grave. Los permisos 777 significan que cualquier usuario del sistema puede leer, escribir y ejecutar. Esto incluye a posibles atacantes que podrían modificar tus archivos, inyectar código malicioso o robar información de tus clientes.

[WARNING] Nunca uses permisos 777 en un entorno de producción. Si tu hosting requiere permisos 777 para funcionar, es una señal de que el servidor está mal configurado y deberías cambiar de proveedor.

La configuración máxima que deberías usar es 755 para carpetas y 644 para archivos. Si necesitas más flexibilidad, usa 775 para carpetas en lugar de 777. Esto permite escritura solo al propietario y al grupo, pero no a cualquiera.

Herramientas de PrestaShop para verificar permisos

PrestaShop incluye una herramienta útil en el panel de administración. Ve a "Parámetros avanzados" y luego a "Información". Ahí encontrarás una sección que te muestra los permisos de archivos y carpetas. Verás una tabla con todos los archivos importantes y su estado actual.

Esta herramienta te indica si los permisos son correctos o si necesitas ajustarlos. Es especialmente útil después de una actualización o migración. PrestaShop también te dice qué permisos debería tener cada archivo, lo que facilita la corrección.

Permisos según el tipo de hosting

El hosting compartido, los VPS y los servidores dedicados tienen diferencias en cómo manejan los permisos. En hosting compartido, el usuario del FTP suele ser el propietario de los archivos, y los permisos 755/644 funcionan perfectamente.

[INFO] En un VPS o servidor dedicado, asegúrate de que el propietario de los archivos sea el usuario del servidor web. Si los archivos pertenecen a otro usuario, los permisos correctos no servirán de nada porque el servidor web no podrá acceder.

En algunos hostings con PHP como módulo de Apache, el usuario que ejecuta PHP es el mismo que el propietario de los archivos. En otros, como PHP-FPM, el usuario puede ser diferente. Si tienes problemas, consulta con tu proveedor de hosting para saber qué usuario debe ser el propietario.

Checklist final de permisos PrestaShop

Te dejo una lista de verificación para que revises tu instalación:

• Todas las carpetas principales tienen permisos 755.
• Todos los archivos principales tienen permisos 644.
• La carpeta config tiene permisos 755 y el archivo settings.inc.php tiene 644 o 444.
• Las carpetas cache, log, img, mails, modules, themes, translations, upload, download y var son escribibles.
• No existe ningún archivo o carpeta con permisos 777.
• El propietario de los archivos es el usuario correcto del servidor web.
• Has revisado la herramienta de información de PrestaShop para confirmar que todo está correcto.

Preguntas frecuentes sobre permisos en PrestaShop

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

La carpeta config debe tener permisos 755. El archivo settings.inc.php dentro de ella debe tener 644 en producción. Si lo pones a 444, también es seguro, pero tendrás que cambiarlo temporalmente para hacer modificaciones.

¿Por qué no puedo subir imágenes a mi tienda?

El problema está en la carpeta img. Verifica que tenga permisos 755 y que el propietario sea el usuario del servidor web. También revisa que el espacio en disco no esté lleno, ya que esto también impide subir archivos.

¿Es normal que aparezcan errores de permisos después de una actualización?

Sí, es común. Las actualizaciones pueden cambiar los permisos o crear archivos nuevos con permisos incorrectos. Después de cada actualización, revisa la herramienta de información de PrestaShop y corrige los permisos si es necesario.

¿Puedo usar FTP para cambiar los permisos de todos los archivos a la vez?

Sí, con FileZilla puedes seleccionar todos los archivos y carpetas y cambiar sus permisos de una vez. Sin embargo, ten cuidado porque los archivos y carpetas necesitan permisos diferentes. Es mejor usar comandos SSH si tienes acceso, ya que puedes diferenciar entre archivos y carpetas.

¿Qué hago si mi hosting no me permite cambiar los permisos?

Algunos hostings compartidos limitan los permisos a ciertos valores. Si no puedes cambiar los permisos, contacta con el soporte de tu hosting. Es posible que necesiten ajustar la configuración del servidor. En Syspanel, por ejemplo, puedes gestionar esto fácilmente desde el administrador de archivos.

Conclusión: la seguridad y funcionalidad de tu tienda dependen de los permisos

Los permisos de archivos y carpetas son un aspecto fundamental del mantenimiento de PrestaShop. Una configuración correcta protege tu tienda de ataques y garantiza que todo funcione sin errores. Dedica tiempo a revisar los permisos regularmente, especialmente después de actualizaciones o cambios en tu hosting.

Recuerda la regla básica: carpetas a 755, archivos a 644, y nunca uses 777. Con esta configuración, tu tienda estará segura y funcionará correctamente. Si tienes dudas, usa la herramienta de información de PrestaShop y consulta con tu proveedor de hosting.

[TIP] Programa una revisión mensual de los permisos de tu PrestaShop. Es una tarea rápida que puede ahorrarte muchos dolores de cabeza en el futuro.