htaccess

htaccess (Acceso de Hiper-Texto) es un archivo de texto que Apache usa para crear reglas sobre los directorios y archivos. Tiene múltiples funciones y en lo personal me parece una herramienta sumamente interesante pero complicada de usar.

El servidor Apache tiene un módulo llamado mod_rewrite que permite redirigir y modificar la URL solicitada basada en reglas expresada en expresiones regulares PCRE. Coloque estos comandos en un archivo texto plano de nombre .htaccess en la raíz del sitio web.

Proporciona una forma flexible y poderosa de manipular URL usando un número ilimitado de reglas. Cada regla puede tener un número ilimitado de condiciones de regla adjuntas, para permitirle reescribir URL en función de variables de servidor, entorno, encabezados HTTP o marcas de tiempo.

• Directivas
• Parámetros
• Modificadores
• Variables de servidor
• Estructura de control
• Tester de htaccess
• Comentarios
• Ejemplos
• Referencias externas

1. Directivas

De forma general se puede decir que las directivas en el .htaccess se componen de tres partes: el tipo de directiva (Options, RewriteCond), los parámetros de la directiva y por último el final de cada línea en que se pueden agregar modificaciones adicionales.

1.1 Cambiar la página por defecto

Se puede usar esta directiva para cambiar la página por defecto (el orden es importante).

DirectoryIndex inicio.html index.htm index.html index.php

1.2 Redireccionar el tráfico web

Redirect antiguo nuevo

Redirect /antiguo.php http://sitio.com/nuevo.php
Redirect www.sitio.com https://sitio.com
redirect 301 / https://domain.com/
redirect 301 /archivo.html http://www.domain.com/denegado.php

1.3 Redirección permanente

Redirect permanent antiguo nuevo

Redirect permanent / http://www.domain.com/

1.4 Redireccion condicional

Para redirigir en función de lo que se ingrese.

RewriteEngine on
RewriteCond patrón condición [modificador]
RewriteRule patrón sustitucion [modificador]

Patrón:

Puede ser una variable de servidor %{VARIABLE}, una expresion regular que coincide con la URL (despues del nombre del HOST pero antes de ? luego del cual van los parámetros de consulta).

Condición:

Expresion regular, cadena de comparacion o prueba de archivo/carpeta. Luego de http://hostname

Sustitucion:

URL absoluta, ruta hacia archivo, modificacion de parte de la URL, - (no hacer nada)

Modificador:

[NC] ignore case, [OR] or logico, [NV no vary, etc]

1.4.1 RewriteCond

RewriteCond %{HTTP_USER_AGENT} (iPhone|Blackberry|Android) [NC]

1.4.2 RewriteRule

Esta es el verdadero caballo de batalla de la reescritura. La directiva puede ocurrir más de una vez y cada instancia define una sola regla de reescritura. El orden en que se definen estas reglas es importante porque este sera el orden en que se aplicarán en tiempo de ejecución.

RewriteRule patrón sustitucion [modificador]

Primero se comparar el patrón con la parte de la URL despues de nombre del HOST %{HTTP_HOST} y puerto %{SERVER_PORT} pero antes de la cadena de consulta. Ej: app1/index.php

RewriteRule ^/games  /usr/local/games/web                      //Crea un alias
RewriteRule ^/games$  http://sitio.com/juegos.php [R]          //Ruta absoluta
RewriteRule ^/games/(.*)$  http://sitio.com/$1/index.php [R]   //$1 se reemplaza con primer ()
RewriteRule ^(.*)$ http://www.nueva.com/$1 [R=301,L]

Si hay más de una expresión entre paréntesis, estarán disponibles en el orden en las variables $1, $2, $3, y así sucesivamente.

301 (Moved Permanently) esta y todas las peticiones futuras deberían ser dirigidas a la URL dada.

1.5 Activar compresion

Se puede habilitar la compresión de datos inherente de PHP para ahorrar ancho de banda.

<ifmodule mod_php4.c>
   php_value zlib.output_compression 16386
</ifmodule>

1.6 Capturar errores

Por defecto, el servidor Apache muestra una página de error 404 (File Not Found), cuando nuestros visitantes acceden a una página que en el momento no existe. Sin embargo, la página por defecto es poco amigable y no deja una buena impresión. Por lo que, podríamos crear una página especial, a la cual redirigir al cliente cada vez que se produce el error 404.

ErrorDocument error pagina

ErrorDocument 404 /tiburon.php

1.7 Prevenir navegación de carpetas

Cuando un directorio no tiene la página de index, cualquier visitante puede observar los archivos contenidos en el directorio y navegar a través de ellos.

Options All -Indexes

1.8 Forzar uso de SSL

Para forzar la conexion SSL en todo el sitio con ModRewrite.

RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^.*$ https://%{SERVER_NAME}%{REQUEST_URI} [R,L]

Si queremos forzar SSL y quitar añadir el www:

RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteCond %{HTTP_HOST} !^www\..+$ [NC]
RewriteRule ^(.*)$ https://www.%{HTTP_HOST}%{REQUEST_URI} [R=301,L]

2. Parámetros

