使用 Symfony 控制台

Symfony 框架自带了一个内置的控制台工具，我们只需在项目根目录下执行以下命令即可触发：

php bin/console

这样，屏幕上会显示大量可用命令列表，分为以下几组：

assets
cache
config
debug
doctrine
generate
lint
orm
router
security
server
swiftmailer
translation

这些赋予我们各种功能。我们今后特别关注的是doctrine和generate命令。doctrine命令，更具体地说，是doctrine:generate:crud，它基于一个现有的Doctrine实体生成一个CRUD。此外，doctrine:generate:entity命令会在现有的bundle内生成一个新的Doctrine实体。对于我们想要快速、简单地创建实体以及围绕实体的整个CRUD的情况来说，这些命令是非常方便的。同样，generate:doctrine:entity和generate:doctrine:crud也做同样的事情。

在我们继续测试这些命令之前，我们需要确保我们的数据库配置参数已经到位，这样Symfony才能看到并与我们的数据库对话。为此，我们需要在app/config/parameters.yml文件中设置适当的值。

在本节中，让我们继续在默认的AppBundle包中创建一个简单的Customer实体，并围绕它进行整个CRUD，假设Customer实体有以下属性： firstname、lastname和e-mail。我们先在项目根目录下运行php bin/console generate:doctrine:entity命令，结果如下：

在这里，我们首先提供AppBundle:Customer作为实体名称，并确认使用注释作为配置格式。

最后，我们被要求开始向我们的实体添加字段。输入第一个名字并按下回车键，我们将通过一系列关于我们的字段类型、长度、nullable和唯一状态的简短问题，如下面的截图所示：

现在我们应该为我们的Customer实体生成两个类。通过Symfony和Doctrine的帮助，这些类被放在了对象关系映射器（ORM）的上下文中，因为它们将Customer实体和合适的数据库表联系起来。然而，我们还没有指示Symfony为我们的实体创建表。要做到这一点，我们执行以下命令：

php bin/console doctrine:schema:update --force

这将产生如下截图所示的输出:

如果我们现在看一下数据库，我们应该看到一个客户表，上面有所有适当的列，用SQL创建dsyntax创建如下：

CREATE TABLE `customer` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `firstname` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  `lastname` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  `email` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `UNIQ_81398E09E7927C74` (`email`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;

在这一点上，我们仍然没有一个实际的CRUD功能。我们只是有一个ORM授权的Customer实体类和它背后的相应数据库表。下面的命令将为我们生成实际的CRUD控制器和模板：

php bin/console generate:doctrine:crud

这将产生以下交互式输出：

通过提供完全分类的实体名称AppBundle:Customer，生成器会进行一系列额外的输入，从生成写操作、读取的配置类型到路由的前缀，如下截图所示：

一旦完成，我们应该能够通过简单地打开一个像 http://test.app/customer/（假设test.app是我们为我们的例子设置的主机）这样的URL来访问我们的Customer CRUD动作，如图所示：

如果我们点击创建一个新的条目链接，我们将被重定向到/customer/new/URL，如下图所示：

在这里，我们可以为我们的Customer实体输入实际值，并点击Create按钮，以便将其持久化到数据库customer表中。在添加了几个实体之后，现在初始的/customer/ URL已经能够将它们全部列出，如下截图所示：

在这里我们看到了显示和编辑操作的链接。显示操作是我们可以认为是面向客户的操作，而编辑操作是面向管理员的操作，点击编辑操作，我们会进入到/customer/1/edit/这个表单的URL。而这里的数字1是数据库中客户实体的ID。

在这里，我们可以更改属性值，然后点击 "编辑 "将其持久化回数据库，也可以点击 "删除 "按钮将实体从数据库中删除。

如果我们要用一个已经存在的电子邮件创建一个新的实体，这个实体被标记为一个唯一的字段，系统会抛出一个通用的错误，比如下面这个错误：

这只是系统默认的行为，随着我们的进一步发展，我们会研究如何让这个行为更加人性化。到现在，我们已经看到了Symfony的控制台是多么的强大。通过几个简单的命令，我们就能创建我们的实体和它的整个CRUD动作。控制台还有更多的功能，我们甚至可以创建自己的控制台命令，因为我们可以实现任何类型的逻辑。然而，就我们的需求而言，目前的实现暂时就足够了。

最后更新于4年前