.htaccessの書き方入門|HTTPS転送・www統一・Basic認証をコピペで設定

サイトを作ると「HTTPでもHTTPSでも開けてしまう」「wwwあり・なしで別のページ扱いになる」といった悩みが出てきます。これらは.htaccess(エイチティーアクセス)というファイルに数行書くだけで直せます。この記事では、よく使う3つの設定の書き方と、失敗しないための注意点を説明します。
.htaccessとは?
.htaccessは、Apache(アパッチ)というWebサーバーの動きを、フォルダごとに変えられる設定ファイルです。レンタルサーバーでは、サーバー本体の設定を触れないことが多いので、.htaccessを使うのが一般的です。
できることの例です。
- HTTPのアクセスをHTTPSへ自動で転送する
- wwwあり・なしを1つに統一する
- ページにパスワードをかける(Basic認証)
- 古いURLから新しいURLへ転送する
なお、NginxなどApache以外のサーバーでは使えません。自分のサーバーがApacheかどうかは、契約しているサーバー会社の案内で確認しましょう。
編集する前にやること
- 今の
.htaccessをバックアップする。ファイルをパソコンにダウンロードしておくだけで十分です。 - SSL証明書が入っているか確認する。HTTPSへ転送するには、先にHTTPSで開ける状態にしておく必要があります。
- 置き場所を確認する。サイト全体に効かせたいときは、公開フォルダの一番上(ルート)に置きます。
書き間違えるとサイト全体が「500エラー」になります。バックアップがあれば、元に戻すだけで復旧できます。
設定1:HTTPをHTTPSへ転送する
一番よく使う設定です。
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
意味は次のとおりです。
| 行 | 意味 |
|---|---|
RewriteEngine On |
書き換え機能を使う宣言 |
RewriteCond %{HTTPS} off |
「今のアクセスがHTTPSでないとき」だけ実行する条件 |
RewriteRule ... [L,R=301] |
同じURLのHTTPS版へ、恒久的(301)に転送する |
条件に「HTTPSでないとき」と入っているので、転送後は条件に当てはまらず、ぐるぐる転送が続く「無限ループ」にはなりません。
設定2:wwwありなしを統一する
example.comとwww.example.comが両方開けると、検索エンジンに別のサイトと見られるおそれがあります。1つに寄せましょう。
wwwなしに統一する例
RewriteEngine On
RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
RewriteRule ^(.*)$ https://%1/$1 [L,R=301]
%1は、条件の(.+)に当てはまった部分(wwwを除いたドメイン)を指します。ドメイン名を直接書かなくてよいので、使い回しやすい書き方です。
wwwありに統一したい場合は、考え方を逆にして「wwwが付いていないとき」に転送します。
設定3:Basic認証でパスワードをかける
制作中のページや管理画面を、ID・パスワードで守る方法です。
AuthType Basic
AuthName "Restricted Area"
AuthUserFile /home/youraccount/.htpasswd
Require valid-user
ポイントは2つです。
AuthUserFileには、パスワードを入れた.htpasswdファイルのサーバー上のフルパスを書きます。URLではありません。.htpasswdは、公開フォルダの外に置くのが安全です。
Basic認証はHTTPのままだとパスワードが読み取られるおそれがあります。必ず設定1のHTTPS転送と合わせて使いましょう。
1つのファイルにまとめるときの書き方
複数の設定を並べる場合は、上から順に「HTTPS転送 → www統一 → 認証」の順で書くと、読みやすく管理しやすくなります。RewriteEngine Onは1回書けば足ります。
RewriteEngine On
# HTTPSへ転送
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
# wwwなしに統一
RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
RewriteRule ^(.*)$ https://%1/$1 [L,R=301]
# Basic認証
AuthType Basic
AuthName "Restricted Area"
AuthUserFile /home/youraccount/.htpasswd
Require valid-user
#から始まる行はコメントです。あとで見返したときのメモとして残しておきましょう。
よくあるミスの確認表
| 症状 | 主な原因 | 対処 |
|---|---|---|
| 500エラーになる | 書き間違い、全角スペースの混入 | バックアップに戻して1行ずつ追加 |
| 転送がループする | HTTPSの判定がサーバー構成と合っていない | サーバー会社の案内にある判定方法を確認 |
| 設定が効かない | .htaccessが使えない設定、置き場所違い |
契約プランとルートの位置を確認 |
| ファイルが見えない | 先頭がドットで隠しファイル扱い | FTPソフトで隠しファイルを表示 |
「1行追加したら、ブラウザで確認」を繰り返すと、どこで壊れたかがすぐ分かります。
ツールを使えば書き間違いを減らせる
手で書くと、記号や空白のミスが起きやすいものです。当サイトの.htaccessジェネレーターでは、HTTPS転送・Basic認証・キャッシュ設定などを選ぶだけで、コピーして使える形で出力できます。出てきた内容を上の解説と見比べれば、意味も理解できます。
.htaccessが使えるサーバーを探しているなら
ここまでの設定は、ApacheのレンタルサーバーならSSLと合わせてすぐ試せます。独自ドメインでサイトを始めるなら、エックスサーバーのようなレンタルサーバーで、.htaccessを使いながら練習するのも手です。選び方はレンタルサーバーの選び方ガイドで説明しています。
※この記事にはプロモーション(広告)が含まれます。
まとめ
.htaccessは、Apacheサーバーの動きをフォルダごとに変える設定ファイル- 編集前に必ずバックアップを取る
- HTTPS転送は
RewriteCond %{HTTPS} offと[L,R=301]の組み合わせ - www統一は
%{HTTP_HOST}で判定する - Basic認証はHTTPSとセットで使う
- 迷ったらジェネレーターで作って、1行ずつ動作確認する
