cakephp3 formhelperのcreate()メソッド、第一引数(コンテキスト)の理解ができない

Question

こんにちは。
現在cakephp3を覚えなくてはいけない状況なので、学び始めた者です！

個人学習で、
名前やメルアドを入力してもらい、同時に画像（動画）もアップしてもらう仕組みを作ってみています。

そこでform helperを使ってビューにformを作ってコントローラーで仕組みをいじっている段階です。

(不細工なのはご了承ください。。。)

    public function check(){
        $this->set("message","アップロードするファイルを選んでください");
        $usersTable = $this->UsersTables->newEntity();

        if ($this->request->is('post')) {
            $usersTable = $this->UsersTables->patchEntity($usersTable, $this->request->getData());
            $uploaddir = WWW_ROOT;
            $uploadfile = $uploaddir.basename($this->request->getData('UploadData.name'));

                if (move_uploaded_file($this->request->getData('UploadData.tmp_name'), $uploadfile)) {
                    if ($this->UsersTables->save($usersTable)) {
                        $this->Flash->success(__('保存が完了しました'));
                        return $this->redirect(['action' => 'index']);
                }
                $this->Flash->error(__('保存が失敗しました'));
            }
        }
        $this->set(compact('usersTable'));
    }

<?php
/**
 * @var \App\View\AppView $this
 * @var \App\Model\Entity\UsersTable $usersTable
 */
?>
<nav class="large-3 medium-4 columns" id="actions-sidebar">
    <ul class="side-nav">
        <li class="heading"><?= __('Actions') ?></li>
        <li><?= $this->Html->link(__('List Users Tables'), ['action' => 'index']) ?></li>
    </ul>
</nav>


<div class="usersTables form large-9 medium-8 columns content">
    <?= $this->Form->create($usersTable,['enctype' => 'multipart/form-data']) ?>
    <fieldset>
        <legend><?= __('下記に必要事項を入力してください') ?></legend>
        <?php
            echo $this->Form->control('company_name',["label" => "会社名"]);
            echo $this->Form->control('deps_name',["label" => "部署"]);
            echo $this->Form->control('registrant_name',["label" => "登録者"]);
            echo $this->Form->control('mail',["label" => "メールアドレス"]);
            echo ($message);
            echo $this->Form->control('UploadData',['type'=>'file','accept'=>'video/*',"label" => ""]);
            ?>
    </fieldset>
    <?= $this->Form->button(__('確認')); ?>
    <?= $this->Form->end() ?>
</div>

まず１つ目の疑問ですが、html（ビュー）のform作成始めに

$this->Form->create($usersTable,['enctype' => 'multipart/form-data'])

と記入していますが、createの第一引数はモデルクラスと同名にするという認識で合っていますか？
ドキュメントには

// /articles/add において

// $article は、空の Article エンティティーである必要があります。
echo $this->Form->create($article);

とあるのでモデルクラスのエンティティーが関係しているのだとは予想できます。（記入されたデータを使ってエンティティー（レコード）を作成する？）

しかし、書籍やネットで見るコードの中には$usersTableという書き方と'usersTable'という書き方があります。
どちらの書き方でも保存できてしまうので、後々これが足を引っ張るようなことが無いように理解したいです。
※もちろん空欄で書くと”Unable to find table class for current entity”と怒られます。

どちらが一般的な認識でしょうか？

２つ目にphp（コントローラー）の末尾に

$this->set(compact('usersTable'));

と書いてありますが、なぜこの変数を再度同じビューに投げているのでしょうか？色々参考に書いたため意味が理解できていません。また、このコードを書かないと一つ目の疑問のところと同じ段で

Undefined variable: usersTable 

とエラーが出ます。この二つの関係性が理解できません。

周りに聞くことができる環境でもないため、途方にくれています。
協力お願いいたします。

Comments

[m.ts10806]

タイトルには要件を書いてください。
cakephpについての質問であることはタグで分かります。
もっと質問内容に寄せたタイトルにしてください。

[m.ts10806]

>ネットを見ると
ドキュメントを読んでください。
https://book.cakephp.org/3.0/ja/views/helpers/form.html

