Cómo solucionar problemas de permisos de archivos en PrestaShop (666/755)

Cuando tu tienda PrestaShop empieza a dar errores extraños —como que no se suben imágenes, que no se puede acceder al panel de administración, o que aparecen mensajes de "no se puede escribir en el archivo"—, lo más probable es que estés ante un problema de permisos de archivos. Es uno de los fallos más comunes, pero también uno de los más fáciles de solucionar si sabes exactamente qué estás haciendo.

En esta guía extensa y paso a paso, vamos a desglosar todo lo que necesitas saber sobre los permisos archivos prestashop, la configuración correcta de los permisos carpetas prestashop, cómo usar el comando chmod prestashop y, sobre todo, cómo diagnosticar y reparar los temidos errores permisos prestashop.

No necesitas ser un experto en informática. Si puedes seguir instrucciones sencillas, al final de este artículo tendrás tu tienda funcionando como nueva.

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

Piensa en tu servidor como en un edificio de oficinas. Cada archivo y carpeta de tu instalación de PrestaShop es una sala, y los permisos son las llaves que deciden quién puede entrar, quién puede leer los documentos y quién puede modificar el mobiliario.

En el mundo de Linux (donde se alojan la mayoría de las webs), estos permisos se expresan con números. Los verás siempre en formato de tres dígitos, como 644, 755 o 666. Cada dígito representa un tipo de usuario:

• El primer dígito (dueño): El creador del archivo, normalmente tu usuario de hosting.
• El segundo dígito (grupo): Un grupo de usuarios con acceso compartido.
• El tercer dígito (público): El resto del mundo (visitantes de tu web).

Cada dígito es una suma de valores: 4 (lectura), 2 (escritura) y 1 (ejecución). Por lo tanto:

• 7 (4+2+1): Permiso total (leer, escribir y ejecutar).
• 6 (4+2): Leer y escribir, pero no ejecutar.
• 5 (4+1): Leer y ejecutar, pero no escribir.
• 4: Solo lectura.

PrestaShop necesita poder escribir en ciertos directorios para funcionar (por ejemplo, para crear cachés, subir productos o generar archivos de log). Si los permisos son demasiado restrictivos, la tienda falla. Si son demasiado abiertos (como el famoso 777), te expones a ataques de seguridad.

La configuración mágica: ¿Cuáles son los permisos correctos?

La regla de oro para PrestaShop es sencilla de recordar y es la que te evitará el 90% de los errores permisos prestashop.

### Para archivos (no carpetas)

La mayoría de los archivos de tu instalación (como los de configuración, las clases PHP, etc.) deben tener el permiso 644.

• 644 significa: El dueño puede leer y escribir (6), el grupo puede leer (4) y el público puede leer (4).

Esto permite que el servidor lea los archivos para mostrar tu web, pero solo el dueño (tú o tu aplicación) puede modificarlos.

### Para carpetas (directorios)

Todas las carpetas de tu PrestaShop (como /img, /var, /cache, /log, etc.) deben tener el permiso 755.

• 755 significa: El dueño puede hacer todo (7), el grupo puede leer y ejecutar (5), y el público puede leer y ejecutar (5).

La "ejecución" en una carpeta se traduce en poder entrar a ella y listar su contenido. Esto es esencial para que el navegador pueda acceder a las imágenes y archivos CSS.

### La excepción: Carpetas y archivos de escritura dinámica

Existe un pequeño grupo de carpetas que necesitan permisos más altos para que PrestaShop pueda generar y modificar archivos sobre la marcha. Hablamos de las carpetas de caché, configuración y subida de archivos. Para estas, el estándar recomendado es 755 para carpetas y 644 para archivos, aunque en algunos servidores compartidos con configuraciones especiales, puede que necesites usar 775 o 776 para que el usuario del servidor web (como www-data) pueda escribir.

Las carpetas críticas que suelen dar guerra son:

• /cache
• /config
• /img
• /log
• /mails
• /modules
• /themes
• /translations
• /upload
• /var
• /app
• /var/cache
• /var/logs

Si aplicas 755 en todas las carpetas y 644 en todos los archivos, resolverás el 99% de los casos. Si aún así tienes errores de escritura, prueba a cambiar solo las carpetas mencionadas a 775.

