Cómo gestionar los permisos de archivos en PrestaShop (cPanel)

¿Te ha pasado que al instalar un módulo en PrestaShop te aparece un error de permisos? ¿O que no puedes subir imágenes o modificar archivos de configuración? No te preocupes, no eres el único. Gestionar los permisos de archivos en PrestaShop es una de las tareas más comunes (y a veces frustrantes) para cualquier administrador de tienda online. Pero, ¿sabes qué? Es mucho más sencillo de lo que parece si entiendes los conceptos básicos y sabes exactamente dónde hacer clic en tu cPanel.

En esta guía extensa y paso a paso, vamos a desglosar todo lo que necesitas saber sobre el chmod PrestaShop, cómo configurar permisos PrestaShop correctamente y cómo hacerlo desde cPanel permisos PrestaShop sin volverte loco en el intento. Al final, serás capaz de resolver este tipo de problemas tú mismo, sin necesidad de pagar a un técnico.

¿Qué son exactamente los permisos de archivos?

Antes de entrar en materia, vamos a usar una analogía simple. Imagina que tu tienda online es un edificio de oficinas.

• Los archivos y carpetas son las habitaciones y los archivadores.
• Los usuarios (tú, el servidor, los visitantes) son los empleados.
• Los permisos son las llaves que tiene cada empleado para abrir esas habitaciones.

En el mundo de Linux (que es donde se aloja tu web), cada archivo y carpeta tiene un conjunto de permisos que indican quién puede leer, escribir o ejecutar ese archivo.

Hay tres tipos de usuarios que pueden tener permisos:

1. Usuario (Owner): Generalmente, el dueño del archivo. En cPanel, suele ser el nombre de usuario de tu cuenta de hosting.
2. Grupo (Group): Un conjunto de usuarios que comparten acceso. En hosting compartido, suele ser el mismo que el usuario o un grupo genérico.
3. Mundo (Public): Todos los demás, incluyendo los visitantes de tu tienda.

Cada uno de estos usuarios tiene tres acciones posibles:

• Lectura (Read - r): Ver el contenido del archivo o listar el contenido de una carpeta.
• Escritura (Write - w): Modificar el archivo o crear/eliminar archivos dentro de una carpeta.
• Ejecución (Execute - x): Ejecutar el archivo (si es un script) o entrar en una carpeta.

Cuando ves números como 644 o 755, eso es el sistema numérico para representar estos permisos. Se llama chmod.

Entendiendo el código Chmod (644, 755, 775)

Vamos a descifrar el código. Cada dígito representa los permisos para un tipo de usuario (Usuario, Grupo, Mundo).

• 4 = Lectura (r)
• 2 = Escritura (w)
• 1 = Ejecución (x)

Para obtener el número, simplemente sumas los valores de los permisos que quieres dar.

• 7 = 4 + 2 + 1 (Lectura, Escritura y Ejecución)
• 6 = 4 + 2 (Lectura y Escritura)
• 5 = 4 + 1 (Lectura y Ejecución)
• 4 = 4 (Solo Lectura)

Ahora, aplicado a tu PrestaShop:

• 644: El dueño puede leer y escribir (6), pero el grupo y el mundo solo pueden leer (4 y 4). Este es el permiso estándar para archivos en PrestaShop.
• 755: El dueño puede leer, escribir y ejecutar (7), mientras que el grupo y el mundo solo pueden leer y ejecutar (5 y 5). Este es el permiso estándar para carpetas en PrestaShop.
• 775: Similar al 755, pero el grupo también puede escribir. A veces se usa para carpetas de caché o subida de archivos.

[INFO] La regla de oro es: Archivos = 644 y Carpetas = 755. Si algo no funciona, el problema suele estar en que un archivo tiene permisos de carpeta (755) o una carpeta tiene permisos demasiado restrictivos (644).

¿Por qué necesitas configurar los permisos en PrestaShop?

PrestaShop es una aplicación compleja que necesita crear archivos de caché, subir imágenes de productos, actualizar módulos y escribir en archivos de configuración. Si los permisos son demasiado restrictivos, el servidor no podrá hacer estas tareas y verás errores como:

• "No se puede escribir en el archivo" o "Error de escritura".
• No se suben las imágenes de los productos.
• No se puede guardar la configuración del panel de administración.
• La caché no se regenera, lo que hace que tu tienda se vea extraña o no se actualicen los cambios.
• Errores 500 en el navegador.

Por otro lado, si los permisos son demasiado abiertos (por ejemplo, 777), cualquier persona podría modificar tus archivos, lo que supone un gravísimo riesgo de seguridad.

[WARNING] ¡Ojo con el 777! Nunca uses permisos 777 a no ser que sea por un minuto y sepas exactamente lo que haces. Es como darle las llaves de tu casa a todo el mundo. Un atacante podría inyectar código malicioso en tu tienda.

