.htaccess の書き方

ファイル名

.htaccess のファイル名は、そのまま ".htaccess" になります。先頭に . がついていることに注意して下さい。先頭に . がつくファイルはUNIX系のOSで隠しファイルを意味しており、ファイル名がない拡張子だけのファイルという意味ではありません。

Windowsでは初期設定で拡張子の表示が省略されているため、ファイル名が気付かずに ".htaccess.txt" となっている場合があります。".htaccess.txt" では、サーバが正しく認識できないため、動作しません。また、拡張子が自動で付与されて ".htaccess" というファイル名が作成できない場合は、 ".htaccess.txt" のファイル名で一旦作成し、アップロード後にWebサーバ上で ".htaccess" にリネームします。

ただし .htaccess のファイル名は後述する httpd.conf の AccessFileName ディレクティブで定義できるため、必ずしも .htaccess ではない場合があります。もしも .htaccess が機能せず、500 internal server error も発生しない場合は .htaccess のファイル名を確認してみて下さい。以下は .htaccess のファイル名を .acl に変更している例です。

# 設定ファイル名を .htaccess ではなく .acl にしている例
AccessFileName .acl

コメントアウト

.htaccess では、# から始まる行がコメントアウトされます。行の途中でもコメントをつけることが可能ですが、Apacheのバージョンや、記述場所によってはエラーになるため、基本的にコメント行は独立させましょう。それでも行の途中でコメントをつける場合は、" で囲むことでコメントアウトされます。ただし、Apache ver1.3系ではエラーになるため、Apache ver2.0系以降である必要があります。

# ここはコメント行です
DirectoryIndex index.html "# 行の途中コメントは避けましょう"

文字コードと改行

.htaccess の文字コードはUTF-8(BOM無し)、改行コードはLFを設定し、ファイルの最終行には空行を入れる必要があります。ただし .htaccess が日本語などの全角文字を含まず、半角英数字だけである場合は文字コードは Shift-JIS や EUC-JP などでも問題ありません。文字コードや、改行コードが誤っている場合は、500 internal server error が発生するため注意が必要です。

特に Windows 環境では、プレーンな .htaccess を作成するためにテキストエディタが必要になります。メモ帳では保存時の文字コードで UTF-8 が選択できますが、BOMが付与されてしまいます。また、ワードパッドではリッチテキスト形式となり、余計なバイナリ情報が付与されるため .htaccess が機能しないため注意しましょう。

また、改行は構文の終端として認識されますが、行末に \ をつけて改行すると構文が次の行に継続しますが、あまり一般的な表記ではありません。途中改行を行う場所によってはエラーになるため、特に必要でない限りは途中改行も避けた方が無難です。

# ErrorDocument 404 404error.html を途中で改行する
ErrorDocument 404 \
404error.html

# 最終行の後には空行を入れましょう

httpd.conf

httpd.conf は .htaccess の上位ファイルです。そのため .htaccess では httpd.conf で許可されている命令のみ指定できます。許可されていない命令を指定した場合、無効になるか 500 internal server error が発生します。何が許可されているかは、利用しているサーバの公式ヘルプを確認して下さい。

もしも httpd.conf を確認できる場合は、 "AllowOverride" ディレクティブを探してみましょう。デフォルトの設定では、httpd.conf に AllowOverride ディレクティブが含まれていますが、見つからない場合は、追記することで設定できます。

# None は .htaccess による設定をすべて無効にする
<Directory />
  AllowOverride None
</Directory>

転送と有効範囲

.htaccess をWebサーバへ転送する際はアスキーモードで転送します。転送後は .htaccess のパーミッションを "644(rw-r--r--)" に設定します。ただし、共有サーバでは、"604(rw----r--)" の場合もあります。

.htaccess の設定は、配置したディレクトリ以下に対して有効になります。そのため、Webサイト全体に対して設定を有効にしたい場合は、ルートディレクトリに配置しましょう。階層別に分けて配置した場合、より深い階層に配置した .htaccess の設定が優先されます。

