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 5.x CakePHP3

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

Message コメントをキャンセル

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

: Windows上のXAMPP環境のCakePHPのコマンド実行時に環境変数を指定する方法

CakePHP4のコマンド（シェル）に対して、環境変数を指定して実行する方法を解説。LinuxとWindows上のXAMPPとでは記述方法が異なるため、Windowsのsetコマンドについても詳細解説。

: CakePHP3でレコードを保存（追加、更新、Insert、Update）する複数の方法を紹介

CakePHP3でレコードを追加、更新（Insert、Update）する記述方法を解説。1件ずつ処理、全件をまとめて処理、条件に該当する複数件のレコードを処理方法をサンプルコードを用いて解説。

: CakePHP3で保存前にバリデーション結果を取得する2つの方法

CakePHP3でデータベースに値を保存する前にバリデーションを行い、その結果によって処理を振り分ける方法について解説。「$topic->errors()」と「$topic->hasErrors()」の2つの方法がある。

: CakePHP3でパンくずの指定は HTMLヘルパーを使って指定する方法を解説

CakePHP3でパンくずの指定方法の解説。2つのヘルパーがあるが簡単なHTMLヘルパーを使った方法を、実際の状況に合わせて3つのパターン（エレメント化、ブロック化）にして解説。

: CakePHP3でComposerでインストールできないプラグイン、外部ライブラリを vendorに入れて手動で読み込む方法

CakePHP3にComposerからインストールできないプラグインやライブラリなどを利用する方法、vendorにファイルを設置し、composer.jsonを更新し、それを呼び出す方法を詳細に解説。