Cómo cambiar los permisos de archivos en PrestaShop con cPanel

Ahora vamos a lo práctico. Te voy a enseñar dos métodos para configurar permisos PrestaShop desde tu cPanel. El primero es visual (el más fácil para principiantes) y el segundo es más técnico (pero más rápido si tienes muchos archivos).

Método 1: Usando el Administrador de Archivos de cPanel (El método visual)

Este es el método más recomendado si no estás familiarizado con la línea de comandos. Es seguro y te da control total.

Paso 1: Accede a tu cPanel

Abre tu navegador y ve a tudominio.com/cpanel o usa el acceso directo que te dio tu proveedor de hosting. Introduce tu usuario y contraseña.

Paso 2: Abre el Administrador de Archivos

Busca la sección "Archivos" y haz clic en el icono de Administrador de Archivos (File Manager).

Paso 3: Navega hasta la carpeta de PrestaShop

En el panel derecho, busca la carpeta public_html (o www). Dentro de ella, estará la carpeta raíz de tu PrestaShop. Si lo instalaste directamente, será public_html. Si lo tienes en un subdirectorio (por ejemplo, public_html/tienda), navega hasta allí.

Paso 4: Selecciona los archivos o carpetas

Para cambiar los permisos de un archivo o carpeta específica:

1. Haz clic derecho sobre el archivo o carpeta.
2. Selecciona Permisos en el menú desplegable.

Paso 5: Modifica los permisos

Se abrirá una ventana emergente. Verás una serie de casillas de verificación y un campo numérico.

• Método fácil: Marca o desmarca las casillas de "Leer", "Escribir" y "Ejecutar" para el Usuario, Grupo y Mundo. Observa cómo el campo numérico (chmod) cambia automáticamente.
• Método directo: Escribe directamente el número en el campo "Permisos" (por ejemplo, 644 o 755).

Paso 6: Aplica los cambios

Haz clic en Cambiar permisos y listo. Repite este proceso para cada archivo o carpeta que necesites ajustar.

[TIP] Si tienes que cambiar muchos archivos, este método puede ser tedioso. Para eso, te recomiendo el Método 2.

Método 2: Usando el Terminal de cPanel (El método rápido)

Esta opción es mucho más potente y te permite cambiar los permisos de todos los archivos y carpetas de tu PrestaShop con un solo comando. Es ideal para "resetear" todos los permisos a los valores correctos.

Paso 1: Accede a la Terminal

En tu cPanel, busca la sección "Avanzado" y haz clic en el icono de Terminal. Se abrirá una ventana de terminal (línea de comandos) directamente en tu cuenta de hosting.

Paso 2: Navega a tu carpeta de PrestaShop

Escribe el siguiente comando y presiona Enter:

cd ~/public_html

Si tu tienda está en un subdirectorio, escribe:

cd ~/public_html/tucarpeta

Paso 3: Ejecuta el comando para archivos

Para cambiar todos los archivos a permisos 644, escribe este comando y presiona Enter:

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

Vamos a descifrarlo:

• find .: Busca desde la carpeta actual.
• -type f: Solo busca archivos (no carpetas).
• -exec chmod 644 {} \;: Ejecuta el comando chmod 644 en cada archivo encontrado.

Paso 4: Ejecuta el comando para carpetas

Ahora, para cambiar todas las carpetas a permisos 755, escribe este comando y presiona Enter:

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

Este comando es similar al anterior, pero con -type d (directorios) y aplica el permiso 755.

Paso 5: Verifica los cambios

Puedes usar el comando ls -la para ver los permisos de los archivos en la carpeta actual. Verás una cadena de letras como -rw-r--r-- (que significa 644) o drwxr-xr-x (que significa 755).

[TIP] Si tu tienda tiene problemas con la carpeta de caché o img, es posible que necesites darle permisos más flexibles temporalmente (por ejemplo, 775 para carpetas y 664 para archivos dentro de esas carpetas). Pero lo ideal es volver a 755 y 644 después de solucionar el problema.

Configuraciones especiales para directorios clave en PrestaShop

Aunque la regla general es 644 para archivos y 755 para carpetas, hay ciertos directorios en PrestaShop que necesitan permisos de escritura para que la tienda funcione correctamente. Aquí te dejo una lista de los más importantes:

