Solucionar permisos de archivos PrestaShop DirectAdmin

¿Por qué aparece el error de permisos de archivos en PrestaShop?

Cuando trabajas con PrestaShop en un servidor que utiliza DirectAdmin, es muy común encontrarse con errores relacionados con los permisos de archivos. Estos errores suelen manifestarse con mensajes como "no se puede escribir en el archivo", "permiso denegado" o "error 500 Internal Server Error".

El problema de fondo es que los archivos de tu tienda online necesitan tener unos permisos específicos para que el servidor web (Apache o LiteSpeed) pueda leerlos, modificarlos y ejecutarlos correctamente. Si estos permisos son demasiado restrictivos, el sistema no puede acceder a los archivos; si son demasiado permisivos, supone un riesgo de seguridad grave.

La buena noticia es que solucionar los permisos archivos PrestaShop es un proceso bastante mecánico que puedes hacer tú mismo siguiendo esta guía paso a paso. No necesitas ser un experto en servidores, solo tener acceso a tu panel de control DirectAdmin y un poco de paciencia.

¿Qué permisos necesita PrestaShop correctamente?

Antes de lanzarnos a cambiar permisos como locos, es fundamental entender qué necesita PrestaShop para funcionar. Los permisos se expresan en formato numérico (chmod) y cada cifra tiene un significado:

4 = lectura (read)
2 = escritura (write)
1 = ejecución (execute)
0 = sin permisos

La combinación de estos números da lugar a valores como 644, 755, 775, etc. El primer dígito corresponde al propietario, el segundo al grupo y el tercero al resto de usuarios.

Para PrestaShop, la configuración recomendada es la siguiente:

Carpetas (directorios): permisos 755 (rwxr-xr-x) o 775 si tu hosting usa PHP como módulo de Apache.
Archivos (ficheros): permisos 644 (rw-r--r--) o 664 en el caso anterior.
Archivos de configuración especiales como config/settings.inc.php: permisos 444 o 440 después de la instalación.
Carpeta cache, log, img, upload, download: necesitan permisos 755 o 775 para que PrestaShop pueda escribir en ellas.

[INFO] Si tu hosting utiliza PHP-FPM (muy común en DirectAdmin), los permisos suelen ser 755 para carpetas y 644 para archivos. Si usas PHP como módulo de Apache, necesitas 775 y 664 respectivamente.

Preparación antes de cambiar permisos en DirectAdmin

Antes de empezar a ejecutar comandos o usar el administrador de archivos, debes hacer una copia de seguridad de tu tienda. Aunque cambiar permisos no suele romper nada, siempre es mejor prevenir.

Además, necesitarás tener a mano los datos de acceso a tu panel de DirectAdmin. Si no los tienes, contacta con tu proveedor de hosting para que te los facilite.

Tendrás dos formas de cambiar los permisos:

Usando el Administrador de Archivos de DirectAdmin (más visual, ideal para principiantes).
Usando SSH con comandos chmod (más rápido si tienes muchos archivos).

Vamos a ver ambas opciones, pero te recomiendo empezar con la primera si no tienes experiencia con terminales.

Método 1: Cambiar permisos con el Administrador de Archivos de DirectAdmin

Este método es el más sencillo para usuarios sin experiencia técnica. Sigue estos pasos:

Paso 1: Accede a tu panel de DirectAdmin

