如何在CakePHP3的多页面中调用非模态表单？

嘿，我来帮你搞定这个表单复用的问题！在CakePHP 3里要把非模态表单放到多个页面的内容区域，用**元素（Element）**就能轻松实现——这是CakePHP专门用来复用视图代码的机制。下面一步步来操作：

1. 把表单抽成可复用的元素 #

首先，我们把你现有的表单代码提取成一个独立的元素文件：

• 在src/Template/Elements/目录下创建一个新文件，命名为contact_form.ctp
• 把你的表单代码复制进去，注意给表单指定提交的目标控制器/方法（确保无论在哪个页面提交，都能正确处理）：

<?= $this->Form->create($contact, ['url' => ['controller' => 'Contacts', 'action' => 'add']]); ?>
    <?= $this->Form->input('name'); ?>
    <?= $this->Form->input('email'); ?>
    <?= $this->Form->input('body'); ?>
    <?= $this->Form->button('提交'); ?>
<?= $this->Form->end(); ?>

2. 在需要显示表单的控制器中初始化表单实体 #

接下来，在每个要显示表单的页面对应的控制器方法里，创建并传递$contact实体（因为表单需要这个实体来绑定数据）。比如：

• 如果你要在关于我们页面显示，打开src/Controller/AboutController.php，修改index方法：

public function index()
{
    // 初始化联系表单的空实体
    $contact = $this->loadModel('Contacts')->newEmptyEntity();
    $this->set(compact('contact'));
    
    // 原来的关于页面逻辑保留在这里
    // $about = ...
}

• 同样，在联系我们页面的ContactsController.php的index方法里也做类似操作（如果之前没有的话）：

public function index()
{
    $contact = $this->Contacts->newEmptyEntity();
    $this->set(compact('contact'));
}

3. 在目标页面的视图中调用元素 #

最后，在需要显示表单的页面视图里（比如About/index.ctp或者Contacts/index.ctp的内容区域），添加调用元素的代码：

<!-- 在页面内容的合适位置插入 -->
<?= $this->element('contact_form', ['contact' => $contact]); ?>

4. 完善表单提交后的逻辑 #

确保你的ContactsController.php里的add方法能正确处理提交，并且可以根据需求跳转回原页面：

public function add()
{
    $contact = $this->Contacts->newEmptyEntity();
    if ($this->request->is('post')) {
        $contact = $this->Contacts->patchEntity($contact, $this->request->getData());
        if ($this->Contacts->save($contact)) {
            $this->Flash->success(__('你的留言已提交成功！'));
            
            // 跳转回提交表单的原页面，或者指定页面
            return $this->redirect($this->referer(['action' => 'index']));
        }
        $this->Flash->error(__('抱歉，提交失败，请重试。'));
    }
    $this->set(compact('contact'));
}

这样一来，你的联系表单就能在关于我们、联系我们等任意页面的内容区域里显示了，完美实现复用！

内容的提问来源于stack exchange，提问作者Jervyn Paller