CakePHP3のインストールでURL rewriting……のエラーが！その解決方法解説

2017/04/01 2017/10/28

CakePHP3のインストールは成功したけどエラー画面が出る

CakePHP3をインストールして出るエラーについて

　
CakePHP3をインストールは成功したはずなんだけども、下記のいつもの赤い画面が出てこない．．．
　

　
替わりに出てきた画面は、下記のようなエラー画面．．．
　

　
そんな場合の対応方法を解説します。
　
　

解決方法は httpd.confに .htaccessを有効にする設定を記述

　
まず最初に解決方法を記載しておきます。
　
viコマンドで、「httpd.conf」を開きます。
「httpd.conf」の編集は root権限が必要ですので、「sudo」コマンドを利用して、開きます。
※「httpd.conf」ファイルのパスは、サーバによって違う場合があります。
　

sudo vi /etc/httpd/conf/httpd.conf

1	sudo vi /etc/httpd/conf/httpd.conf

　
　
開いた「httpd.conf」に下記を追加します。
これを追加することで、.htaccessを有効にする、という設定です。
いくつかサブドメインがある場合は、各サブドメインごとに設定します。
追加する場所は、「httpd.conf」の一番下で OKです。
　

<Directory "/var/www/html/cakephp3">
    AllowOverride All
    Order allow,deny
    Allow from all
</Directory>

AllowOverride All

Order allow,deny

Allow from all

</Directory>

　
　
「httpd.conf」を更新したら、その設定を反映させるために下記のコマンドで Apacheの再起動をしましょう。
　

sudo service httpd restart

1	sudo service httpd restart

　
　
これで改めて CakePHP3の URLにアクセスすると、いつも見る赤い画面が表示されるでしょう。
　
　

Apacheクックブック第2版 ―Webサーバ管理者のためのレシピ集

CakePHP3をインストールして出るエラーの内容の確認

　
左記に画像を出していたエラーの内容ですが、下記のような内容になっています。
　

Welcome to CakePHP 3.3.14 Red Velvet. Build fast. Grow solid.

Please be aware that this page will not be shown if you turn off debug mode unless you replace src/Template/Pages/home.ctp with your own version.

URL rewriting is not properly configured on your server.
1) Help me configure it
2) I don't / can't use URL rewriting
Environment

Your version of PHP is 5.5.9 or higher (detected 5.6.29).
Your version of PHP has the mbstring extension loaded.
Your version of PHP has the openssl extension loaded.
Your version of PHP has the intl extension loaded.
Filesystem

Your tmp directory is writable.
Your logs directory is writable.
The FileEngine is being used for core caching. To change the config edit config/app.php

Welcome to CakePHP 3.3.14 Red Velvet. Build fast. Grow solid.

Please be aware that this page will not be shown if you turn off debug mode unless you replace src/Template/Pages/home.ctp with your own version.

URL rewriting is not properly configured on your server.

1) Help me configure it

2) I don't / can't use URL rewriting

Environment

Your version of PHP is 5.5.9 or higher (detected 5.6.29).

Your version of PHP has the mbstring extension loaded.

Your version of PHP has the openssl extension loaded.

Your version of PHP has the intl extension loaded.

Filesystem

Your tmp directory is writable.

Your logs directory is writable.

The FileEngine is being used for core caching. To change the config edit config/app.php

　
　
Google翻訳に突っ込んでみても、下記のような日本語になるだけで、全く意味が取れません。
　

src / Template / Page / home.ctpを独自のバージョンに置き換えない限り、デバッグモードをオフにするとこのページは表示されません。
　
サーバー上でURLの書き換えが正しく構成されていません。
1）私はそれを構成するヘルプ
2）私は/ URLを書き換えることはできませんしないでください

src / Template / Page / home.ctpを独自のバージョンに置き換えない限り、デバッグモードをオフにするとこのページは表示されません。

サーバー上でURLの書き換えが正しく構成されていません。

1）私はそれを構成するヘルプ

2）私は/ URLを書き換えることはできませんしないでください

　
　
とはいえ、「Help me configure it」の方のリンクをたどって、下記のページに行くと、サーバの設定をしたことがある方であれば、エラーの原因が理解できるでしょう。
　
原因説明の URLは、↓ここ
https://book.cakephp.org/3.0/en/installation.html#url-rewriting
　
　
エラーの原因は、「.htaccessによるリダイレクトの設定」がうまくいっていないため、このままだと正常に動作しませんよ、というエラーです。
　
そのため、「httpd.conf」に .htaccessを利用できるような設定を行うことで不具合の解消をする、という対応が必要になってきます。
　
　

