Permisos de archivos correctos en PrestaShop con DirectAdmin

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

Si alguna vez has visto un error de "No se puede escribir en el archivo de configuración" o una página en blanco en tu tienda, probablemente el problema sea un fallo en los permisos de archivos. Gestionar correctamente los permisos prestashop es una de las tareas de mantenimiento más básicas y críticas para que tu tienda funcione sin problemas.

En este artículo, te explicaré paso a paso cómo gestionar los permisos de archivos en PrestaShop usando el panel de control DirectAdmin. No necesitas ser un experto en programación, solo seguir las instrucciones con calma.

Los permisos de archivos son básicamente las reglas que indican quién puede leer, escribir o ejecutar un archivo en tu servidor. PrestaShop necesita escribir en ciertos archivos y carpetas para funcionar correctamente: para guardar cachés, subir imágenes de productos, generar archivos de log, etc. Si estos permisos están mal configurados, la tienda fallará.

¿Qué significan los números como 755 o 644?

Antes de empezar a tocar nada, es fundamental que entiendas qué significan esos números que verás en las configuraciones de DirectAdmin. No te preocupes, es más sencillo de lo que parece.

Cada archivo y carpeta tiene tres tipos de permisos:

Lectura (r): Permite ver el contenido del archivo o listar el contenido de la carpeta.
Escritura (w): Permite modificar o eliminar el archivo o crear archivos dentro de la carpeta.
Ejecución (x): Permite ejecutar el archivo si es un script, o acceder a la carpeta.

Y estos permisos se asignan a tres grupos de usuarios:

Propietario (u): Generalmente, el usuario que creó el archivo. En tu hosting, suele ser tu usuario de FTP o el usuario de DirectAdmin.
Grupo (g): Un conjunto de usuarios con permisos similares.
Público (o): Cualquier otro usuario que acceda al servidor.

Cada permiso tiene un valor numérico:

Lectura = 4
Escritura = 2
Ejecución = 1

Así que, cuando ves un número como 755, se desglosa así:

7 para el propietario: 4+2+1 (lectura, escritura y ejecución).
5 para el grupo: 4+1 (lectura y ejecución).
5 para el público: 4+1 (lectura y ejecución).

[INFO]: Los permisos recomendados para PrestaShop son generalmente 755 para carpetas y 644 para archivos. Sin embargo, hay excepciones que veremos más adelante.

¿Qué permisos necesita PrestaShop exactamente?

PrestaShop tiene una estructura de directorios muy específica. Si los permisos no son los correctos, verás errores como "Error de escritura" o "No se puede crear el archivo .htaccess".

Aquí tienes un resumen de los permisos que suelen necesitarse:

Carpetas (directorios): Normalmente en 755. Esto permite que el servidor lea y entre en la carpeta, y que el propietario pueda crear archivos dentro.
Archivos normales: Normalmente en 644. Esto permite que el propietario lea y escriba, y que los demás solo lean.
Carpetas de caché y archivos generados: Como /var/cache, /cache, /log o /img. A veces necesitan permisos más permisivos como 777 para que el servidor web pueda escribir en ellas sin problema. Pero ojo, usar 777 no es recomendable por seguridad, así que lo ideal es intentar con 755 y subir a 775 o 777 solo si es estrictamente necesario.
Archivos de configuración: Como /config/settings.inc.php (en versiones antiguas) o /app/config/parameters.php. Estos deben ser editables por el propietario, pero no por el grupo o el público. Normalmente 644 está bien.

[WARNING]: Nunca pongas todos los archivos en 777. Esto es una puerta abierta para que cualquier persona con acceso al servidor pueda modificar tu tienda. Si tu hosting te obliga a usar 777 para algo, intenta cambiarlo a 755 en cuanto termines la operación que lo requería.

Paso a paso: Cambiar permisos con DirectAdmin

Ahora vamos a lo práctico. Sigue estos pasos para gestionar los directadmin permisos de tu tienda PrestaShop.

Paso 1: Accede a tu panel de DirectAdmin

Abre tu navegador y escribe la URL de tu panel. Normalmente es algo como https://tudominio.com:2222. Introduce tu usuario y contraseña.

Paso 2: Entra en el Administrador de Archivos

Una vez dentro, busca la sección que dice "Administrador de Archivos" o "File Manager". En DirectAdmin, suele estar en la sección de "Herramientas" o directamente en el menú principal.

