ぱんだふるツール のマスコットぱんだふるツールやりたいことが、すぐできる。
開発・IT

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

.htaccessの書き方入門の要点をまとめた図解

サイトを作ると「HTTPでもHTTPSでも開けてしまう」「wwwあり・なしで別のページ扱いになる」といった悩みが出てきます。これらは.htaccess(エイチティーアクセス)というファイルに数行書くだけで直せます。この記事では、よく使う3つの設定の書き方と、失敗しないための注意点を説明します。

.htaccessとは?

.htaccessは、Apache(アパッチ)というWebサーバーの動きを、フォルダごとに変えられる設定ファイルです。レンタルサーバーでは、サーバー本体の設定を触れないことが多いので、.htaccessを使うのが一般的です。

できることの例です。

  • HTTPのアクセスをHTTPSへ自動で転送する
  • wwwあり・なしを1つに統一する
  • ページにパスワードをかける(Basic認証)
  • 古いURLから新しいURLへ転送する

なお、NginxなどApache以外のサーバーでは使えません。自分のサーバーがApacheかどうかは、契約しているサーバー会社の案内で確認しましょう。

編集する前にやること

  1. 今の.htaccessをバックアップする。ファイルをパソコンにダウンロードしておくだけで十分です。
  2. SSL証明書が入っているか確認する。HTTPSへ転送するには、先にHTTPSで開ける状態にしておく必要があります。
  3. 置き場所を確認する。サイト全体に効かせたいときは、公開フォルダの一番上(ルート)に置きます。

書き間違えるとサイト全体が「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行ずつ動作確認する

この記事で使うツール

⚙️ .htaccessジェネレーター →

HTTPS・Basic認証・キャッシュ設定を選んで即コピー。