URL rewriting is not properly configured on your server.

　
今回発生した、.htaccessが使える環境にないために発生する CakePHP3のエラーですが、解説はしてみたものの、この解説が読まれることはかなりまれな事象なんじゃないか、と思っています。
　
理由は、このエラーを見る方の多くは、自分でトラブルを解決できる方であろうと思うからです。
　
この不具合が起こる原因は、「.htaccessが使える環境にない」ということなのですが、そのような環境は、下記の 2つくらいじゃないかと思うわけです。
　
・レンタルサーバで .htaccessが使えないサーバ
・サーバを設定したが .htaccessを使えるようにする設定を忘れていた
　
　
前者の場合はそもそも .htaccessが使えないので、どうしようもないのですが、レンタルサーバで .htaccessが使えないサーバの場合は、そもそも CakePHP3がインストールできるとは思い難いですね。
　
後者の場合、VPSや AWS、専用サーバなどを借りて、もしくは、ローカル環境に VirtualBoxなどを立てて、そこに環境を構築しながら、CakePHP3をインストールしているんじゃないかと思います。
　
そんな感じで LAMP環境を自分で構築できるような方であるならば、メッセージの「URL rewriting is not properly configured」というあたりを読むと、「.htaccessのリライト処理が設定されていないのか！」と思い至るんじゃないかと思います。
　
　
ただ、私のように原因が分からず、小一時間も悩むような方がいた場合に解決の糸口にしてもらえれば、と思ってこの記事を書きました。
　
このエラーを見ることなく、CakePHP3のインストールがすんなり終わることを願いつつ．．．
　
　
そもそも「URL rewriting is not properly configured on your server.」のメッセージの前に編集されている「Please be aware that this page will not be shown if you turn off debug mode unless you replace src/Template/Pages/home.ctp with your own version.」のメッセージは、正常にインストールされても表示されているメッセージですので、ここは今回発生したエラーとは全く関係ないところなのですが、英語が苦手だとどこにエラーが書いてあるかがまずわからないですよねぇ。
　
そして、説明のサイトも英語ですし．．．
　
　

- CakePHP 2.x　3.x CakePHP3

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP3のメッセージ日本語化の設定（国際化と地域化の機能の使い方の解説）

CakePHP3の英語のメッセージを日本語化（多言語化）する手順を解説。オリジナルのメッセージを作成する方法やプログラムで文言を追加する場合の対応なども解説。

: CakePHP3にデザインテンプレートBootstrapを導入する方法・friendsofcake/bootstrap-ui使用

CakePHP3にプラグイン「friendsofcake/bootstrap-ui」、デザインテンプレート「Bootstrap」を設置する手順を解説。Bootstrapの簡単な使い方やデフォルトのデザインとの混在方法なども解説。

: CakePHP3のCakeDC/Usersのログイン後のリダイレクトとユーザ権限管理の設定解説

CakeDC謹製Usersプラグインの紹介。ログイン認証後にリダイレクトする先の設定方法についての解説と実運用するために必要なコツを解説。便利な仕組みも仕様の理解があって初めてうまく使いこなせる。

: CakePHP 2.3　デバッグキット（DebugKit）超初心者向けフォロー講座

CakePHP初心者に向けてデバッグキット（DebugKit）のインストール方法、はまりポイントを解説。

: CakePHP3で静的ページの作成は webrootか pagesを使う。トップページを参考に解説

CakePHP3で静的なページを設置する場合の方法（webrootとpagesとを活用する方法）を解説。pagesの解説はデフォルトのトップページがどう表示されているかを参考に解説。ルーティングの機能も。

: CakePHP 2.3　bakeの超初心者向けフォロー講座

CakePHP 2.3　bakeの超初心者向けフォロー講座

: CakePHP3のCakeDC/Usersでログインユーザの所有レコードのみ更新、削除する権限管理の設定方法

CakePHP3のユーザ管理、ログイン認証プラグイン「CakeDC/Users」の権限管理を行う方法やアクセスできるコントローラー、アクションを設定、所有権を持つレコードのみ更新できる設定方法を解説。