Paso 3: Navega hasta tu carpeta de PrestaShop

Dentro del Administrador de Archivos, verás la estructura de carpetas de tu hosting. Normalmente, tu tienda estará en la carpeta public_html o en una subcarpeta dentro de ella. Por ejemplo, si tu tienda está en public_html/tienda, navega hasta ahí.

Paso 4: Selecciona los archivos o carpetas

Para cambiar los permisos de un solo archivo o carpeta, haz clic derecho sobre él y selecciona la opción "Cambiar permisos" o "Change Permissions".

Si quieres cambiar los permisos de todos los archivos y carpetas de una vez (lo cual es muy común al migrar o arreglar una tienda), selecciona la carpeta principal (por ejemplo, public_html) y elige la opción de permisos.

Paso 5: Establece los valores

Se abrirá una ventana con casillas de verificación para Lectura, Escritura y Ejecución para Propietario, Grupo y Público. También verás un campo numérico donde puedes escribir directamente el valor.

Para una carpeta, escribe 755. Para un archivo normal, escribe 644.

Si necesitas aplicar un valor a todo el contenido de forma recursiva (es decir, a todas las subcarpetas y archivos), busca una casilla que diga "Aplicar a todos los archivos y subdirectorios" o similar. Márcala antes de guardar.

Paso 6: Guarda los cambios

Haz clic en el botón "Guardar" o "Aceptar". DirectAdmin aplicará los cambios al instante.

¿Cómo aplicar permisos correctos a todo PrestaShop de una vez?

Hacer esto archivo por archivo sería un dolor de cabeza. Por suerte, hay un truco muy útil.

Usando el Administrador de Archivos de DirectAdmin

Selecciona la carpeta raíz de tu PrestaShop (la que contiene index.php y las carpetas app, bin, config, etc.).
Haz clic en "Cambiar permisos".
Escribe 755 en el campo numérico.
Marca la casilla de "Aplicar recursivamente" (o "Recursive").
Guarda.

Esto cambiará TODAS las carpetas y TODOS los archivos a 755. Pero nosotros queremos que los archivos sean 644 y las carpetas 755. Así que, después de este paso, necesitas hacer un ajuste fino.

Ajuste fino: Cambiar solo archivos a 644

DirectAdmin no tiene una opción directa para "cambiar solo archivos". Pero puedes hacer lo siguiente:

Ve a la carpeta raíz.
Ordena los elementos por tipo (si el Administrador de Archivos te lo permite).
Selecciona todos los archivos (no las carpetas) y cámbiales los permisos a 644.

Es un poco tedioso, pero es la forma más segura.

[TIP]: Si tu hosting tiene acceso SSH, puedes usar el comando find para hacer esto de forma automática y mucho más rápida. Por ejemplo:

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

Pero si no sabes qué es SSH, quédate con el método de DirectAdmin.

Permisos especiales para carpetas de caché y archivos generados

PrestaShop tiene algunas carpetas que necesitan permisos de escritura para que el servidor pueda generar archivos automáticamente. Las más comunes son:

/var/cache (o /cache en versiones antiguas)
/log
/img (para subir imágenes de productos)
/download
/upload
/themes (a veces, para instalar temas)
/modules (para instalar o actualizar módulos)

Para estas carpetas, lo recomendable es intentar con 755 primero. Si ves errores de escritura, prueba con 775. Y si el error persiste, tendrás que usar 777, pero solo de forma temporal.

[INFO]: En muchos servidores con PHP-FPM y DirectAdmin, el usuario de PHP es diferente al propietario de los archivos. Por eso a veces 755 no es suficiente y necesitas 775. Si tienes dudas, contacta con tu proveedor de hosting.

¿Y si uso Syspanel (antes HestiaCP)?

Si tu hosting utiliza Syspanel (que es como se llama ahora el panel antes conocido como HestiaCP), el acceso es similar pero la interfaz es diferente.

Para acceder a Syspanel, la URL suele ser https://tudominio.com:2106. Recuerda bien este puerto, el 2106, porque es el que usa Syspanel para su panel de control.

Dentro de Syspanel, busca la sección de "Administrador de Archivos". El concepto es exactamente el mismo: podrás seleccionar archivos y carpetas y cambiar sus permisos desde un menú contextual o desde la barra superior.