Cómo cambiar los permisos: 3 métodos infalibles

Ahora que sabes qué necesitas, vamos a ver cómo hacerlo. Tienes tres caminos, de más fácil a más técnico.

Método 1: Usando el Administrador de Archivos de tu Hosting (El más fácil)

Casi todos los paneles de control de hosting (cPanel, Plesk, Syspanel, etc.) incluyen un "Administrador de Archivos". Este es el método más visual y recomendado para principiantes.

1. Accede a tu panel de control: Entra en el panel de tu proveedor de hosting (por ejemplo, cPanel o Syspanel, que se accede normalmente por el puerto 2106 en ese panel específico).
2. Abre el Administrador de Archivos: Busca el icono que dice "Administrador de Archivos" o "File Manager".
3. Navega a tu tienda: Ve a la carpeta donde está instalada tu PrestaShop. Normalmente es public_html o htdocs.
4. Selecciona todo: En la barra superior, haz clic en "Seleccionar todo" o usa Ctrl+A (Cmd+A en Mac).
5. Cambia los permisos: Con todo seleccionado, haz clic derecho y elige la opción "Permisos" o "Change Permissions".
6. Introduce el código numérico: En el cuadro de diálogo, verás casillas para "Leer", "Escribir" y "Ejecutar". Pero es más rápido escribir directamente el número en el campo "Permisos" o "Numeric value". Escribe 644 para archivos y 755 para carpetas.
7. Aplica: Haz clic en "Guardar" o "Change".

[WARNING] Haz esto por separado. Primero selecciona solo archivos y pon 644. Luego selecciona solo carpetas y pon 755. Si tu administrador de archivos no te permite filtrar fácilmente, selecciona todo y pon 755, y luego ve a las carpetas de configuración y baja los archivos a 644. Es un poco más tedioso, pero funciona.

Método 2: Usando un Cliente FTP (FileZilla, etc.)

Si te sientes cómodo con FTP, este método es muy rápido y te da control total.

1. Conecta a tu servidor: Abre tu cliente FTP (FileZilla es el más popular) y conéctate con tus credenciales de hosting.
2. Selecciona los archivos: En el panel remoto (el que muestra tu web), navega a la raíz de PrestaShop. Haz clic en la primera carpeta, ve al final y presiona Shift + clic en la última para seleccionarlas todas.
3. Abre el menú contextual: Haz clic derecho en la selección y elige "Permisos de archivo..." (File permissions...).
4. Configura los permisos: En la ventana emergente, escribe 755 en el campo "Valor numérico" y asegúrate de marcar la casilla "Aplicar a los subdirectorios" (Apply to subdirectories) y luego seleccionar "Solo directorios" (Only directories). Pulsa OK.
5. Repite para archivos: Ahora, haz lo mismo, pero esta vez escribe 644 en el valor numérico y en la opción "Aplicar a los subdirectorios", elige "Solo archivos" (Only files). Pulsa OK.

[TIP] Este método de "dos pasadas" es el más seguro y limpio. Evita usar la opción "Aplicar a todos los archivos y directorios" de una sola vez, ya que no distingue entre tipos.

Método 3: Usando el Terminal SSH (Para usuarios avanzados)

Si tienes acceso SSH, puedes hacerlo todo con un solo comando. Es la forma más rápida y elegante.

1. Conéctate por SSH a tu servidor.
2. Navega a la raíz de tu tienda:

   cd /ruta/a/tu/prestashop
   

3. Cambia los permisos de todas las carpetas: Este comando busca todas las carpetas y les asigna 755.

   find . -type d -exec chmod 755 {} \;
   

4. Cambia los permisos de todos los archivos: Este comando busca todos los archivos y les asigna 644.

   find . -type f -exec chmod 644 {} \;
   

[INFO] Si después de esto sigues teniendo problemas de escritura, es posible que tu servidor use un "grupo" específico para el usuario web. En ese caso, cambia los permisos de las carpetas críticas (cache, log, img, etc.) a 775 usando el comando:

chmod -R 775 cache log img upload var

Errores comunes y soluciones específicas

A veces, el problema no es global, sino específico de una función. Aquí tienes las soluciones para los errores permisos prestashop más típicos.

Error: "No se puede escribir en el archivo de configuración"

