Permisos de archivos en PrestaShop con DirectAdmin: FAQ

¡Hola! Soy el equipo de soporte técnico y sé que los permisos de archivos pueden sonar a algo muy técnico y complicado. No te preocupes, es más sencillo de lo que parece. Este artículo está diseñado para resolver todas tus dudas sobre los permisos PrestaShop DirectAdmin, de una forma clara y paso a paso. Vamos a desglosar qué son, por qué son importantes y cómo configurarlos correctamente en tu servidor con DirectAdmin.

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

Imagina que tu tienda PrestaShop es una casa. Los archivos y carpetas son las habitaciones, y los permisos son las llaves que deciden quién puede entrar y qué puede hacer dentro. Unos permisos incorrectos son como dejar la puerta de tu casa abierta de par en par o, por el contrario, cerrarla con llave y no poder entrar tú mismo.

En el mundo de PrestaShop, los permisos controlan tres acciones principales sobre cada archivo y carpeta:

Lectura (Read - r): Poder ver el contenido del archivo.
Escritura (Write - w): Poder modificar o eliminar el archivo.
Ejecución (Execute - x): Poder ejecutar el archivo si es un programa.

Estos permisos se asignan a tres tipos de "usuarios" o roles:

Propietario (Owner - u): Normalmente, el usuario de tu cuenta de hosting.
Grupo (Group - g): Un conjunto de usuarios, a menudo el mismo que el propietario.
Otros (Others - o): Cualquier persona que visite tu web.

¿Por qué es tan importante? Porque PrestaShop necesita escribir en ciertas carpetas para funcionar correctamente (por ejemplo, para subir imágenes de productos, generar archivos de caché o instalar módulos). Si los permisos son demasiado restrictivos, tu tienda no podrá hacer estas tareas y verás errores. Si son demasiado permisivos, cualquier persona podría modificar archivos importantes, lo que supone un grave riesgo de seguridad. El equilibrio es clave.

El estándar de oro: Permisos correctos para PrestaShop en DirectAdmin

Después de años de experiencia y siguiendo las mejores prácticas, estos son los permisos que debes tener para una instalación de PrestaShop segura y funcional en DirectAdmin. A esto lo llamamos el "estándar de oro".

Permisos para Archivos

Los archivos individuales (como index.php, config/settings.inc.php, etc.) deben tener permisos 644.

Propietario: Lectura y escritura (6).
Grupo: Solo lectura (4).
Otros: Solo lectura (4).

¿Por qué? El propietario (tu usuario) necesita poder escribir para actualizar el archivo. El grupo y otros solo necesitan leerlo para que la web se muestre. Nadie más debe poder modificarlos.

Permisos para Carpetas

Todas las carpetas (como img/, themes/, modules/, cache/, etc.) deben tener permisos 755.

Propietario: Lectura, escritura y ejecución (7).
Grupo: Lectura y ejecución (5).
Otros: Lectura y ejecución (5).

¿Por qué? El permiso de "ejecución" en una carpeta no significa ejecutar un programa, sino poder "entrar" en ella (listar su contenido). El propietario necesita poder crear y borrar archivos dentro (escritura). El resto necesita poder navegar por la carpeta para que la web funcione.

Excepciones importantes: Carpetas con permisos 777

Hay un par de carpetas que necesitan un permiso más abierto para que PrestaShop pueda funcionar sin problemas. Son las carpetas donde la aplicación escribe constantemente.

Estas carpetas deben tener permisos 777:

/cache/
/config/ (a veces, aunque 755 suele ser suficiente)
/img/
/log/
/mails/
/modules/
/themes/ (y sus subcarpetas)
/translations/
/upload/
/download/

[WARNING] ¡Cuidado! Dar permisos 777 a cualquier archivo o carpeta que no sean las mencionadas es un riesgo de seguridad. Nunca des 777 a config/settings.inc.php o a ningún archivo .php raíz.

Cómo cambiar los permisos de archivos en DirectAdmin

