¿Qué es .htaccess?
El archivo .htaccess (hypertext access) es un archivo de configuración usado por los servidores Apache, que permite regular algunos comportamientos de un sitio web, sin tener que tocar los archivos de configuración del servidor, ajustando cosas como redirecciones, seguridad, URLs amigables o rendimiento.
Nota: El punto al inicio (.htaccess) indica que es un archivo oculto. Asegúrate de que tu editor o cliente FTP muestre archivos ocultos para verlo.
Antes de empezar: que Apache lo lea
Apache solo tiene en cuenta un .htaccess si la configuración del sitio lo permite con la directiva AllowOverride. Si instalaste Apache con apt, la configuración general trae AllowOverride None para todo /var/www, y con eso el archivo se ignora entero, sin ningún aviso. Para que se lea, el VirtualHost de tu sitio necesita AllowOverride All, como en el ejemplo de Configuración de Apache. Es lo primero que hay que comprobar cuando un .htaccess "no hace nada". En un hosting compartido suele estar permitido.
Apache lee el .htaccess en cada petición, así que los cambios se aplican al momento, sin reiniciar nada. Por esa misma razón, si controlas el servidor, es algo más eficiente poner estas reglas directamente en el VirtualHost.
¿Para qué sirve .htaccess?
Con .htaccess, puedes hacer muchas cosas útiles para tu sitio web.
- Redirecciones: Por ejemplo, redirigir todo el tráfico de HTTP a HTTPS para que tu sitio sea seguro.
- URLs amigables: Convertir URLs largas y feas en cortas y legibles (como
misitio.test/producto/123en lugar demisitio.test/index.php?id=123). - Seguridad: Bloquear el acceso a carpetas sensibles o proteger archivos.
- Optimización: Habilitar compresión de archivos o caché para que tu sitio cargue más rápido.
- Errores personalizados: Mostrar páginas de error (como 404) con tu propio diseño.
Ejemplos prácticos de .htaccess
A continuación, algunos ejemplos de uso común. Para los que usan reglas de reescritura (Rewrite...), tu servidor Apache necesita tener activado el módulo mod_rewrite.
1. Redirigir de HTTP a HTTPS
Forzar que tu sitio use HTTPS (conexión segura):
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
Explicación: Si alguien accede a http://misitio.test, será redirigido a https://misitio.test.
El R=301 indica una redirección permanente, buena para SEO.
2. Crear URLs amigables
Si tienes un sitio con URLs como misitio.test/index.php?page=contacto, puedes hacer que se vean como misitio.test/contacto.
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?page=$1 [L]
Explicación: Esta regla reescribe internamente cualquier URL (que no sea un archivo o carpeta real) a index.php, pasando el nombre de la página como parámetro. Por ejemplo, misitio.test/contacto se sirve como misitio.test/index.php?page=contacto, pero el visitante sigue viendo misitio.test/contacto en la barra de direcciones.
3. Proteger una carpeta con contraseña
Si tienes una carpeta como /admin, puedes protegerla para que solo accedan usuarios con contraseña. Dentro de esa carpeta, crea un .htaccess con:
AuthType Basic
AuthName "Acceso restringido"
AuthUserFile /var/www/misitio.test/.htpasswd
Require valid-user
Las contraseñas se guardan en un archivo aparte, .htpasswd, que se crea con el comando htpasswd:
# El comando htpasswd está en el paquete apache2-utils
sudo apt install apache2-utils
# -c crea el archivo; omítelo al añadir más usuarios o lo sobrescribirás
htpasswd -c /var/www/misitio.test/.htpasswd ana
Guarda .htpasswd fuera de la carpeta pública, donde el navegador no puede llegar. Por ejemplo, si tu sitio se sirve desde /var/www/misitio.test/public_html, ponlo un nivel por encima, en /var/www/misitio.test/, como en los comandos anteriores. AuthUserFile necesita la ruta completa. En un hosting compartido, pregunta a tu proveedor cuál es esa ruta; muchos paneles de control ofrecen además una opción para proteger carpetas sin escribir nada a mano.
4. Habilitar compresión para mejorar la velocidad
Comprimir archivos como CSS, JS o HTML reduce el tiempo de carga.
<IfModule mod_deflate.c>
AddOutputFilterByType DEFLATE text/html
AddOutputFilterByType DEFLATE text/css
AddOutputFilterByType DEFLATE application/javascript
AddOutputFilterByType DEFLATE text/xml
AddOutputFilterByType DEFLATE application/xml
AddOutputFilterByType DEFLATE application/xhtml+xml
AddOutputFilterByType DEFLATE application/rss+xml
</IfModule>
Explicación: Esto activa la compresión DEFLATE (el mismo algoritmo que usa GZIP) para archivos de texto, CSS y JavaScript. No comprime imágenes (como JPG o PNG) porque ya están comprimidas. Si instalaste Apache con apt, mod_deflate ya viene activado y configurado para estos tipos; este bloque es útil en un hosting donde no lo esté.
¿Cuánto mejora el rendimiento? La compresión DEFLATE puede reducir el tamaño de archivos de texto entre un 50% y 80%, lo que hace que las páginas carguen más rápido, a veces hasta un 15-30% menos de tiempo en sitios pequeños. Por ejemplo, un archivo CSS grande puede reducirse hasta un 83%, según pruebas reales. Sin embargo, comprimir archivos usa algo de CPU, así que en sitios con mucho tráfico dinámico (como una tienda online grande), el servidor podría trabajar más. Para sitios pequeños o personales, el impacto en CPU es mínimo y el beneficio en velocidad es notable.
5. Página de error 404 personalizada
Puedes mostrar una página personalizada cuando alguien intenta acceder a una URL que no existe.
ErrorDocument 404 /error-404.html
Explicación: Si alguien va a misitio.test/pagina-inexistente, Apache le muestra el contenido de error-404.html, pero la URL no cambia y el código de respuesta sigue siendo 404, que es lo correcto para que los buscadores sepan que esa página no existe. Acuérdate de crear el archivo error-404.html.
Entendiendo las reglas de redirección
Las reglas de redirección en .htaccess usan el módulo mod_rewrite de Apache para manipular URLs.
Estas reglas usan expresiones regulares (regex) y banderas (como [L] o [R=301]), que son instrucciones adicionales. Las expresiones regulares están basadas en el estándar PCRE (perl) con alguna particularidad.
¿Qué son las expresiones regulares?
Las expresiones regulares son patrones que indican a mod_rewrite cómo debe verse una URL. Por ejemplo, ^(.*)$ significa "cualquier texto, de principio a fin". Si ya conoces algún lenguaje de programación (JavaScript, PHP o Python), te será familiar.
Conviene saber qué texto recibe exactamente la regla. En un .htaccess, la regla recibe la ruta sin el dominio, sin la barra inicial y sin lo que va detrás de ?: para misitio.test/contacto?x=1, recibe contacto. Si copias la regla a un VirtualHost, allí la ruta sí empieza por / (/contacto), y la regla puede dejar de funcionar. Y como la parte de ?x=1 no llega nunca a la regla, existe la bandera QSA para conservarla.
¿Qué son las banderas?
Las banderas son códigos entre corchetes (como [L, R=301]) que le dicen a Apache cómo aplicar la regla. Las más comunes son:
- L (Last): Detiene el procesamiento de más reglas, si se cumple la actual.
- R=301 o R=302: Convierte la regla en una redirección permanente (301) o temporal (302). Sin
R, la regla es una reescritura interna: Apache sirve otro archivo por dentro y la URL que ve el visitante no cambia. ConR, el navegador recibe la URL nueva y la ves cambiar en la barra de direcciones. - NC (No Case): Ignora mayúsculas/minúsculas (por ejemplo, Contacto y contacto son lo mismo).
- QSA (Query String Append): Conserva parámetros de la URL original (como ?id=123).
- NE (No Escape): Evita codificar caracteres especiales (como #).
Desglose del ejemplo de redirección de HTTP a HTTPS
En el ejemplo anterior de redirección de http a https, la línea htaccess se interpreta como sigue:
RewriteEngine On: Activa el motor de reescritura (mod_rewrite).RewriteCond %{HTTPS} off: Comprueba si la conexión no es segura (HTTP en lugar de HTTPS).RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]: Redirige a la misma URL pero con HTTPS, usando las variables de Apache para el dominio y la ruta.^(.*)$: Captura toda la URL (cualquier carácter desde el inicio hasta el final).https://%{HTTP_HOST}%{REQUEST_URI}: Redirige a la misma URL, pero con https://.%{HTTP_HOST}(el dominio, como misitio.test) y%{REQUEST_URI}(la ruta, como /pagina) son variables de Apache.[L,R=301]: Aplica una redirección permanente (R=301) y detiene el procesamiento de más reglas (L).
En resumen, esta regla redirige cualquier solicitud HTTP a su equivalente HTTPS, manteniendo la misma ruta y dominio.
Desglose del ejemplo de URLs amigables
En el ejemplo para crear URLs amigables:
RewriteEngine OnActiva el motor de reescritura.RewriteCond %{REQUEST_FILENAME} !-fEsta condición verifica que el archivo solicitado (REQUEST_FILENAME) no existe físicamente (!-fsignifica "no es un archivo"). Si el archivo sí existe, la regla de reescritura se omite.RewriteCond %{REQUEST_FILENAME} !-dComo el anterior, comprueba si no es un directorio (!-d). De nuevo, si es un directorio, se omite.RewriteRule ^(.*)$ index.php?page=$1 [L]Si se cumplen las dos condiciones anteriores, cualquier petición que llegue (por ejemplo,misitio.test/ayuda) será capturada ($1) y reescrita internamente aindex.php?page=ayuda, sin que cambie la URL que ve el visitante. El patrón^(.*)$captura la parte de la URL después del dominio, no el dominio en sí, y la pasa como valor del parámetropage. La bandera[L]significa "last": indica que esta es la última regla que se debe aplicar si coincide.
Consejos para trabajar con .htaccess
- Haz copias de seguridad: Un error en
.htaccesspuede hacer que tu sitio deje de funcionar (error 500). Siempre guarda una copia antes de editar. - Prueba con cuidado: Usa un editor de texto plano para crear o modificar el archivo. Asegúrate de que el archivo tenga el nombre exacto
.htaccessy permisos correctos (generalmente 644). Después de hacer cambios, verifica que tu sitio siga funcionando. Si algo falla, revisa los logs de error de Apache (puedes pedirlos a tu hosting). - Compatibilidad: No todos los hostings permiten todas las reglas de
.htaccess. Consulta con tu proveedor si necesitas activar módulos comomod_rewrite. - Aprende más:
.htaccesses un archivo pequeño y muy potente, pero sus instrucciones tienen un formato arcano, por no decir arcaico. En internet encontrarás más información y, seguramente, la solución a tu problema concreto.
Conclusión
Con las reglas adecuadas, puedes mejorar la seguridad, la velocidad y la experiencia de usuario de tu sitio. Sin embargo, dominar todas sus posibilidades requiere su estudio.
Nota: Un error en .htaccess produce un Error 500 inmediato en toda la web. Siempre haz una copia de seguridad antes de editar, y ten acceso a los logs de Apache para diagnosticar rápidamente (tail -f /var/log/apache2/error.log).
En la próxima lección: el archivo php.ini: cómo configurar PHP, qué directivas son esenciales y cuál de los múltiples archivos ini está usando realmente tu servidor.