Soluciona errores de permisos en PrestaShop (DirectAdmin)

¿Por qué aparecen errores de permisos en PrestaShop?

Si estás leyendo esto, probablemente te has encontrado con un mensaje de error extraño en tu tienda PrestaShop. Tal vez no puedes subir imágenes, el módulo no se instala, o directamente ves una pantalla blanca. No te preocupes: en la mayoría de los casos, la causa es un problema de permisos de archivos y carpetas en tu servidor.

Cuando instalas PrestaShop en un panel como DirectAdmin, el sistema operativo del servidor necesita saber quién puede leer, escribir o ejecutar cada archivo. Si esos permisos no están bien configurados, la tienda no funciona correctamente. Es como si en una oficina el jefe no le diera permiso a los empleados para abrir el archivador: todo se bloquea.

En este artículo vamos a explicarte, paso a paso y sin tecnicismos innecesarios, cuáles son los errores comunes de permisos PrestaShop DirectAdmin y cómo solucionarlos tú mismo, aunque nunca hayas tocado un servidor antes.

¿Qué son los permisos de archivos (chmod) y por qué importan?

Cada archivo y carpeta en tu servidor tiene una especie de "candado digital" llamado permisos. Estos permisos se representan con números como 644, 755, 777, etc. Cada número indica qué puede hacer el propietario, el grupo y el resto de usuarios del sistema.

Lectura (r): valor 4
Escritura (w): valor 2
Ejecución (x): valor 1

Por ejemplo, el famoso chmod 755 significa que el propietario puede leer, escribir y ejecutar (4+2+1=7), mientras que el grupo y los demás solo pueden leer y ejecutar (4+1=5). Esto es lo que normalmente necesitan las carpetas de PrestaShop.

Si un archivo tiene permisos demasiado restrictivos (por ejemplo, 600), PrestaShop no podrá leerlo. Si tiene permisos demasiado abiertos (como 777), podrías tener problemas de seguridad. El objetivo es encontrar el equilibrio perfecto.

Los errores más comunes con permisos en PrestaShop

1. Error al subir imágenes o productos

Síntoma: Cuando intentas subir una foto de producto, aparece un mensaje como "No se puede escribir en el directorio" o la imagen simplemente no se carga.

Causa: Las carpetas /img o /upload no tienen permisos de escritura. PrestaShop necesita poder crear archivos dentro de estas carpetas cuando subes imágenes.

Solución: Accede a tu panel de DirectAdmin, ve al Administrador de archivos y navega hasta la raíz de tu tienda. Busca las carpetas img y upload. Haz clic derecho sobre cada una y selecciona Cambiar permisos. Establece 755 para las carpetas y 644 para los archivos dentro de ellas (si ves muchos archivos, puedes usar la opción "aplicar a todos los archivos y subcarpetas").

2. No se pueden instalar módulos o temas

Síntoma: Intentas instalar un módulo desde el back-office y te aparece un error de permisos, o el módulo se instala pero no funciona correctamente.

Causa: Las carpetas /modules y /themes no tienen permisos suficientes para que PrestaShop escriba los archivos nuevos.

Solución: En el Administrador de archivos de DirectAdmin, localiza las carpetas modules y themes. Cambia sus permisos a 755. Si el problema persiste, prueba con 775 (esto permite que el grupo del servidor también escriba). Después de instalar el módulo, puedes volver a dejarlo en 755 por seguridad.

3. Pantalla blanca o error 500 al abrir la tienda

Síntoma: La tienda no carga, solo ves una página en blanco o un error 500 Internal Server Error.

Causa: Puede ser por archivos con permisos incorrectos en la raíz, especialmente el archivo .htaccess o los archivos de configuración en /config.

Solución: Ve a la raíz de tu instalación de PrestaShop. Asegúrate de que el archivo .htaccess tenga permisos 644. Las carpetas config, cache y log deben tener 755. Es importante que la carpeta cache tenga permisos de escritura, porque PrestaShop guarda archivos temporales ahí. Prueba a vaciar la carpeta cache (no la borres, solo elimina su contenido) y recarga la página.

4. Error al vaciar caché o regenerar miniaturas

Síntoma: Cuando intentas regenerar las miniaturas de los productos o vaciar la caché en el back-office, aparece un error.

Causa: Las carpetas cache y img/tmp no tienen permisos de escritura.

Solución: Cambia los permisos de cache a 755 y los de img/tmp a 755. Si el problema continúa, revisa que el propietario de las carpetas sea el usuario correcto. En DirectAdmin, esto se hace desde el Administrador de archivos, seleccionando la carpeta y usando la opción Cambiar propietario. Si no sabes cuál es el propietario, normalmente es tu nombre de usuario de DirectAdmin.

5. Error al actualizar PrestaShop

Síntoma: Durante una actualización, el proceso se detiene con un mensaje de error de permisos.

Causa: No todas las carpetas y archivos tienen los permisos adecuados para que el asistente de actualización escriba los archivos nuevos.

Solución: Antes de actualizar, establece permisos 755 en todas las carpetas y 644 en todos los archivos de tu instalación. En DirectAdmin, puedes hacer esto seleccionando la carpeta raíz de tu tienda y usando la opción Cambiar permisos recursivamente. Después de la actualización, vuelve a dejar los permisos recomendados.

