htaccess tips & tricks

Traducción del original en catalán. Léela en: CatalàEnglish

El htaccess es un archivo de configuración para usuarios de Apache muy potente. Este archivo se puede poner en cualquier directorio para especificar comportamientos específicos en la configuración de Apache. También hay que decir que solo podrán usar este tipo de archivos los usuarios que a través del archivo de configuración principal de Apache hereden permisos para hacerlo.

Qué se puede hacer desde un .htaccess:

  • Especificar nuestros propios documentos de error
  • Añadir comportamientos específicos según tipo MIME
  • Definir variables de entorno
  • Redirigir URLs
  • Re-escribir URLs
  • Restringir accesos

Este documento es una traducción-adaptación-ampliación y todo lo que me han dado ganas de cambiar y añadir del documento original: .HTACCESS files useful tips and tricks de Garnet R. Chaney.

UPDATE: Ha salido la segunda parte del documento: more .htaccess tips and tricks

Especificar nuestros propios documentos de error

Simplemente se trata de no usar los errores estándar del servidor de hosting que hospeda nuestra página, o sea, definimos qué página se tiene que devolver en los casos en que la respuesta HTTP no sea del tipo 200. Lo más habitual es la página de error 404 (Not Found), si queremos redefinir esta página tenemos que poner en el .htaccess, por ejemplo:

ErrorDocument 404 errors/404.html
Añadir comportamientos específicos según tipo MIME

Estas macros de servidor lo que hacen es definir comportamientos específicos según el tipo de archivo y devolver el resultado después de aplicar el 'parser' concreto. Por ejemplo:

AddType text/html .shtml
AddHandler server-parsed .shtml

Si queréis más información sobre el tema de los 'handlers' podéis consultar el manual de Apache handlers use y la documentación de mod_include.

NOTA: Artículo inspirado en: .HTACCESS files useful tips and tricks

Modificar las variables de entorno del sistema

Como todos sabéis el sistema tiene una serie de variables de entorno (ver env y set) que son visibles desde las sesiones de Apache (ver phpinfo). Pues bien estas pueden ser alteradas de la siguiente manera, por ejemplo:

SetEnv SITE_WEBMASTER "Jack Sprat"
SetEnv SITE_WEBMASTER_URI mailto:Jack.Sprat@characterology.com
UnSetEnv REMOTE_ADDR
Añadimos formatos MIME

Las extensiones no reconocidas por Apache se consideran formatos de texto y no se pueden descargar adecuadamente, así que es conveniente añadir los tipos MIME no reconocidos por este, por ejemplo:

AddType application/x-endnote-connection enz
AddType application/x-endnote-filter enf
AddType application/x-spss-savefile sav
Restringir el acceso a los documentos

Apache permite restringir el acceso a los documentos según muchos tipos de factores:

  • por host
  • por tipo de navegador
  • por las credenciales enviadas vía HTTP
  • etc

En el siguiente ejemplo se da acceso solo por las IPs de la red privada (192.168.*) o por los hosts que acaben en ymbi.net (dominio de mi LAN privada).

order deny,allow
deny from all
allow from 192.168. ymbi.net
Protección de acceso por autenticación

Para información sobre este tema, os recomiendo: manual del mod_auth. También vale la pena que os miréis módulos no oficiales de apache como: mod_auth_mysql como su nombre indica permite tener no solo la bbdd de usuarios en archivos de texto, sino dentro de una bbdd mysql. También existen cosas parecidas para postgresql y para ldap. Incluso diría que lo he visto mod_auth_pam interesante, ¿no?

Protegemos el acceso solo a un archivo

Normalmente el .htacces se refiere a todo un directorio, por lo tanto si queremos referirnos solo a un archivo en concreto lo tenemos que especificar con la directiva <Files>. En el siguiente ejemplo pedimos una autenticación para ver el archivo quiz.html, esta se comprueba a través del directorio LDAP:

