CakePHP3に Invisible ReCaptchaを導入。recaptcha.ctpがないと言うエラーが発生

Question

CakePHP3に Invisible ReCaptchaを導入するため、下記のプラグインを導入し、設定方法の案内に沿って設定してみました。
https://github.com/mosaxiv/cakephp-invisible-recaptcha

・cakephp-invisible-recaptcha のインストール

composer require mosaxiv/cakephp-invisible-recaptcha

・cakephp-invisible-recaptcha のロード
/src/Controller/AppController.php に下記のソースコードを追加しました。
※下記の「sitekey」「secretkey」の値はサンプルのものです。

        Configure::write('recaptcha', [
            'sitekey' => '6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI',
            'secretkey' => '6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe',
        ]);
        $this->loadComponent('InvisibleReCaptcha.InvisibleReCaptcha');

・テンプレートに編集
/src/Template/Contacts/form.ctp に下記のコードを追加しました。

echo $this->InvisibleReCaptcha->render();

・コントローラーに編集
/src/Controller/ContactsController.php の formアクションにに下記のコードを追加しました。

    if (!$this->InvisibleReCaptcha->verify()) {
        echo "エラー";
    }

表示をさせてみたところ、テンプレートファイルの「echo $this->InvisibleReCaptcha->render();」を記述した場所に「An Internal Error Has Occurred」のエラーが表示されました。

エラーログを見たところ、下記のエラーが出力されていました。

Error: [Cake\View\Exception\MissingElementException] Element file "InvisibleReCaptcha.Element\recaptcha.ctp" is missing.

ただ、下記の場所には呼び出す対象と思われる「recaptcha.ctp」ファイルは存在していました。
/vendor/mosaxiv/cakephp-invisible-recaptcha/src/Template/Element/recaptcha.ctp

CakePHP3のバージョンによっては何か追加で記述する必要があるようなものなのでしょうか？
おわかりになる方、何か教えていただけませんでしょうか？

また、環境は以下になります。
PHP：7.2.6
CakePHP：3.7.4

Comments

[franmorisco]

I had the same problem. You only have to load de plugin en application.php with $this->addPlugin('InvisibleReCaptcha');

Answer 1

コンポーネント、ヘルパーは読み込まれているようなので、プラグインの呼び出しは問題ないようです。
考えられる可能性としては、ファイルパスの大文字小文字等の違いによるものでしょうか。

暫定的な対処方法として、 /vendor/mosaxiv/cakephp-invisible-recaptcha/src/Template/Element/recaptcha.ctp を、アプリケーションのsrc/Template/Plugin/InvisibleReCaptcha/Element/recaptcha.ctp としてコピーしたらどうでしょうか。

（プラグインテンプレートのアプリケーションからのオーバーライド機能です。 アプリケーション内からプラグインのテンプレートを上書き | プラグイン - 3.8

Comments

[takujiji]

ご回答、ありがとうございます！

src/Template/Plugin/InvisibleReCaptcha/Element/recaptcha.ctp
ご連絡をいただいた上記のパスに加え、下記のようないくつかのパターンも試してみましたがだめでした。
src/Template/Plugin/cakephp-invisible-recaptcha/Element/recaptcha.ctp
src/Template/Plugin/mosaxiv/cakephp-invisible-recaptcha/Element/recaptcha.ctp
src/Template/Plugin/Mosaxiv/cakephp-invisible-recaptcha/Element/recaptcha.ctp
src/Template/Plugin/mosaxiv/InvisibleReCaptcha/Element/recaptcha.ctp
src/Template/Plugin/Mosaxiv/InvisibleReCaptcha/Element/recaptcha.ctp

さらにいろいろ試してみた結果では、
/vendor/mosaxiv/cakephp-invisible-recaptcha/src/View/Helper/InvisibleReCaptchaHelper/InvisibleReCaptchaHelper.php
に下記の記述がありましたので、変更してみました。

// 変更前の元の記述
return $this->_View->element('InvisibleReCaptcha.recaptcha', $this->getConfig());
// 変更後の記述
return $this->_View->element('recaptcha', $this->getConfig());

加えて、「recaptcha.ctp」を「/src/Template/Element/」の中に入れると正しく動作しました。

また、下記のように変更して（「.」を「/」に変更）
// 変更前の元の記述
return $this->_View->element('InvisibleReCaptcha/recaptcha', $this->getConfig());

「recaptcha.ctp」を「/src/Template/Element/InvisibleReCaptcha/」の中に入れても正しく動作しました。

正しくファイルが読み込めていないことがエラーの原因であることは理解できましたが、「vendor」の中の本来の場所にあるファイルが読み込めないのはなぜなのか、おわかりになりますでしょうか？

[nojimage]

その状態だと、プラグインパスが正しく設定されていないのかもしれません。 \Cake\Core\Plugin::path(’ InvisibleReCaptcha’) の結果は /{アプリケーションルート}/vendor/mosaxiv/cakephp-invisible-recaptcha/ でしょうか。

[takujiji]

ご確認、ありがとうございます！
プラグインに正しくパスが通っていない、とのご指摘がありましたので、
/config/bootstrap.php に「\App\Application::addPlugin(’InvisibleReCaptcha’);」を追加したところ、正しくパスが取得できるようになり、「/src/Template/Element/recaptcha.ctp」を消してもエラーが発生しなくなりました。

プラグインを配布している Githubの設定手順の中にプラグインをロードする手順がありませんでしたので上記の記述を書いておりませんでしたが、これが必要だったわけですね。

ずっと悩んでおりましたが、nojimageさんにアドバイスをいただいたおかげで解決することができました。すごく助かりました。また一つ知識が増えました。ありがとうございました！！！