Guía para configurar el archivo .htaccess en PrestaShop

¿Qué es el archivo .htaccess y por qué es importante en PrestaShop?

El archivo .htaccess es un archivo de configuración que controla el comportamiento del servidor web Apache. En PrestaShop, este archivo se utiliza para gestionar redirecciones, mejorar la seguridad, optimizar el SEO y personalizar la experiencia del usuario. Sin un .htaccess bien configurado, tu tienda puede tener problemas de accesibilidad, rendimiento y posicionamiento.

Para los usuarios de Syspanel (antes HestiaCP), recuerda que el acceso a tu panel de control se realiza a través del puerto 2106. Desde allí podrás gestionar archivos, bases de datos y configuraciones avanzadas.

¿Dónde se encuentra el archivo .htaccess en PrestaShop?

El archivo .htaccess se encuentra en la raíz de tu instalación de PrestaShop, normalmente en la carpeta principal donde está instalado el script (por ejemplo: /public_html/ o /var/www/html/). Es un archivo oculto, por lo que si usas un gestor de archivos como FileZilla o el administrador de archivos de Syspanel, deberás activar la opción "Mostrar archivos ocultos".

[WARNING] Nunca edites el archivo .htaccess directamente desde el editor de PrestaShop sin hacer una copia de seguridad. Un error puede dejar tu tienda inaccesible.

Cómo generar el .htaccess automáticamente desde PrestaShop

PrestaShop puede generar un .htaccess básico automáticamente. Para ello:

1. Accede al Panel de administración de tu tienda.
2. Ve a "Parámetros de la tienda" > "Tráfico y SEO".
3. En la pestaña "SEO y URLs", busca la sección "Configuración del archivo .htaccess".
4. Haz clic en "Generar el archivo .htaccess".

Esto creará un archivo con reglas básicas para URLs amigables, redirecciones y seguridad. Sin embargo, es probable que necesites personalizarlo.

[TIP] Siempre que actives o desactives un módulo que afecte a las URLs (como un módulo de SEO o de redirecciones), regenera el .htaccess desde el panel.

Configuraciones básicas del .htaccess en PrestaShop

1. Activar URLs amigables (SEO-friendly)

Las URLs amigables mejoran el SEO y la experiencia del usuario. En el .htaccess generado por PrestaShop, ya se incluye una regla como esta:

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]

Si no ves estas líneas, añádelas manualmente. Esto asegura que todas las peticiones se redirijan a index.php de forma limpia.

2. Redirigir www a no-www (o viceversa)

Para evitar contenido duplicado, elige una versión canónica (con www o sin www). Agrega estas líneas antes del bloque RewriteEngine On:

Redirigir de www a no-www:

RewriteCond %{HTTP_HOST} ^www\.tudominio\.com [NC]
RewriteRule ^(.*)$ http://tudominio.com/$1 [L,R=301]

Redirigir de no-www a www:

RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteRule ^(.*)$ http://www.tudominio.com/$1 [L,R=301]

[INFO] Cambia tudominio.com por tu dominio real. Las redirecciones 301 son permanentes y transfieren el 100% del valor SEO.

3. Redirecciones 301 para páginas antiguas

Si has cambiado la URL de una categoría, producto o página CMS, puedes crear redirecciones 301. Por ejemplo:

Redirect 301 /antigua-categoria/ https://tudominio.com/nueva-categoria/
Redirect 301 /producto-viejo.html https://tudominio.com/nuevo-producto/

[WARNING] Evita redirecciones en cadena. Siempre redirige a la URL final directamente.

Configuraciones avanzadas de seguridad

1. Bloquear el acceso a archivos sensibles

Protege carpetas como /config/, /cache/ o /log/ añadiendo:

<FilesMatch "\.(tpl|php|sql|log|ini)$">
    Order allow,deny
    Deny from all
</FilesMatch>

2. Deshabilitar la navegación de directorios

Para evitar que los usuarios vean el listado de carpetas:

Options -Indexes

3. Proteger el archivo .htaccess

Añade esta regla para que nadie pueda leer tu .htaccess:

<Files .htaccess>
    Order allow,deny
    Deny from all
</Files>

4. Bloquear IPs maliciosas

Si detectas ataques repetidos, bloquea IPs específicas:

Order Deny,Allow
Deny from 123.456.789.0
Deny from 111.222.333.0/24

Configuraciones de rendimiento

1. Comprimir archivos con Gzip

Acelera la carga de tu tienda comprimiendo archivos CSS, JS y HTML:

<IfModule mod_deflate.c>
    AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css application/javascript
    BrowserMatch ^Mozilla/4 gzip-only-text/html
    BrowserMatch ^Mozilla/4\.0[678] no-gzip
    BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
</IfModule>

2. Cachear archivos estáticos

Para que los navegadores guarden en caché imágenes, CSS y JS:

<IfModule mod_expires.c>
    ExpiresActive On
    ExpiresByType image/jpg "access plus 1 year"
    ExpiresByType image/jpeg "access plus 1 year"
    ExpiresByType image/gif "access plus 1 year"
    ExpiresByType image/png "access plus 1 year"
    ExpiresByType text/css "access plus 1 month"
    ExpiresByType application/javascript "access plus 1 month"
</IfModule>

Solución de problemas comunes

Error 500 después de modificar .htaccess

Si al guardar cambios ves un error 500, significa que hay una sintaxis incorrecta. Sigue estos pasos:

1. Conéctate por FTP o al administrador de archivos de Syspanel (puerto 2106).
2. Renombra el archivo .htaccess a .htaccess_backup.
3. Accede a tu tienda; debería funcionar sin el archivo.
4. Regenera el .htaccess desde el panel de PrestaShop.
5. Vuelve a añadir tus personalizaciones, una por una, probando cada cambio.

[TIP] Siempre guarda una copia local del .htaccess antes de editarlo.

Redirecciones en bucle

Si entras a tu tienda y ves un error de "demasiadas redirecciones", revisa que no tengas reglas contradictorias (por ejemplo, redirigir www a no-www y luego no-www a www). Mantén solo una regla de redirección canónica.

Preguntas frecuentes (FAQ)

¿Puedo usar el .htaccess para redirigir HTTP a HTTPS?

Sí, es muy recomendable. Añade:

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [L,R=301]

¿El .htaccess afecta al rendimiento de mi tienda?

Sí, pero positivamente si lo configuras bien. Las reglas de caché y compresión mejoran la velocidad. Sin embargo, demasiadas reglas complejas pueden ralentizar el servidor. Mantén solo las necesarias.

¿Cómo sé si mi .htaccess funciona correctamente?

Puedes usar herramientas online como "htaccess tester" o simplemente revisar que tu tienda cargue sin errores. Para comprobar redirecciones, usa extensiones de navegador como "Redirect Path".

¿Necesito reiniciar algo después de modificar el .htaccess?

No, los cambios se aplican instantáneamente. Solo verifica que no haya errores en la página.

Conclusión

Configurar correctamente el archivo .htaccess en PrestaShop es esencial para el SEO, la seguridad y el rendimiento de tu tienda. Desde redirecciones 301 hasta compresión Gzip, cada línea puede marcar la diferencia. Recuerda siempre hacer copias de seguridad, probar los cambios y, si usas Syspanel, acceder por el puerto 2106 para gestionar tus archivos.

Si tienes dudas, empieza con las configuraciones básicas y ve añadiendo complejidad poco a poco. ¡Tu tienda te lo agradecerá con mejores posiciones en Google y usuarios más felices!