Los parámetros son expresiones regulares o patrones de cadenas de textos que se definen usando símbolos como el ^ para indicar el inicio, el $ para señalar el final, ? para un carácter opcional (un comodin), el * para varios caracteres opcionales (comodines).

(.*)  cualquier expresión.
.*    indica cero o más caracteres arbitrarios.
/*    indica cero o más "/".

^$     indica un "empty string".
^.*$   indica cualquier cosa.

3. Modificadores

Los valores que aparecen entre corchetes al final de cada línea son modificadores o acciones. Por ejemplo, para RewriteCond se comun usar [NC] para indicar que en la directiva no debe distinguirse entre mayúsculas y minúsculas (no case), u [OR] para indicar que la expresión actual debe interpretase como una alternativa a la anterior. Por su parte, RewriteRule admite otros modificadores propios, como [F] para forzar un acceso denegado (forbidden), o [L] para indicar que es la última regla que debe aplicarse (last rule).

4. Variables de servidor

El analizador de expresiones proporciona una serie de variables de la forma %{HTTP_HOST}. Tenga en cuenta que el valor de una variable puede depender de la fase del procesamiento de la solicitud en la que se evalúa. Por ejemplo, una expresión usada en una directiva <If > se evalúa antes de que se realice la autenticación. Por lo tanto, %{REMOTE_USER} no se establecerá en este caso.

5. Estructura de control

If, Else, ElseIf

<If "%{HTTP_HOST} == 'sitio.com'">
    Redirect permanent "/" "http://www.sitio.com/"
</If>

6. Tester de htaccess

De todas formas estos scripts son muy difíciles de depurar por lo que te recomiendo una pagina de testeo.

htaccess tester de makewithlove.

7. Comentarios

Pronto...

8. Ejemplos

8.1 Redireccionar permanentemente www.sitio.com a sitio.com

#Este es un comentario
RewriteEngine on
Options +FollowSymLinks
RewriteCond %{HTTP_HOST} ^www\.sitio\.com$ [NC]
RewriteRule ^(.*)$ http://sitio.com/$1 [R=301,L]

8.2 Redireccionar permanentemente sitio.com a www.sitio.com

RewriteEngine on
Options +FollowSymLinks
RewriteCond %{HTTP_HOST} ^sitio\.com$ [NC]
RewriteRule ^(.*)$ https://www.%{HTTP_HOST}/$1 [R=301,L]

8.3 Redireccionar todo el trafico a un nuevo dominio

RewriteEngine On
RewriteRule ^(.*)$ http://www.nuevodominio.com/$1 [R=301,L]

8.4 Cambiar una parte al medio de la URL.

Supongamos que queremos transformar sitio.com/wiki/algo, en sitio.com/index.php/algo

RewriteEngine On
RewriteCond %{REQUEST_URI} ^/wiki/ [NC]
RewriteRule ^wiki/(.+) /index.php/$1 [R=301,L]

Para eliminar desde cirto punto la URL usa un ? al final ver ejemplo.

8.5 Desvia IP

Para desviar un rango de IP (10.2.x.x) a otro servidor diferente.

RewriteEngine On
RewriteCond %{REMOTE_ADDR} ^10\.2\. 
RewriteRule (.*) http://sitio.com$1 

8.6 Encademar condiciones

Cuando se impone mas de un RewriteCond todos deben coincidir para que se aplica RewriteRule. En este caso si tiene la palabra piratear en su cadena de consulta (QUERY_STRING) y en la cookie (HTTP_COOKIE) No tiene la palabra goto, no te lleva a ningun lado.

RewriteEngine On
RewriteCond %{QUERY_STRING}  piratear [NC]
RewriteCond %{HTTP_COOKIE}  !goto [NC]
RewriteRule . - [F] 

8.7 Disgregar los mobiles

Si tu navegador se autoidentifica como navegador de mobil lo enviamos a la pagina mobil.htm si no a la normal.php.

RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} (iPhone|Blackberry|Android)
RewriteRule ^/$                /mobil.htm    [L]
RewriteRule ^/$                /normal.php   [L]

Si se aplica la primera RewriteRule no se aplica la segunda gracias al modificador [L] (Last Rule)

Tambien podrias eliminar la segunda opcion si en lugar de normal.php usas index.php que es por default.

8.7 Redireccionar un parametro de query

Cuando tenemos un parametro que queremos convertir en una pagina podemos usar esto.

/index.php?id=3 -> http://sitio.com/3.php
/index.php?id=37 -> http://sitio.com/37.php
/index.php?id=371 -> http://sitio.com/371.php

RewriteEngine on
RewriteCond %{QUERY_STRING} ^id=([0-9]+)$
RewriteRule .* http://sitio.com/%1.php? [R=302,L,QSA]

8.8 No mostrar ninguna carpeta

Si una cierta carpeta no tiene index.* muestra el contenido los archivos.

IndexIgnore *

9. Referencias

Algunas referencias usadas para elaborar esta seccion fueron:

• htaccess - Bonaval
• URL amigables con PHP - Balaurt.net
• Ficheros .htaccess - Apache español
• Expressions in Apache - Apache
• Module mod_rewrite - Apache
• Información y usos del fichero .htaccess - CDmon
• Debugging info - Para probar tus comando en htaccess