更新日: 2016年2月17日
PHP & CakePHP

CakePHP独自プラグインの自動読み込みには composer dumpautoload が必要

CakePHP3 で独自にプラグイン（plugins ディレクトリに置くライブラリ）を作成する機会があったのですけど、プラグインの autoload（自動読み込み）が効かなくて、しばらくの間はまってしまった。

— 環境 —
PHP 5.5.19
CakePHP 3.1.1

【お知らせ】英単語を画像イメージで楽に暗記できる辞書サイトを作りました。英語学習中の方は、ぜひご利用ください！

画像付き英語辞書 Imagict | 英単語をイメージで暗記
【開発記録】
英単語を画像イメージで暗記できる英語辞書サービスを作って公開しました

結論を先に書きますと… 自動読み込みを有効にするために、


$ composer dumpautoload

$ composer dumpautoload

を実行して、Composer の自動読み込みキャッシュをリフレッシュさせる必要がありました。

CakePHP3 でプラグイン作成と autoload 設定

プラグイン作成については、公式ドキュメントが詳しい。

プラグイン – CakePHP Cookbook 3.x ドキュメント

bin/cake bake コマンドでプラグインを生成します。


$ bin/cake bake plugin MyPlugin

$ bin/cake bake plugin MyPlugin

あとは、プラグインを好きなように作成する。

続いて、作成したプラグインを読み込むために、config/bootstrap.php に load の追記をする。

config/bootstrap.php

Plugin::load('MyPlugin');

1	Plugin::load('MyPlugin');

それから、自動読み込みを有効にするために、composer.json に autoload を追記します。

composer.json

"autoload": {
    "psr-4": {
        "App\\": "src",
        "MyPlugin\\": "./plugins/MyPlugin/src"
    }
},
"autoload-dev": {
    "psr-4": {
        "App\\Test\\": "tests",
        "Cake\\Test\\": "./vendor/cakephp/cakephp/tests",
        "MyPlugin\\Test\\": "./plugins/MyPlugin/tests"
    }
}