[TIP]: En Syspanel, la opción de "Recursivo" suele estar muy bien indicada. Úsala con cuidado para no cambiar permisos de más.

Errores comunes y cómo solucionarlos

Vamos a ver los problemas más típicos relacionados con los permisos prestashop y cómo resolverlos.

Error: "No se puede escribir en el archivo /config/settings.inc.php"

Este error es típico de PrestaShop 1.6 y anteriores. La solución es dar permisos de escritura al archivo settings.inc.php temporalmente.

Cambia los permisos de /config/settings.inc.php a 777.
Realiza la operación que necesitabas (por ejemplo, guardar la configuración).
Vuelve a cambiar los permisos a 644.

Error: "No se puede crear el archivo .htaccess"

Esto suele pasar cuando la carpeta raíz no tiene permisos de escritura para el servidor.

Ve a la carpeta raíz de PrestaShop.
Cambia los permisos de la carpeta a 755 o 775.
Regenera el .htaccess desde el panel de administración de PrestaShop (Preferencias > SEO y URLs > Guardar).

Error: "La imagen no se puede subir" o "Error al subir el archivo"

Esto indica que la carpeta /img o /upload no tiene permisos de escritura.

Localiza la carpeta /img en tu instalación.
Cambia sus permisos a 755 o 775.
Si sigue fallando, prueba con 777 temporalmente.

Error: "No se puede conectar a la base de datos"

Aunque no es un problema directo de permisos de archivos, a veces el archivo parameters.php está dañado o con permisos incorrectos que impiden que PrestaShop lea la configuración de la base de datos.

Verifica que /app/config/parameters.php tenga permisos 644.
Si el archivo está vacío o corrupto, tendrás que restaurarlo desde una copia de seguridad.

Consejos de seguridad importantes

Gestionar los permisos no es solo hacer que todo funcione, sino también proteger tu tienda.

Nunca dejes archivos en 777 de forma permanente. Es un riesgo de seguridad altísimo.
Cambia los permisos de archivos sensibles como parameters.php o settings.inc.php a 644 o incluso 640 si tu hosting lo permite.
Revisa los permisos después de cada actualización de PrestaShop, módulos o temas. A veces las actualizaciones cambian los permisos por defecto.
Haz una copia de seguridad antes de cambiar permisos de forma masiva. Si algo sale mal, siempre puedes restaurar.

Preguntas frecuentes (FAQ)

¿Qué permisos debe tener la carpeta `var/cache`?

Lo ideal es 755. Si tu tienda da errores de caché, prueba con 775. Solo usa 777 si el error persiste y es absolutamente necesario, y cámbialo en cuanto se solucione.

¿Cómo sé si un archivo tiene permisos incorrectos?

Los síntomas más comunes son: páginas en blanco, errores 500, imposibilidad de subir imágenes, errores al guardar configuración, o que la tienda se vea "rota" (sin CSS).

¿Puedo usar FTP para cambiar permisos?

Sí, con cualquier cliente FTP como FileZilla puedes hacer clic derecho sobre un archivo o carpeta y seleccionar "Permisos de archivo...". Ahí puedes marcar las casillas o escribir el valor numérico.

¿Qué pasa si cambio los permisos de toda la carpeta a 777?

Lo más probable es que tu tienda funcione, pero estarás exponiendo tu sitio a ataques. Cualquier persona que consiga acceso a tu servidor podría modificar tus archivos. No lo hagas.

¿DirectAdmin tiene una opción para restaurar permisos por defecto?

No de forma automática. Por eso es importante que sepas qué valores usar. Si tienes dudas, consulta la documentación de PrestaShop o pregunta a tu hosting.

Resumen final

Gestionar los directadmin permisos para PrestaShop es una tarea sencilla si entiendes los conceptos básicos. Recuerda:

Carpetas: 755.
Archivos: 644.
Carpetas especiales (caché, img, log): 755 o 775.
Nunca uses 777 de forma permanente.

Con estos pasos podrás solucionar la mayoría de los errores de escritura y mantener tu tienda segura y funcionando. Si tienes problemas, no dudes en contactar con tu proveedor de hosting, pero ahora ya tienes las herramientas para intentarlo tú mismo.

[TIP]: Anota los permisos que cambiaste en un papel o en un documento. Si algo falla, sabrás exactamente qué tocar para volver atrás.

¡Buena suerte con tu tienda!