Abre tu navegador y escribe la URL de acceso a DirectAdmin (normalmente algo como https://tudominio.com:2222). Introduce tu usuario y contraseña.

Paso 2: Abre el Administrador de Archivos

En el menú principal, busca la sección "Archivos" o "File Manager" y haz clic. Se abrirá una ventana con la estructura de carpetas de tu cuenta de hosting.

Paso 3: Navega hasta la raíz de PrestaShop

Dentro del Administrador de Archivos, localiza la carpeta donde tienes instalado PrestaShop. Normalmente será public_html o una subcarpeta como public_html/tienda. Haz clic para entrar.

Paso 4: Selecciona todos los archivos y carpetas

En la parte superior del Administrador de Archivos, verás una opción para "Seleccionar todo". Úsala para marcar todos los elementos de la carpeta raíz de PrestaShop.

Paso 5: Cambia los permisos de forma masiva

Una vez seleccionados todos los archivos y carpetas, busca el botón que dice "Cambiar permisos" o "Chmod". Se abrirá un cuadro de diálogo donde podrás introducir el valor numérico.

Para carpetas: introduce 755 en el campo correspondiente.
Para archivos: introduce 644.

[TIP] DirectAdmin suele tener una opción que dice "Aplicar a subcarpetas y archivos". Actívala para que el cambio se aplique de forma recursiva a toda la estructura de PrestaShop.

Paso 6: Aplica los cambios y verifica

Haz clic en "Aceptar" o "Guardar". El proceso puede tardar unos segundos si tienes muchos archivos. Cuando termine, vuelve a tu tienda y comprueba si el error de permisos ha desaparecido.

Método 2: Usar SSH con comandos chmod (para usuarios avanzados)

Si tienes acceso SSH a tu servidor, este método es mucho más rápido, especialmente si tu tienda tiene miles de archivos. Conéctate por SSH y ejecuta los siguientes comandos desde la raíz de tu instalación de PrestaShop:

cd ~/public_html
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;

Estos comandos harán lo siguiente:

El primer find localiza todos los directorios (-type d) y les asigna permisos 755.
El segundo find localiza todos los archivos (-type f) y les asigna permisos 644.

Si tu hosting usa PHP como módulo de Apache y necesitas permisos más amplios, usa:

find . -type d -exec chmod 775 {} \;
find . -type f -exec chmod 664 {} \;

Archivos especiales que requieren atención

Después de aplicar los permisos generales, hay algunos archivos y carpetas que necesitan permisos específicos:

chmod 444 config/settings.inc.php
chmod 755 cache
chmod 755 log
chmod 755 img
chmod 755 upload
chmod 755 download
chmod 755 themes/default/cache
chmod 755 var/cache

[WARNING] El archivo config/settings.inc.php contiene las credenciales de tu base de datos. Después de la instalación, debe tener permisos 444 o 440 para evitar que alguien pueda modificarlo. Si lo dejas con 644, estarás exponiendo información sensible.

Errores comunes y cómo solucionarlos

Error 500 Internal Server Error después de cambiar permisos

Si al cambiar los permisos te aparece un error 500, es muy probable que hayas asignado permisos demasiado restrictivos a alguna carpeta crítica. Vuelve a verificar que las carpetas cache, log y var/cache tengan permisos de escritura (755 o 775).

Permisos correctos pero el error persiste

A veces, aunque los permisos sean correctos, el error persiste. Esto suele deberse a que el propietario de los archivos no es el correcto. En DirectAdmin, el usuario de FTP y el usuario del servidor web deben coincidir. Si has subido archivos por FTP con un usuario diferente, el servidor no podrá acceder a ellos.

Para solucionarlo, puedes cambiar el propietario con el siguiente comando SSH:

chown -R usuario:grupo ~/public_html

Sustituye usuario:grupo por tu usuario de DirectAdmin (normalmente es el mismo nombre de usuario de tu cuenta).

Problemas con la caché de PrestaShop

Después de cambiar permisos, es recomendable limpiar la caché de PrestaShop. Ve a Parámetros avanzados > Rendimiento en el panel de administración y haz clic en "Vaciar la caché". Si no puedes acceder al panel, borra manualmente el contenido de la carpeta var/cache (o cache en versiones antiguas).

¿Cómo evitar futuros errores de permisos en PrestaShop?

La mejor forma de evitar estos errores es mantener una política de permisos estricta y conocer cómo funciona tu hosting. Aquí tienes algunos consejos:

Usa siempre FTP con tu usuario principal de DirectAdmin, no crees usuarios secundarios para subir archivos.
No dejes archivos con permisos 777 (lectura, escritura y ejecución para todos). Es un riesgo de seguridad enorme.
Revisa los permisos después de cada actualización de PrestaShop o de módulos, ya que algunos instaladores los modifican.
Si usas un CDN o caché externa, asegúrate de que los permisos de la carpeta cache sean correctos.

[TIP] Puedes automatizar la corrección de permisos creando un pequeño script en tu servidor que los verifique y ajuste cada cierto tiempo. Si no sabes cómo hacerlo, pregunta a tu proveedor de hosting.

Preguntas frecuentes (FAQ) sobre permisos en PrestaShop

¿Qué permisos deben tener los archivos de PrestaShop?

Los archivos deben tener permisos 644 (o 664 si usas PHP como módulo de Apache) y las carpetas 755 (o 775). Los archivos de configuración sensibles como settings.inc.php deben tener 444.

¿Por qué DirectAdmin me da error al cambiar permisos?

Esto suele ocurrir cuando intentas cambiar permisos a archivos que no son de tu propiedad. Asegúrate de ser el propietario de los archivos o contacta con tu proveedor de hosting.

¿Es seguro usar permisos 777 en PrestaShop?

No, nunca uses 777. Aunque puede solucionar temporalmente errores de escritura, expone tu tienda a ataques maliciosos. Es mucho mejor usar 755 para carpetas y 644 para archivos.

¿Cómo sé si mi hosting usa PHP-FPM o módulo de Apache?

Puedes verlo en la sección de "Configuración PHP" de DirectAdmin o preguntando a tu proveedor. Si no lo sabes, empieza con 755 y 644, que funcionan en la mayoría de los casos.

Conclusión

Resolver el error permisos DirectAdmin en PrestaShop no tiene por qué ser una pesadilla. Siguiendo estos pasos, podrás identificar qué permisos necesita tu tienda y aplicarlos de forma segura tanto desde el Administrador de Archivos como por SSH.

Recuerda siempre hacer una copia de seguridad antes de modificar nada y verificar el propietario de los archivos si el problema persiste. Con un poco de práctica, aprenderás a diagnosticar y solucionar estos errores en cuestión de minutos.

Si después de seguir todos estos pasos el error persiste, puede que el problema no sea de permisos sino de configuración del servidor. En ese caso, contacta con tu proveedor de hosting y muéstrale los mensajes de error exactos que te aparecen. Ellos tendrán acceso a los logs del servidor y podrán ayudarte a identificar la causa raíz.

Esperamos que esta guía te haya sido de utilidad. ¡Tu tienda online volverá a funcionar perfectamente en poco tiempo!