Guía práctica: cómo cambiar permisos en DirectAdmin paso a paso

DirectAdmin es un panel de control muy intuitivo. Para cambiar los permisos PrestaShop DirectAdmin, sigue estos pasos:

Inicia sesión en tu panel de DirectAdmin (normalmente accedes a través de https://tudominio.com:2222).
Busca y haz clic en el icono Administrador de archivos (File Manager).
Navega hasta la carpeta donde está instalado PrestaShop (normalmente domains/tudominio.com/public_html).
Selecciona la carpeta o archivo al que quieres cambiar los permisos.
Haz clic en el botón Cambiar permisos (o "Permissions" en inglés).
Verás casillas con números. Introduce el valor numérico (por ejemplo, 755) o marca las casillas correspondientes.
Haz clic en Guardar o Aceptar.

TIP: Si tienes que cambiar permisos de muchas carpetas a la vez, selecciona la carpeta raíz y elige la opción "Aplicar a todos los archivos y subdirectorios". Esto te ahorrará muchísimo tiempo.

Tabla de permisos recomendados para PrestaShop

Para que no te pierdas, aquí tienes una tabla simple de lo que deberías usar:

Elemento	Permisos recomendados
Carpetas (directorios)	755
Archivos PHP	644
Archivo `.htaccess`	644
Carpeta `config`	755
Carpeta `cache`	755
Carpeta `log`	755
Carpeta `img`	755
Carpeta `modules`	755
Carpeta `themes`	755
Carpeta `upload`	755
Carpeta `download`	755
Carpeta `translations`	755

WARNING: Evita usar permisos 777 en producción. Aunque solucionan muchos errores rápidamente, dejan tus archivos abiertos a cualquier usuario del sistema, lo que supone un grave riesgo de seguridad. Si tienes que usar 777 temporalmente, vuelve a cambiarlo a 755 o 644 en cuanto resuelvas el problema.

¿Qué pasa si los permisos están bien y el error persiste?

A veces, aunque los permisos sean correctos, el problema está en el propietario de los archivos. En DirectAdmin, el propietario suele ser tu usuario, pero si has subido archivos por FTP con otra cuenta, puede que no coincidan.

Para verificarlo, en el Administrador de archivos de DirectAdmin, mira la columna "Owner". Todos los archivos y carpetas deben pertenecer a tu usuario de hosting. Si ves otro propietario, selecciona todos los archivos (Ctrl+A) y usa la opción Cambiar propietario para asignarlos a tu usuario.

Otra opción es que el error no sea de permisos, sino de configuración. Revisa si has modificado recientemente el archivo settings.inc.php en la carpeta config. Si es así, asegúrate de que la variable _DB_SERVER_ apunte a la base de datos correcta.

Preguntas frecuentes (FAQ) sobre permisos en PrestaShop

¿Puedo usar FTP para cambiar permisos en lugar de DirectAdmin?

Sí, absolutamente. Programas como FileZilla te permiten cambiar permisos haciendo clic derecho sobre el archivo o carpeta y seleccionando "Permisos de archivo". El proceso es el mismo, solo cambia la herramienta.

¿Qué hago si no encuentro el Administrador de archivos en DirectAdmin?

En la mayoría de los planes de hosting con DirectAdmin, el Administrador de archivos está en la pantalla principal. Si no lo ves, es posible que tu proveedor haya desactivado esa opción. En ese caso, contacta con soporte o usa un cliente FTP.

¿Por qué algunos errores se solucionan temporalmente y luego vuelven?

Esto suele pasar cuando un script o actualización cambia los permisos automáticamente. PrestaShop a veces modifica permisos durante procesos como la instalación de módulos. Te recomendamos revisar los permisos después de cada actualización o instalación importante.

¿Es normal que la carpeta `cache` tenga permisos 777?

Algunos alojamientos lo recomiendan para evitar errores, pero no es lo ideal. Si tu tienda funciona bien con 755, déjalo así. Si tienes problemas, puedes probar con 775 antes de llegar a 777.

Consejos finales para mantener tu PrestaShop sano en DirectAdmin

INFO: La prevención es mejor que la cura. Establece una rutina de revisión de permisos cada vez que hagas cambios importantes en tu tienda, como instalar módulos, actualizar la versión o cambiar de tema.

Además, te recomendamos:

Hacer una copia de seguridad completa antes de tocar cualquier permiso.
Anotar los permisos originales antes de cambiarlos, para poder revertir si algo falla.
No dejar archivos de instalación (como install) en el servidor después de instalar PrestaShop.
Mantener tu PrestaShop y sus módulos siempre actualizados para evitar vulnerabilidades.

Si después de seguir esta guía sigues teniendo problemas, no dudes en contactar con tu proveedor de hosting. Ellos podrán revisar la configuración del servidor y asegurarse de que todo esté en orden.

Recuerda: los errores PrestaShop por permisos son de los más comunes, pero también de los más fáciles de solucionar una vez que entiendes cómo funciona el sistema. Con esta guía, ya tienes todas las herramientas para resolverlos tú mismo y mantener tu tienda funcionando sin contratiempos. ¡Mucho ánimo y a vender!