CakePHPで favicon.icoやapple-touch-icon-144-precomposed.pngが could not be foundのエラーが出るときの対処方法

2018/04/29 2019/03/02

CakePHPで favicon.icoやapple-touch-icon-144-precomposed.pngを設定する

CakePHPで linkタグを設定。HtmlHelper::metaの利用方法も解説

　
CakePHPで構築したシステムで、「Error: [MissingControllerException] Controller class ImagesController could not be found.」というメッセージとともに「favicon.ico」や「apple-touch-icon-72-precomposed.png」や「apple-touch-icon-144-precomposed.png」などのファイルが存在しない、というエラーが出力される場合があります。
　
　
その時は、「/app/View/Layouts/default.ctp」に下記の記述を追加しましょう。
　
HTMLで記述する場合は、以下の通りとなります。
　

<link rel="shortcut icon" href="/images/favicon.ico" />

<link rel="apple-touch-icon-precomposed" href="/images/apple-touch-icon-144-precomposed.png" sizes="144x144"  />

　
　
上記と同様の記述を CakePHPの HtmlHelperを利用して記述する場合は、以下の通りとなります。
　

<?php
echo $this->Html->meta('icon', '/images/favicon.ico'); 

echo $this->Html->meta('apple-touch-icon-144-precomposed.png', '/images/apple-touch-icon-144-precomposed.png', array("size"=>"144x144")); 
?>

<?php

echo $this->Html->meta('icon', '/images/favicon.ico');

echo $this->Html->meta('apple-touch-icon-144-precomposed.png', '/images/apple-touch-icon-144-precomposed.png', array("size"=>"144x144"));

　
いずれの方法を使うにしても、「<head> ．．． </head>」の間のどこかに記述します。
　
　
この記述を追記する際に注意するポイントは、相対パスで記述するのではなく、フルパスで記述する（「/」から書き始める）、ということです。
　
　

CakePHPで linkタグ、HtmlHelper::metaを利用する方法についての解説

　
先に説明した対処方法について、以降で詳しい解説をしていきます。
　
　

favicon.icoやapple-touch-icon-144-precomposed.pngが could not be foundのエラーを出力した経緯

　
CakePHPに、会員管理プラグイン「CakeDC/Users」を導入したサイトの開発を行っています。
　
その際、下記の様なエラーがエラーログに出力されていることに気づきました。
　

2018-04-01 01:01:01 Error: [MissingControllerException] Controller class ImagesController could not be found.
Exception Attributes: array (
  'class' => 'ImagesController',
  'plugin' => NULL,
)
Request URL: /admin/images/apple-touch-icon-144-precomposed.png
Stack Trace:
#0 /var/www/html/example/app/webroot/index.php(110): Dispatcher->dispatch(Object(CakeRequest), Object(CakeResponse))
#1 {main}

2018-04-01 01:01:01 Error: [MissingControllerException] Controller class ImagesController could not be found.

Exception Attributes: array (

'class' => 'ImagesController',

'plugin' => NULL,

)

Request URL: /admin/images/apple-touch-icon-144-precomposed.png

Stack Trace:

#0 /var/www/html/example/app/webroot/index.php(110): Dispatcher->dispatch(Object(CakeRequest), Object(CakeResponse))

#1 {main}

2018-04-01 02:02:02 Error: [MissingControllerException] Controller class ImagesController could not be found.
Exception Attributes: array (
  'class' => 'ImagesController',
  'plugin' => NULL,
)
Request URL: /admin/images/favicon.ico
Stack Trace:
#0 /var/www/html/example/app/webroot/index.php(110): Dispatcher->dispatch(Object(CakeRequest), Object(CakeResponse))
#1 {main}

2018-04-01 02:02:02 Error: [MissingControllerException] Controller class ImagesController could not be found.

Exception Attributes: array (

'class' => 'ImagesController',

'plugin' => NULL,

)

Request URL: /admin/images/favicon.ico

Stack Trace:

#0 /var/www/html/example/app/webroot/index.php(110): Dispatcher->dispatch(Object(CakeRequest), Object(CakeResponse))

#1 {main}

　
　
エラーログの内容を解説すると以下の通りです。
「ImagesController」が見つかりませんでした。
エラー発生のリクエスト URLは「/admin/images/apple-touch-icon-144-precomposed.png」「/admin/images/favicon.ico」です。
　
また、エラーが発生した個所は「/var/www/html/example/app/webroot/index.php」の 110行目です。
という内容です。
　
　
ちなみに、「/example/app/webroot/index.php」の 110行目付近のソースコードは以下の通りです。
　

$Dispatcher = new Dispatcher();
$Dispatcher->dispatch(
	new CakeRequest(),
	new CakeResponse()
);

106

107

108

109

110

$Dispatcher = new Dispatcher();