Vamos a la práctica. Aquí te explico los dos métodos más comunes para ajustar los DirectAdmin PrestaShop permisos.

Método 1: Usando el Administrador de Archivos de DirectAdmin (Recomendado para principiantes)

Es la forma más visual y segura si no te sientes cómodo con líneas de comandos.

Accede a DirectAdmin: Abre tu navegador y ve a la URL de tu panel de control (ej: tudominio.com:2222).
Busca el "Administrador de Archivos": En el menú principal, busca un icono que diga "Administrador de Archivos" o "File Manager". Haz clic.
Navega a la raíz de tu tienda: Busca la carpeta public_html o domains/tudominio.com/public_html. Ahí es donde está instalado PrestaShop.
Selecciona los archivos/carpetas: Puedes hacerlo de varias formas:
- Para cambiar una carpeta entera: Marca la casilla al lado de la carpeta (ej: img).
- Para cambiar todos los archivos de una carpeta: Entra en la carpeta (ej: img), y luego haz clic en "Seleccionar todo" en la barra superior. O simplemente marca las casillas de los que quieras.
Cambia los permisos: Una vez seleccionados, busca en la barra superior un botón que dice "Permisos" o "Change Permissions". Aparecerá una ventana.
Configura los valores: Verás tres columnas (Propietario, Grupo, Otros) con casillas para Leer, Escribir y Ejecutar. Simplemente marca las casillas según el estándar:
- Para archivos (644): Propietario: RW, Grupo: R, Otros: R.
- Para carpetas (755): Propietario: RWX, Grupo: RX, Otros: RX.
- Para carpetas especiales (777): Propietario: RWX, Grupo: RWX, Otros: RWX.
Aplica los cambios: Marca la opción "Aplicar a subdirectorios" o "Recursivo" si quieres que el cambio afecte a todas las subcarpetas y archivos dentro de la carpeta seleccionada. ¡Ten cuidado con esta opción!
Haz clic en "Guardar" o "Aceptar". ¡Listo!

[TIP] Para cambiar los permisos de todos los archivos de una vez, puedes seleccionar la carpeta raíz (public_html) y luego, en la ventana de permisos, usar la opción "Aplicar solo a archivos" o "Aplicar solo a directorios" según lo que necesites. Esto ahorra mucho tiempo.

Método 2: Usando el Cliente FTP (FileZilla, por ejemplo)

Si usas un programa FTP como FileZilla, también es muy fácil.

Conéctate a tu servidor: Abre FileZilla y conéctate usando los datos FTP de tu cuenta de DirectAdmin (usuario, contraseña, servidor y puerto 21).
Navega a la carpeta public_html.
Selecciona los archivos/carpetas: Haz clic derecho sobre el archivo o carpeta que quieras modificar.
Busca "Permisos de archivo..." o "File permissions...". Se abrirá una ventana.
Introduce el valor numérico: En la ventana, verás un campo para "Valor numérico" (por ejemplo, 644, 755, 777). Escríbelo directamente. También puedes marcar las casillas manualmente.
Marca "Recursivo en subdirectorios" si aplica, y elige si quieres aplicarlo solo a archivos, solo a carpetas o a ambos.
Acepta los cambios.

Solución de problemas comunes con permisos en PrestaShop

A veces, aunque creas que has puesto los permisos correctos, tu tienda puede dar errores. Aquí tienes los más comunes y cómo solucionarlos.

"Error de escritura" o "No se puede crear el archivo"

Este es el error más típico. Significa que PrestaShop no tiene permiso para escribir en una carpeta.

Solución: Revisa que las carpetas /cache, /img, /log, /modules, /themes, /translations, /upload y /download tengan permisos 777. Si ya los tienen, asegúrate de que el propietario de esos archivos y carpetas sea el usuario de tu cuenta de hosting, no otro.

"Error 500 Internal Server Error"

Este error puede tener muchas causas, pero los permisos incorrectos son una de ellas.