[m.ts10806]

タイトルだけだと↑（ドキュメント読んでください）になりますけど、それで良ければ。
form helperについての質問を今後する可能性がないというのでしたらそれでも良いです。
要は、タイトルだけで自分や他の人に何が問題か伝わるかが大事です。
https://teratail.com/help/question-tips#questionTips3-1

[kipipipi]

アドバイスありがとうございます！ドキュメントは目を通すようにしているのですが、理解がうまくできない段階でした。うまく噛み砕いているサイトはないか巡っていると書き方が複数あったり、クラス名ですと言い切っていたのですがそれでもスッキリ消化できないでいませんでした。
タイトル変更しましたが、いかかでしょうか？？

[m.ts10806]

ドキュメントで理解できなかったところや読んで試したことを記載すると回答を得やすくなると思います

Answer 1

CakePHP に限らず、MVC モデルのフレームワークですと、View とは「何らかの Model を表示し、編集するためのもの」です。つまり View は Model と結びつきます。
なので、その View 上に form を作る場合、当然ながら「View と結びついている Model を編集するための form」になることが多いので、model　を指定してやる方が都合がよいのです。

$this->Form->create($usersTable, [...

新規に作成するための form なら中身は全部空でも問題ありませんが（select などの選択肢は別として）、既存のデータを編集する場合はそれでは困りますよね？
そこで、form を作成する際に「初期値として与えたいデータ」を ORM エンティティーの形で設定することができます。
普通はエンティティという実体なので、 $usersTable という書き方になります。
'usersTable' というのは、後に出てくる compact() を呼び出すときだけの書き方の筈です。

末尾

$this->set(compact('usersTable'));

の意味ですが、これを設定しておかないと、View を表示する php に $usersTable の内容が渡りません。もしこれがないと実際に試したように、$usersTable という変数が View からは見えないので、エラーになります。

コントローラーとビューは別の物ですから、受け渡すデータを指定しないと、データが渡らないのです。
この辺は両者がどう連携しているかを理解しないとわかりにくいかも知れません。

Comments

[kipipipi]

お返事が遅れ大変失礼しました。初心者用に噛み砕いて教えて頂けて大変ありがとうございました！！のみ込みやすく、スッと気持ちが軽くなりました。もっと深く理解したいと思います！！ありがとうございました！

Answer 2

createの第一引数はモデルクラスと同名にするという認識で合っていますか

違います。第一引数はエンティティ(\Cake\ORM\Entity)、または Modellessフォーム（\Cake\Form\Form）を指定します。
（正確には、あと二つ許可される形式がありますが、ほぼ使用しないので省きます。

しかし、書籍やネットで見るコードの中には$usersTableという書き方と'usersTable'という書き方があります。

いずれも間違いです。公式ドキュメント以外のネットの記事は間違いを含むものや、バージョンを明示していないため現在のバージョンでは動かないものが多くあります。できるだけ公式ドキュメントを参照するようにしてください。

文字列での指定の方はCakePHPのバージョン2以前の書き方です。

参考:
フォームの開始 | Form - 3.8

$this->set(compact('usersTable'));

コントローラーでこう書くと、テンプレート側で $usersTable を使用できるようになります。
CakePHPはMVCフレームワークですので、コントローラーからテンプレートへ明示的に変数をセットしないと、テンプレート側で変数を利用できません。

参考:
ビューとの相互作用 | コントローラー - 3.8

補足として、$usersTable という変数名を使用されていますが、これが混乱の元になっています。
$this->UsersTables->newEntity() の戻り値はエンティティオブジェクト(\App\Model\Entity\User)となりますので、Tableという接尾詞は不適切です。この場合であれば、$user がふさわしいでしょう。

テンプレート側のアノテーションも以下となります。

/**
 * @var \App\View\AppView $this
 * @var \App\Model\Entity\User $user
 */

Comments

[kipipipi]

お返事が遅れ申し訳ありません。なんとなくの理解ではうまくいかないなと反省しました。
最後のアドバイスもとても参考になりました！データベースから作り直して再度挑戦したいと思います！
ありがとうございました！！