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 3.x 4.x CakePHP3

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

Message コメントをキャンセル

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

: 国際化と地域化の翻訳機能「__()」を使って定数に変数を埋め込む方法

CakePHP4で定数に変数を埋め込み、翻訳機能「__()」で変数に値を入れる方法を紹介。定型の文章の一部だけを置換したい場合に利用すると便利。

: CakePHP3でデータを保存する save()で発生するエラーを確認する方法を解説

CakePHP3でデータ保存処理のログを取得する方法。save()では true、falseの戻り値しか取得できないが、saveOrFail()と try…catch文を使いエラーログ、エンティティを取得し、不具合の解析を行う。

: CakePHP3のcontroller内でテンプレート、レイアウトを変更する際の指定方法

CakePHP3でテンプレートファイルやレイアウトファイルをデフォルトのものから別のものに変更したい場合の指定方法を解説。

: CakePHP3のInsert On Duplicate Key Update（upsert）構文を解説・バルク処理も

CakePHP3で Insert … On Duplicate Key Update構文（upsert）を実行する方法を解説。バルク処理の方法も用意されているため大量処理の場合も対応可能。

: CakePHP3でDocumentRootやtmp、webroot、logsなどのフォルダへのパスの定数

CakePHP3で特定フォルダのパスの定数を解説。root、DocumentRoot、app、config、webroot、tests、tmp、cache、vendor、コア、コアの srcが設定済み。realpath()関数を使うと柔軟なパス指定が可能。