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 コメントをキャンセル

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

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

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

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

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

: CakePHPで同一テーブル内の値を比較する条件でレコードを取得する方法

CakePHPの同一テーブルにある項目の値を比較し条件に合致するレコードを取得する方法を解説。［”項目名”=>”値”]ではなく[”項目名 = 項目名”］と書くところがポイント。

: CakePHP3チュートリアルで日付と時刻のDateTimeでエラーが出たときの対処方法

CakePHP3のブックマークチュートリアルには記載ミスもあり、そのまま動かない個所もある。CakePHP3では namespaceを使うようになったので、classを呼び出すときに￥を追加する必要が！

: CakePHP4、5のnewEmptyEntityで作成したオブジェクトは空なのか、確認してみた

CakePHPでレコードを新規登録をする際にnewEmptyEntity()を使って空のEntityを作成するが、これのempty、is_nullなどのでの判定結果がtrueかfalseか確認してみた。

: CakePHP3でアソシエーション先のカラムでデータをソートして取得したい

アソシエーション先のテーブルのカラムをキーにソートをしたデータを取得したい！ときの記述方法を解説。「orderAsc()」ではなく「contain()」の中にSort条件を記述する。

: CakePHP2の検索Plugin CakeDC/Searchで重複を省くgroup by（distinct）の実装方法

CakePHP2の検索プラグイン「CakeDC/Search」で、重複レコードを省くgroup by、distinctを使う方法についての解説。設定する場所はpaginatorの条件とするので、find()関数と同じ。

: CakePHP4 のコマンドプログラムからコンポーネントを読み込む方法解説

CakePHP4でコマンドプログラムからコンポーネントを呼び出す方法を解説。コントローラーから呼び出すときと大差はないが、use句でコンポーネントを指定する事がポイント。

: CakePHP3の更新画面でUpload Plugin 3.0を使う方法、viewで使う方法解説・その３

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその3で記事を更新する際のファイルの取り回しなどについてを解説。

: CakePHP4のCakeDC/Usersの Usersへの接続、バリデーションのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。CakePHP4で使う場合のUsersのカスタマイズとして入力項目のバリデーションの変更を、プラグインのファイルは触らずオーバーライドにより実装する方法を解説する。