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:db_password@127.0.0.1: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 <return> 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 <return> 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 <return> 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
<?php
namespace App\Entity;
use Doctrine\ORM\Mapping as ORM;
/**
* @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
*/
class Product
{
/**
* @ORM\Id()
* @ORM\GeneratedValue()
* @ORM\Column(type="integer")
*/
private $id;
/**
* @ORM\Column(type="string", length=255)
*/
private $name;
/**
* @ORM\Column(type="integer")
*/
private $price;
// ... getter and setter methods
}
在正式使用 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 部分了解一下操作数据库的增删改查操作.