Este error suele aparecer durante la instalación o al guardar ajustes. Indica que el archivo config/settings.inc.php (o app/config/parameters.php en versiones modernas) no tiene permisos de escritura.

• Solución: Temporalmente, cambia los permisos de ese archivo a 666 (escritura total). Realiza el cambio en tu panel de administración. Después, vuelve a cambiarlo a 644 por seguridad.

Error: No se pueden subir imágenes o productos

Si al subir una imagen de producto te da error, la carpeta /img o /upload no tiene permisos de escritura para el usuario del servidor web.

• Solución: Asegúrate de que la carpeta /img y sus subcarpetas tengan 755 o 775. Si el error persiste, prueba con 777 temporalmente para diagnosticar, pero nunca lo dejes así de forma permanente. Es un riesgo de seguridad grave.

Error: La caché no funciona o la tienda está muy lenta

PrestaShop necesita escribir en la carpeta /var/cache (o /cache en versiones antiguas) constantemente.

• Solución: Borra el contenido de la carpeta cache (no la carpeta en sí) y luego asegúrate de que la carpeta tenga 755. En algunos servidores, el usuario de FTP y el usuario de PHP son diferentes. En ese caso, necesitarás 775 o incluso 777 para que PHP pueda escribir.

Error: No se pueden instalar módulos o temas

Al igual que con las imágenes, la instalación de módulos requiere escritura en /modules y /themes.

• Solución: Cambia los permisos de estas carpetas a 755 y sus archivos a 644. Si falla, intenta con 775 en las carpetas.

Cómo prevenir futuros problemas de permisos

Una vez que hayas solucionado el problema, es crucial que tomes medidas para que no vuelva a suceder.

1. Mantén PrestaShop actualizado: Cada versión corrige errores y mejora la gestión de archivos.
2. No utilices permisos 777: Es la puerta de entrada favorita de los hackers. Úsalo solo para diagnóstico y durante unos minutos.
3. Configura bien el "Propietario" de los archivos: En tu panel de control, asegúrate de que los archivos pertenezcan a tu usuario de FTP y no a "nadie" o a "root". Esto se hace desde el Administrador de Archivos, en la opción "Cambiar propietario".
4. Haz copias de seguridad: Si tocas permisos con un comando masivo, siempre es bueno tener una copia de seguridad reciente. Si algo sale mal, puedes restaurarla.

Preguntas Frecuentes (FAQ)

Para terminar, resolvemos las dudas más habituales sobre los permisos archivos prestashop.

¿Qué hago si no tengo acceso FTP ni al Administrador de Archivos?

Si tu hosting es muy restrictivo, contacta con el soporte técnico de tu proveedor. Ellos pueden ejecutar los comandos chmod por ti. Es la opción más segura. Recuerda que si usan Syspanel, el acceso al administrador de archivos suele estar en la pestaña "Archivos" y el puerto de acceso al panel es el 2106.

¿Es lo mismo 755 que 775?

No. 755 da al "grupo" permiso de lectura y ejecución, pero no de escritura. 775 sí da al grupo permiso de escritura. Si tu servidor usa un grupo compartido para el web (lo cual es común en hosting compartido), necesitarás 775 para que PHP pueda escribir. Si usas un VPS o dedicado, 755 suele ser suficiente.

¿Por qué PrestaShop me pide permisos 666 en algunos archivos?

El permiso 666 significa que todos los usuarios pueden leer y escribir, pero no ejecutar. PrestaShop lo usa temporalmente en archivos de configuración durante el proceso de instalación o actualización. Una vez terminado, debes volver a 644. Es una práctica común y segura si se revierte correctamente.

He cambiado los permisos y ahora mi web está en blanco. ¿Qué hago?

No entres en pánico. Esto suele pasar si has puesto permisos demasiado restrictivos (como 400 o 600) en archivos PHP. Vuelve a poner todos los archivos a 644 y las carpetas a 755 siguiendo el Método 1 o 2 de esta guía. La web debería volver a la vida inmediatamente.

Esperamos que esta guía te haya sido de gran ayuda. Los errores permisos prestashop son un dolor de cabeza, pero con esta información, tienes todas las herramientas para solucionarlos tú mismo de forma rápida y segura. Si tienes más dudas, recuerda que la documentación oficial y los foros de la comunidad PrestaShop son excelentes recursos.