[030] Symfony4 数据库入门 Part01

Symfony 框架本身没有操作数据库的组件, 操作数据库是通过第三方的ORM包来提供的. 采用的是 Doctrine.

安装 Doctrine

在SF项目中使用 Doctrine 之前, 需要安装一下包: symfony/orm-pack, 同时一个代码生成包 symfony/maker-bundle 也安装一下方便生成代码.

composer require symfony/orm-pack
composer require symfony/maker-bundle --dev

配置数据库连接信息.

在项目的 .env 文件中配置好关键的数据库连接信息. 找到 DATABASE_URL 这行, 和普通的数据库连接配置一样.

# 修改mysql连接信息.
DATABASE_URL="mysql://db_user:[email protected]:3306/db_name"

# 如果使用Sqlite数据库,可以按下面的配置.
# DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"

如果数据库连接信息中包含特殊字符, 比如(+, @, $, #, /, :, *, !), 需要进行urlencode编码.

数据库配置完成, 可以使用命令行执行创建数据库, 看看参数是否配置成功.

bin/console doctrine:database:create

更多的数据库连接配置信息在 config/packages/doctrine.yaml 文件中可以具体进行配置. 特别注意一下 server_version, 这个要和实际使用的数据库配置一样的版本. 不然可能会影响到 Doctrine 的某些功能.

Doctrine 提供丰富的命令行操作. 具体的可以通过 bin/console list doctrine 来查看所有的Doctrine命令信息.
另外也可以使用 bin/console list make 来了解一下 make 包提供的指令, 接下来我们就开始使用 make 快速创建 php 的对象定义.

创建一个实体类: Entity Class

创建一个商品实体类: Product, 使用命令: make:entity 即可, 这个命令会引导完成整改实体类的定义, 只需要按命令行的提问一步一步的回答即可. 非常的方便.

bin/console make:entity

 Class name of the entity to create or update (e.g. GentleElephant):
 > Product

 created: src/Entity/Product.php
 created: src/Repository/ProductRepository.php
 
 Entity generated! Now let's add some fields!
 You can always add more fields later manually or by re-running this command.

 New property name (press  to stop adding fields):
 > name

 Field type (enter ? to see all types) [string]:
 > string

 Field length [255]:
 > 255

 Can this field be null in the database (nullable) (yes/no) [no]:
 > no

 updated: src/Entity/Product.php

 Add another property? Enter the property name (or press  to stop adding fields):
 > price

 Field type (enter ? to see all types) [string]:
 > integer

 Can this field be null in the database (nullable) (yes/no) [no]:
 > no

 updated: src/Entity/Product.php

 Add another property? Enter the property name (or press  to stop adding fields):
 > 

  Success! 
          
 Next: When you're ready, create a migration with make:migration

这里给 Product 实体添加了2个属性, name, price.

看一下生成的具体的PHP文件: src/Entity/Product.php

在正式使用 make 生成实体的时候需要注意一下属性名, 避免和数据库的关键字冲突.
make:entity 可以创建新的 Entity, 也可以修改现有的 Entity.
生成后的 Entity 需要再进行修改. make:entity 只是提供了简略的类定义.

创建数据表

创建实体后, 需要映射到真实数据库中成为数据表. 可以使用doctrine:schema:update 来在开发环境中快速把实体定义转成真实的数据表在数据库中. 在正式环境, 通常使用 'Migrations' 脚本来更新数据库结构.

使用 make:migration 非常容易实现数据库的变迁脚本:

$ bin/console make:migration

           
  Success! 
           

 Next: Review the new migration "src/Migrations/Version20190316143744.php"
 Then: Run the migration with php bin/console doctrine:migrations:migrate

文件: src/Migrations/Version20190316143744.php 中包含了具体的SQL更新代码.

确认 SQL代码无误后, 执行下面的指令, 正式更新数据库结构.

$ bin/console doctrine:migrations:migrate

上面的过程是可以重复执行的. 在需要修改实体后, 再重复的执行, 更新数据库结构.

接下来在 Part02 部分了解一下操作数据库的增删改查操作.