$Dispatcher->dispatch(

new CakeRequest(),

new CakeResponse()

);

　
これは、CakePHPの Bakeで作成されるデフォルトの状態と変わらないものです。
　
また、index.phpは上記の 110行目で終了しています。
そのため、110行目は、ファイルの最後の「);」と言ことになるのですが、これでは何が原因でエラーになっているのかが分かりません。
　
　

「CakeDC/Users」を使った会員管理システムである

　
また、このシステムでは、最初にも書きましたが「CakeDC/Users」を使ってログインが必要なシステムになっています。
一般ユーザ（Member）と、管理者ユーザ（admin）とに画面が分かれています。
　
そして、「一般ユーザ（Member）」の URLは下記のものになりますが
　https://example.com/login
　
「管理者ユーザ（admin）」の URLは、下記の様に自動的に「admin」が付与されるようにルーティングされています。
　https://example.com/admin/login
　
この「admin」が付与されるルーティングは「CakeDC/Users」をインストールする過程で設定します。
　
「CakeDC/Users」に関しては下記に記事を書いていますので、参考にしてください。
CakePHP3のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説・3.6以降対応
　
　
今回の不具合の原因は、この「CakeDC/Users」のログインに関連したルーティングの処理で発生しているのです。
　
　

テンプレートファイルや画像、CSS、JSのリンクもルーティングされる

　
「CakeDC/Users」などでルーティング処理がされる際、「/app/View/Layouts/default.ctp」を始めとするテンプレートファイルのファイル名や、テンプレートにある画像ファイル、CSSファイル、JSファイルへのリンクもルーティングの処理がされるのです。
　
　
より具体的には、下記のように「favicon.ico」までのパスを上記のように相対パスで記述していたとします。
　

<link rel="shortcut icon" href="images/favicon.ico" />

1	<link rel="shortcut icon" href="images/favicon.ico" />

　
　
この場合、「一般ユーザ（Member）」でアクセスしたときは下記になりますが、
「/images/favicon.ico」
　
「管理者ユーザ（admin）」でアクセスしたときは、ルーティングの設定があるため、下記の様に「/admin」が追加されてしまうのです。
「/admin/images/favicon.ico」
　
　
「一般ユーザ（Member）」と「管理者ユーザ（admin）」とで全く画面のイメージが違うために、「/images/」と「/admin/images/」を別々に用意している場合はこれでも問題ないのだと思います。
ですが、今回構築していたシステムは、基本的な画面イメージはどちらもほぼ同じで、登録、更新の機能が違うという程度でしたので、管理者ユーザ側の画像ファイルも含めて、すべて「/images」に入っている状態でした。
　
そのために、「管理者ユーザ（admin）」でアクセスをすると、画像のフォルダも「/admin/images/」にルーティングされることで、「ファイルがない」というエラーにつながるという結果になっていました。
　
　

ルーティング処理されるパスの問題点の解消方法

　
先にも書きましたが、このルーティングされる際に画像などのパスもルーティングされてしまう問題点の解消方法は、画像フォルダのパスの指定を、相対パスではなく、「/」から始まるフルパスで記述しておくことです。
　
　
ちなみに、もう一つ私がはまった点としては、テンプレートとして使用しているファイルが一つだけではなかった、という点です。
　
標準的には、テンプレートファイルは「/app/View/Layout/default.ctp」になりますので、このファイルのパスを変更します。
　
ですが、私がメンテナンスをしていたシステムには、「default.ctp」のほかに管理画面用の「admin.ctp」がありまして、こちらのパスも相対パスで記述されていました。
そのため、「default.ctp」だけを変更して動作確認しても、エラーが出続けるという状況になっていました。
　
その他、「login.ctp」「error.ctp」といったテンプレートを作っている場合もあるでしょうから、その他のテンプレートも確認してみることをおススメします。
　

favicon.icoによって could not be foundのエラーが出るときの対処方法のまとめ

　
「favicon.ico」のリンクを指定する「linkタグ」の記述は、以下のようになります。
リンクを記述する際のポイントは、「/」からフルパスで書き始めることです。
　

<link rel="shortcut icon" href="/images/favicon.ico" />

1	<link rel="shortcut icon" href="/images/favicon.ico" />

　
　
上記のように、CakePHPでも直接 HTMLの linkタグを記述しても全く問題はありませんが、CakePHPの HtmlHelperを使って書くこともできます。
HtmlHelperを使って書くとちょっとカッコよく見せることもできる！という感じです。
　
　

HtmlHelper::meta()の使い方

　
HtmlHelperを使って linkタグを記述する場合は「HtmlHelper::meta()」を使用します。
　
詳細は、下記の Cookbookにもあります。
　
CakePHP 2.x　Cookbook　HtmlHelper
https://book.cakephp.org/2.0/ja/core-libraries/helpers/html.html
　
　
HtmlHelper::meta()は、下記の形式で使用します。
　

