ZF3：从数据库填充表单下拉选择框

嘿，这个需求我太熟了！刚好我之前用ZF3开发的时候也做过类似的关联数据库下拉框，用的就是官方博客教程里的SQL抽象方案，一步步来给你讲清楚怎么做：

首先你需要在处理国家表的CountryTable类里，写一个专门返回键值对的方法——键是国家ID，值是国家名称，这样刚好适配下拉框的value_options需求。

// module/Application/src/Model/CountryTable.php
use Zend\Db\TableGateway\TableGatewayInterface;

class CountryTable
{
    protected $tableGateway;

    public function __construct(TableGatewayInterface $tableGateway)
    {
        $this->tableGateway = $tableGateway;
    }

    // 新增这个方法，返回国家选项的键值对
    public function getCountryOptions()
    {
        $resultSet = $this->select(); // 查询所有国家数据
        $options = [];
        
        foreach ($resultSet as $country) {
            $options[$country->id] = $country->name;
        }
        
        return $options;
    }

    // 你原本的其他方法（比如fetchAll、getCountry等）
}

接下来要让你的用户表单能拿到CountryTable的实例，所以需要在表单的构造函数里注入它，然后在init()方法中添加下拉框元素。

// module/Application/src/Form/UserForm.php
use Application\Model\CountryTable;
use Zend\Form\Form;

class UserForm extends Form
{
    protected $countryTable;

    // 构造函数接收CountryTable实例
    public function __construct(CountryTable $countryTable, $name = null)
    {
        parent::__construct('user');
        $this->countryTable = $countryTable;
        $this->init();
    }

    public function init()
    {
        // 你原本的其他表单元素（比如username、email等）
        $this->add([
            'name' => 'id',
            'type' => 'Hidden',
        ]);

        // ...其他元素

        // 添加国家下拉框
        $this->add([
            'type' => 'Zend\Form\Element\Select',
            'name' => 'country_id', // 和users表的字段名对应
            'options' => [
                'label' => '国家',
                'value_options' => $this->countryTable->getCountryOptions(), // 调用刚才写的方法
                'empty_option' => '请选择国家', // 可选：添加默认空选项
            ],
            'attributes' => [
                'class' => 'form-control', // 可选：添加样式类
                'required' => true, // 如果是必填项就加上
            ]
        ]);

        // 提交按钮
        $this->add([
            'name' => 'submit',
            'type' => 'Submit',
            'attributes' => [
                'value' => '保存',
                'class' => 'btn btn-primary',
            ],
        ]);
    }
}

ZF3的对象都是通过ServiceManager管理的，所以你需要配置工厂，让ServiceManager在创建UserForm时自动注入CountryTable实例。

方式1：直接在module.config.php里写匿名工厂 #

// module/Application/config/module.config.php
use Zend\ServiceManager\Factory\InvokableFactory;
use Application\Model\CountryTable;
use Application\Form\UserForm;
use Zend\Db\Adapter\AdapterInterface;
use Zend\Db\TableGateway\TableGateway;

return [
    // ...其他配置
    
    'service_manager' => [
        'factories' => [
            // 配置CountryTable的工厂（如果还没配的话）
            CountryTable::class => function($sm) {
                $tableGateway = $sm->get('CountryTableGateway');
                return new CountryTable($tableGateway);
            },
            'CountryTableGateway' => function ($sm) {
                $dbAdapter = $sm->get(AdapterInterface::class);
                $resultSetPrototype = new \Zend\Db\ResultSet\ResultSet();
                $resultSetPrototype->setArrayObjectPrototype(new \Application\Model\Country());
                return new TableGateway('countries', $dbAdapter, null, $resultSetPrototype);
            },
            
            // 配置UserForm的工厂，注入CountryTable
            UserForm::class => function($sm) {
                $countryTable = $sm->get(CountryTable::class);
                return new UserForm($countryTable);
            },
        ],
    ],
];

方式2：用单独的工厂类（更规范，适合复杂场景） #

先创建UserFormFactory类：

// module/Application/src/Form/UserFormFactory.php
use Interop\Container\ContainerInterface;
use Zend\ServiceManager\Factory\FactoryInterface;
use Application\Form\UserForm;
use Application\Model\CountryTable;

class UserFormFactory implements FactoryInterface
{
    public function __invoke(ContainerInterface $container, $requestedName, array $options = null)
    {
        $countryTable = $container->get(CountryTable::class);
        return new UserForm($countryTable);
    }
}

然后在module.config.php里配置：

// module/Application/config/module.config.php
use Application\Form\UserForm;
use Application\Form\UserFormFactory;

return [
    // ...其他配置
    
    'service_manager' => [
        'factories' => [
            // ...其他工厂
            
            UserForm::class => UserFormFactory::class,
        ],
    ],
];

现在你可以在控制器里通过ServiceManager拿到配置好的表单了：

// module/Application/src/Controller/UserController.php
use Application\Form\UserForm;
use Zend\Mvc\Controller\AbstractActionController;
use Zend\View\Model\ViewModel;

class UserController extends AbstractActionController
{
    public function addAction()
    {
        // 获取表单实例
        $form = $this->getServiceLocator()->get(UserForm::class);
        
        // 处理表单提交逻辑（验证、保存到users表等）
        $request = $this->getRequest();
        if ($request->isPost()) {
            $user = new \Application\Model\User();
            $form->setInputFilter($user->getInputFilter());
            $form->setData($request->getPost());
            
            if ($form->isValid()) {
                $user->exchangeArray($form->getData());
                // 调用UserTable的saveUser方法保存数据
                $this->getServiceLocator()->get(\Application\Model\UserTable::class)->saveUser($user);
                
                return $this->redirect()->toRoute('user');
            }
        }
        
        return new ViewModel([
            'form' => $form,
        ]);
    }

    // ...其他动作（比如editAction，逻辑类似，需要回显country_id的值）
}

最后在视图脚本里渲染这个下拉框元素：

<!-- module/Application/view/application/user/add.phtml -->
<h1>添加用户</h1>
<?php
$form->setAttribute('action', $this->url('user', ['action' => 'add']));
$form->prepare();

echo $this->form()->openTag($form);
?>

<div class="form-group">
    <?= $this->formLabel($form->get('country_id')) ?>
    <?= $this->formSelect($form->get('country_id')) ?>
    <?= $this->formElementErrors($form->get('country_id')) ?>
</div>

<!-- 其他表单元素的渲染 -->
<div class="form-group">
    <?= $this->formSubmit($form->get('submit')) ?>
</div>

<?= $this->form()->closeTag() ?>

• 确保你的Country模型类已经正确映射了countries表的字段（比如id和name），这样$country->id和$country->name才能正确取值。
• 如果国家数据量很大，可以考虑给查询加缓存，避免每次加载表单都查数据库。
• 编辑用户时，表单会自动根据user对象的country_id值选中对应的下拉选项，只要你在控制器里正确设置了表单的数据。

内容的提问来源于stack exchange，提问作者Rúben Silva