/www
|-- .htaccess         # Webサイト全体に対して有効 ･･･ A
|-- index.html        # Aの設定が有効になる
|
|-- /contents
|   |-- contents.html # Aの設定が有効になる
|
|-- /blog
    |-- .htaccess     # blog配下に対して有効 ･･･ B
    |-- blog.html     # Bの設定が有効になる

上記の例では .htaccess A と .htaccess B で同じ設定項目を使用している場合に限ります。同じ設定項目を使用している場合、より深い階層に配置した .htaccess の設定で上書きされますが、その他の設定項目は上位の階層の設定が有効になります。

# .htaccess Aの設定
RewriteEngine On
RewriteRule index1.html index2.html

# .htaccess Bの設定
RewriteEngine On
RewriteRule index1.html index3.html

# .htaccess Aの設定
DirectoryIndex index.html

# .htaccess Bの設定
RewriteEngine On
RewriteRule index1.html index2.html

# .htaccess Aの設定
RewriteEngine On
RewriteRule index1.html index2.html

# .htaccess Bの設定
RewriteEngine On
RewriteRule index1.html /index1.html

正規表現

.htaccess では、正規表現による指定が可能です。正規表現とは、いくつかの文字列を1つの形式で表現する記述方法です。例えば、index1.html と index2.html がある場合、以下の正規表現で表すことができます。

index(1|2).html

"(" , ")" で囲んだ部分は1つのグループとなり、複数の文字を1つの単位として扱うことができます。"|" はOR条件を表すため、正規表現の意味としては "index" に続く文字が "1" または "2" となります。このように、正規表現を使用すればファイル名などを柔軟に指定することが可能です。

正規表現には基本的な表記の他に定義済みのクラスがあります。一部の定義済みクラスは "[:" と ":]" の特殊な括弧を使用することで表記します。

モジュールとディレクティブ一覧

• .htaccess - コア機能
• .htaccess - mod_actions
• .htaccess - mod_alias
• .htaccess - mod_auth_basic
• .htaccess - mod_authn_default
• .htaccess - mod_authn_file
• .htaccess - mod_authz_default
• .htaccess - mod_authz_groupfile
• .htaccess - mod_authz_host
• .htaccess - mod_authz_user
• .htaccess - mod_autoindex
• .htaccess - mod_env
• .htaccess - mod_expires
• .htaccess - mod_filter
• .htaccess - mod_headers
• .htaccess - mod_imagemap
• .htaccess - mod_include
• .htaccess - mod_mime
• .htaccess - mod_negotiation
• .htaccess - mod_setenvif
• .htaccess - mod_dir
• .htaccess - mod_rewrite

RewriteRuleの後方参照

RewriteRule で後方参照を利用する場合は "$n" で表記します。( n には 0 ～ 9 の数字が入ります。) 後方参照は、複数の条件がある場合でも利用できます。マッチング条件が複数ある場合は、左側から $1, $2 というように、どの条件にマッチングした文字列を参照するか選択できます。ただし、$0 と $1 は同じ値を示します。また、10 を超える後方参照は使用できません。$10 と記述しても "$1" と "0" の文字列として認識されます。

# Rewriteエンジンを起動
RewriteEngine On

# /blog/foo/bar → /foo/bar に変換される
RewriteRule ^/blog/(.*)/(.*)$ /$1/$2
#                   $1   $2

RewriteCondの後方参照

　RewriteCond で後方参照を利用する場合は "%n" で表記します。( n には 1 ～ 9 の数字が入ります。) 表記する記号が RewriteRule と異なり % であることと、%0 は使えないことに注意して下さい。その他の使い方は RewriteRule と同様です。

# Rewriteエンジンを起動
RewriteEngine On

#                                 %1   %2
RewriteCond %{REQUEST_FILENAME} ^(.*)/(.*)/index.html$
RewriteRule ^/blog/(.*)/(.*)$ /$1/%1/$2/%2
#                   $1   $2