<Files quiz.html>
order deny,allow
deny from all
AuthType Basic
AuthName "Characterology Student Authcate"
AuthLDAP on
AuthLDAPServer ldap://directory.characterology.com/
AuthLDAPBase "ou=Student, o=Characterology University, c=au"
require valid-user
satisfy any
</Files>

Un ejemplo que siempre es muy útil en la vida real es el siguiente, incluso os recomiendo que lo uséis en el archivo general de configuración de apache. Lo que hace es proteger que nadie pueda leer los archivos .htaccess, ya que estos pueden contener información sensible:

<Files .htaccess>
order deny,allow
deny from all
</Files>

También existe una directiva que se llama <FilesMatch> y nos permite usar comodines (wildcards) en las restricciones por archivos.

Redirigiendo un cliente

Podemos decirle al servidor que redirija la conexión del cliente hacia una URL concreta, hay diferentes tipos de redirecciones:

  • permanent - el recurso se ha movido de forma permanente
  • temp - se ha movido de forma temporal a otro lugar
  • seeother - el contenido ha sido cambiado
  • gone - la información requerida ha sido eliminada de forma permanente

Ejemplos:

Redirect permanent /psych/subject/timetable http://www.characterology.com/psych/subject/ttable
Redirect gone /psych/subject/1998
Redirect seeother /psych/subject/1999/ /psych/subject/2000/

Más ejemplos:

RewriteEngine on
RewriteBase /psych
RewriteRule test/printenv(.*) cgi-bin/printenv$1

Como podéis ver se pueden usar expresiones regulares, aquí tenéis un pequeño resumen:(no lo he traducido para no distorsionarlo)

  • Patterns ("wildcards") are matched against a string
  • Normal alphanumeric characters are treated as normal
  • Special characters:
  • . (full stop) - match any character
  • * (asterix) - match zero or more of the previous symbol
    • (plus) - match one or more of the previous symbol
  • ? (question) - match zero or one of the previous symbol
  • \? (backslash-something) - match special characters
  • ^ (caret) - match the start of a string
  • $ (dollar) - match the end of a string
  • [set] - match any one of the symbols inside the square braces.
  • (pattern) - grouping, remember what the pattern matched as a special variable

Ejemplos:

  • a+ matches "a", "aaaa", "aaaaaaaaaaaa", but not "bbb"
  • [ab]+ matches, "a", "b", or any length combination of the two
  • \.s?html? matches ".htm", ".shtm", ".html" or ".shtml"
  • (.+)/1999/(.+) matches "subject/1999/psy1011/", and also stores "subject" in 1and"psy1011/"in1 and "psy1011/" in 2.
  • Más información: man regex o incluso tenéis libros enteros de la casa O'Reilly que hablan de ello Mastering Regular Expressions.

Las redirecciones pueden ser mucho más complejas de lo que hemos visto y podemos ver aquí, algunos ejemplos:

  • Redireccionamos de forma condicional, por ejemplo, cuando no existe un archivo:
  • También podemos hacer condiciones según las variables de entorno:

Si os habéis quedado con las ganas de jugar más con el tema podéis ir a la documentación de apache concretamente donde se habla de los módulos: mod_rewrite y mod_alias.

Como os podéis imaginar esto es lo que he usado para redirigir las peticiones de las imágenes del blog, tal como comentaba en: ¿Las imágenes y el álbum de fotos van más rápidos?, aquí tenéis el código de la redirección:

RewriteCond %{REMOTE_ADDR} !^192.168.1.0/24
RewriteCond %{REMOTE_ADDR} !^192.168.2.0/24
RewriteCond %{REMOTE_ADDR} !^10.0.30.0/24
RewriteRule ^/article_fitxers(.*) http://dades.joor.net/article_fitxers$1

2 comentarios

Los comentarios del blog antiguo, tal como se escribieron. Los comentarios están cerrados.

  1. —

    Un article sobre HTTP rewritting força currat:

    http://www.yourhtmlsource.com/sitemanagement/urlrewriting.html...

  2. —

    petit i complet manual del mòdul mod_rewrite que és el que s'encarrega de fer les redireccions d'URLs reescribint-les.

    mod_rewrite, a beginner's guide (with examples)