HtmlHelper::meta(string $type, string $url = null, array $options = array())

1	HtmlHelper::meta(string $type, string $url = null, array $options = array())

　
一番簡単な記述方法としては、以下のようになります。
1つ目のパラメーターにファイルのタイプを指定し、2つ目のパラメーターにファイルのパスを指定します。
　

echo $this->Html->meta('icon', '/images/favicon.ico');

1	echo $this->Html->meta('icon', '/images/favicon.ico');

　
処理されて出力される linkタグは以下のようになります。
　

<link href="/images/favicon.ico" type="image/x-icon" rel="icon" /><link href="/images/favicon.ico" type="image/x-icon" rel="shortcut icon" />

1	<link href="/images/favicon.ico" type="image/x-icon" rel="icon" /><link href="/images/favicon.ico" type="image/x-icon" rel="shortcut icon" />

　
　
また、タイプやオプションの指定内容によって少しずつ編集される内容が変わってきます。
それを実験した内容が下記になりますので参考にしてみてください。
　

echo $this->Html->meta('favicon.ico', '/images/favicon.ico'); 

// ↑このように記述すると、
// ↓こう編集されます

<link href="http://example.com/images/favicon.ico" type="application/rss+xml" rel="alternate" title="favicon.ico" />

echo $this->Html->meta('favicon.ico', '/images/favicon.ico');

// ↑このように記述すると、

// ↓こう編集されます

echo $this->Html->meta('favicon.ico', '/images/favicon.ico', array("type"=>"icon")); 

// ↑このように記述すると、
// ↓こう編集されます

<link href="/images/favicon.ico" type="image/x-icon" rel="icon" /><link href="/images/favicon.ico" type="image/x-icon" rel="shortcut icon" />

echo $this->Html->meta('favicon.ico', '/images/favicon.ico', array("type"=>"icon"));

// ↑このように記述すると、

// ↓こう編集されます

echo $this->Html->meta('apple-touch-icon-144-precomposed.png', '/images/apple-touch-icon-144-precomposed.png', array("size"=>"144x144")); 

// ↑このように記述すると、
// ↓こう編集されます

<link href="http://example.com/images/apple-touch-icon-144-precomposed.png" type="application/rss+xml" rel="alternate" title="apple-touch-icon-144-precomposed.png" size="144x144" />

echo $this->Html->meta('apple-touch-icon-144-precomposed.png', '/images/apple-touch-icon-144-precomposed.png', array("size"=>"144x144"));

// ↑このように記述すると、

// ↓こう編集されます

- CakePHP 3.x 4.x 5.x

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

Message コメントをキャンセル

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

: CakePHP3のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説・3.6以降対応

CakePHP3のユーザ管理プラグイン Usersは、ユーザ登録、メール認証、ログイン認証、ユーザ管理、権限管理、reCAPTCHAなど会員制のサイトを簡単に実現可能。その導入方法、カスタマイズ方法を解説。

: CakePHP3で生の SQLの実行はConnectionManagerを使う

CakePHP3で生の SQL文を実行する方法を解説。クリエビルダーを使う場合は TableRegistryを利用するが、SQLを実行する場合は ConnectionManagerを使う。プリペアードステートメントの使用方法も解説。

: CakePHP3のHtmlHelperのLink設定のまとめ。mailto、URL、Root／Homeのリンクなども

CakePHP3でHtmlHelperを使ってリンクの設定をする方法のまとめ。基本形からURLを指定、class、id、targetを指定、mailtoのリンク、画像をアンカーに、JavaScriptのダイアログなどの解説。

: CakePHP4系でJSONレスポンスの処理ではwithStringBodyを使う。3との違い解説

responseの値を指定する方法は3系では「body」だが、4系では「withStringBody」になりる。加えてJSON形式なら「withType」で指定するなど4系では結構異なる処理がある。

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

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

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

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

: URL短縮サービス「TTTオンライン（https://ttt.onl）」公開

URL短縮サービス「TTTオンライン（https://ttt.onl）」を公開。メールやSNSでは使いにくい長いURLを短いURLに変換するサービス。QRコードも。Google URL Shortenerが2019年3月にサービス終了。

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

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

: CakePHP 2.3 Model、Controllerの見たい変数の中身をログ出力

CakePHPの Modelや Controllerの変数の中身をログとして出力して見る方法を提供します。

: CakePHP3のプラグイン「CakeDC/Users」を日本語化・翻訳ファイルもダウンロード可

CakePHP3のユーザ管理、ログイン認証プラグインである「CakeDC/Users」のメッセージを日本語にする手順の解説とともに、日本語の翻訳ファイルを提供。ファイルを設置すれば日本語になる！