Solución: Revisa que el archivo config/settings.inc.php tenga permisos 644 o 444 (solo lectura). Un error común es ponerlo a 777. También verifica que el archivo .htaccess (si existe) tenga permisos 644.

"La tienda se ve en blanco" o "Página en blanco"

Suele ocurrir después de una actualización o instalación de un módulo.

Solución: Primero, limpia la caché de PrestaShop. Puedes hacerlo manualmente borrando el contenido de la carpeta /cache/smarty/cache y /cache/smarty/compile (no borres las carpetas, solo su contenido). Luego, verifica que los permisos de la carpeta /cache sean 777.

Problemas al subir imágenes de productos

Si no puedes subir imágenes desde el panel de administración.

Solución: Asegúrate de que la carpeta /img y todas sus subcarpetas tengan permisos 777. A veces, el problema está en una subcarpeta específica como /img/p o /img/c.

Preguntas Frecuentes (FAQ) sobre permisos PrestaShop DirectAdmin

Aquí respondemos a las dudas más habituales que nos llegan al soporte.

¿Cada cuánto debo revisar los permisos de mi PrestaShop?

No es necesario que lo hagas a diario. Te recomendamos hacerlo:

Después de instalar o actualizar PrestaShop.
Después de instalar o desinstalar un módulo o tema.
Si empiezas a ver errores de escritura o la web se comporta de forma extraña.
Como parte de una revisión de seguridad mensual.

¿Es seguro usar permisos 777 en las carpetas que mencionas?

Sí, es seguro y necesario para el correcto funcionamiento de PrestaShop en esas carpetas específicas. El riesgo real es poner permisos 777 a archivos como config/settings.inc.php o a la raíz de public_html. Limítate a las carpetas que te hemos indicado y estarás bien.

¿Qué hago si después de cambiar los permisos sigo teniendo errores?

Puede que el problema no sean los permisos, sino el propietario de los archivos. En DirectAdmin, todos los archivos de tu cuenta deben pertenecer al usuario de tu cuenta (y su grupo). A veces, al subir archivos por FTP con otro usuario o al descomprimir un archivo, el propietario cambia. Para solucionarlo, en el Administrador de Archivos de DirectAdmin puedes seleccionar todos los archivos y usar la opción "Cambiar propietario" (si está disponible) para asignarlos a tu usuario. Si no ves esta opción, contacta con nuestro soporte técnico.

¿Y si uso Syspanel (antes conocido como HestiaCP)?

Si tu panel de control es Syspanel, el proceso es muy similar. Accede a tu Syspanel a través del puerto 2106 (ej: tudominio.com:2106). Busca el "Administrador de Archivos" y sigue los mismos pasos que en DirectAdmin. Los permisos recomendados (644 para archivos, 755 para carpetas y 777 para las carpetas especiales) son exactamente los mismos.

¿Puedo automatizar el cambio de permisos?

Sí, si te sientes cómodo con la línea de comandos (SSH), puedes usar comandos como find para cambiar permisos de forma masiva. Por ejemplo:

Para cambiar todos los archivos a 644: find /ruta/a/tu/prestashop -type f -exec chmod 644 {} \;
Para cambiar todas las carpetas a 755: find /ruta/a/tu/prestashop -type d -exec chmod 755 {} \;
Para cambiar las carpetas especiales a 777: chmod -R 777 /ruta/a/tu/prestashop/cache /ruta/a/tu/prestashop/img ...

[INFO] Si no sabes usar SSH, no te preocupes. El método del Administrador de Archivos es igual de efectivo y más seguro para empezar.

Esperamos que este artículo te haya sido de gran ayuda. Recuerda que los permisos PrestaShop DirectAdmin son una parte fundamental del mantenimiento de tu tienda. Si tienes cualquier otra duda, no dudes en contactar con nuestro equipo de soporte. ¡Estamos aquí para ayudarte a que tu negocio online funcione a la perfección!