• /config: Contiene archivos de configuración cruciales. En ocasiones, el instalador necesita escribir aquí. Debe ser 755 para la carpeta y 644 para los archivos, pero si tienes problemas para guardar ajustes, prueba con 775 en la carpeta.
• /cache: Aquí PrestaShop guarda archivos temporales para acelerar la carga. Necesita permisos de escritura. La carpeta debe ser 755 y los archivos 644. Si ves errores de caché, intenta con 775 en la carpeta.
• /img: Es donde se guardan todas las imágenes de tus productos y tu logo. Necesita permisos de escritura para que puedas subir nuevas imágenes. La carpeta debe ser 755 y los archivos 644.
• /log: Almacena los registros de errores de la tienda. Debe ser escribible. Carpeta 755, archivos 644.
• /var/cache y /var/logs (PrestaShop 1.7+): En versiones modernas, estas carpetas son cruciales. Deben tener permisos de escritura. Asegúrate de que la carpeta var (y sus subcarpetas) tengan permisos 755 y los archivos 644.
• /upload: Se usa para subir archivos personalizados. La carpeta debe ser 755.
• /modules: Las carpetas de los módulos necesitan permisos de escritura para que puedas instalarlos o actualizarlos. La carpeta principal debe ser 755 y las subcarpetas también.

[INFO] Después de cambiar los permisos de estas carpetas, es una buena práctica vaciar la caché de PrestaShop desde el panel de administración (Parámetros avanzados > Rendimiento > Vaciar la caché) para asegurarte de que todo se regenera correctamente.

¿Qué permisos debo usar para config.php?

El archivo config/settings.inc.php (en PrestaShop 1.6) o app/config/parameters.php (en PrestaShop 1.7+) contiene la configuración de acceso a tu base de datos. Es un archivo muy sensible.

• Permisos recomendados: 644. Esto permite que el servidor lo lea, pero no que cualquiera pueda escribirlo.
• Durante la instalación: El instalador necesita escribir en él. Si el instalador te pide permisos de escritura, cámbialo temporalmente a 666 o 777. Después de la instalación, cámbialo de vuelta a 644 inmediatamente.

[WARNING] Dejar config/settings.inc.php con permisos 777 es un error de seguridad crítico. Cualquiera podría modificar la configuración de tu base de datos y robar tu información. Asegúrate siempre de que tenga permisos 644.

Resolviendo problemas comunes con permisos (FAQ)

Aquí tienes algunas preguntas frecuentes que nos suelen llegar al soporte:

1. He cambiado los permisos y ahora mi tienda da un error 500. ¿Qué hago?

No te asustes. Esto suele pasar si has puesto permisos demasiado restrictivos (por ejemplo, 600 en archivos o 700 en carpetas). Vuelve a poner todos los archivos a 644 y todas las carpetas a 755 usando el método del Terminal que te enseñé antes. Esto debería solucionar el problema al instante.

2. ¿Por qué no puedo subir imágenes a mi PrestaShop?

Este es un problema clásico. Primero, verifica que la carpeta img y sus subcarpetas tengan permisos 755. También revisa que la carpeta img/tmp exista y tenga permisos 755. Si el problema persiste, puede ser un límite de memoria PHP, pero el 90% de las veces es un problema de permisos.

3. ¿Es seguro usar permisos 777 en mi hosting?

No, absolutamente no. Es la puerta abierta a los hackers. Si un archivo tiene permisos 777, cualquier usuario del servidor puede leerlo, modificarlo o ejecutarlo. Úsalo solo en casos muy extremos y por un tiempo muy limitado, y siempre vuelve a cambiar a 644 o 755 después.

4. ¿Qué hago si no tengo acceso a la Terminal en mi cPanel?

No pasa nada. Puedes usar el Administrador de Archivos de cPanel, pero es más lento si tienes muchos archivos. En ese caso, selecciona todos los archivos de una carpeta (Ctrl+A) y haz clic en "Permisos" para cambiarlos en lote. Otra opción es usar un cliente FTP como FileZilla, que también te permite cambiar permisos haciendo clic derecho sobre los archivos.

[TIP] FileZilla es una herramienta excelente. Si te pierdes en el Administrador de Archivos de cPanel, descarga FileZilla, conéctate a tu servidor con tus credenciales FTP y podrás cambiar permisos de forma visual arrastrando y soltando archivos.

Consejos de seguridad adicionales

Gestionar cPanel permisos PrestaShop no es solo hacer que funcione, sino también mantenerlo seguro. Aquí van unos consejos extra:

• Revisa los permisos periódicamente: Cada cierto tiempo, especialmente después de instalar o actualizar módulos, verifica que los permisos no se hayan cambiado a valores peligrosos como 777.
• No uses el usuario root: Asegúrate de que todos tus archivos pertenezcan a tu usuario de cPanel, no al usuario root. Puedes verificar esto en el Administrador de Archivos (columna "Propietario").
• Mantén PrestaShop actualizado: Las actualizaciones corrigen vulnerabilidades de seguridad que podrían explotarse a través de permisos incorrectos.
• Copia de seguridad antes de tocar nada: Antes de hacer cambios masivos de permisos, haz una copia de seguridad de tu sitio. Si algo sale mal, puedes restaurarlo fácil