FireRabbit-Engine 实战从零搭建个人博客（二）创建博客所需的表

Phinx

官方网站：Phinx - 官方文档

phinx 是一个数据库迁移插件，它可以帮你实现不使用 sql 文件来创建表。

框架还没集成数据库迁移系统，因此就需要自己手动安装了。

安装

执行命令：composer require robmorgan/phinx。

初始化

第一次安装还需要进行初始化：vendor/bin/phinx init，不然 phinx 不知道你的数据库账号密码就无法连接了。

初始化完成后，在项目根目录会出现一个配置文件 phinx.php：

<?php

return
[
    'paths' => [
        'migrations' => '%%PHINX_CONFIG_DIR%%/db/migrations',
        'seeds' => '%%PHINX_CONFIG_DIR%%/db/seeds'
    ],
    'environments' => [
        'default_migration_table' => 'phinxlog',
        'default_environment' => 'development',
        'production' => [
            'adapter' => 'mysql',
            'host' => 'localhost',
            'name' => 'production_db',
            'user' => 'root',
            'pass' => '',
            'port' => '3306',
            'charset' => 'utf8',
        ],
        'development' => [
            'adapter' => 'mysql',
            'host' => 'localhost',
            'name' => 'development_db',
            'user' => 'root',
            'pass' => '',
            'port' => '3306',
            'charset' => 'utf8',
        ],
        'testing' => [
            'adapter' => 'mysql',
            'host' => 'localhost',
            'name' => 'testing_db',
            'user' => 'root',
            'pass' => '',
            'port' => '3306',
            'charset' => 'utf8',
        ]
    ],
    'version_order' => 'creation'
];

默认是 development 环境，在这里修改自己的数据库配置。

虽然 phinx 是数据库迁移，但它本身创建不了数据库，需要手动创建。

修改完成后，再创建一个名词叫做 blog 的数据库即可。

迁移目录

根据配置文件最上方的目录：

'paths' => [
    'migrations' => '%%PHINX_CONFIG_DIR%%/db/migrations',
    'seeds' => '%%PHINX_CONFIG_DIR%%/db/seeds'
],

创建对应的文件夹。

创建表迁移

命令：vendor/bin/phinx create xxxx。

xxx 是表名，使用大驼峰方式。

执行迁移

命令：vendor/bin/phinx migrate。

项目所需表

博客项目需要的表及对应的字段，表名默认为复数形式（即加一个 s）。

所有的表都有一个自增主键。

用户表：users

name：昵称
email：注册邮箱
password：密码，采用明文方式存储（本项目只是测试而已~~~好孩子不要学）
created：注册时间

执行命令：vendor/bin/phinx create User

在迁移目录 migrations 即可看到迁移文件，修改迁移文件内容：

<?php
declare(strict_types=1);

use Phinx\Migration\AbstractMigration;

final class User extends AbstractMigration
{
    /**
     * Change Method.
     *
     * Write your reversible migrations using this method.
     *
     * More information on writing migrations is available here:
     * https://book.cakephp.org/phinx/0/en/migrations.html#the-change-method
     *
     * Remember to call "create()" or "update()" and NOT "save()" when working
     * with the Table class.
     */
    public function change(): void
    {
        $table = $this->table('users', ['signed' => false]);
        $table->addColumn('name', 'string', ['limit' => 16])
            ->addColumn('email', 'string', ['limit' => 64])
            ->addColumn('password', 'string', ['limit' => 64])
            ->addColumn('created', 'timestamp', ['default' => 'CURRENT_TIMESTAMP'])
            ->addIndex(['email', 'password'])
            ->create();
    }
}

邮箱和密码设置为关联索引，这样用户在登录的时候可以直接从索引返回查询结果，查询速度非常快。

created 是时间戳，直接使用当前时间作为值。

文章表：articles

user_id：作者 ID
title：标题
classify：分类
cover：封面图
view_count：浏览次数
created：发布日期

执行命令：vendor/bin/phinx create ArticleContent

<?php
declare(strict_types=1);

use Phinx\Migration\AbstractMigration;

final class Article extends AbstractMigration
{
    /**
     * Change Method.
     *
     * Write your reversible migrations using this method.
     *
     * More information on writing migrations is available here:
     * https://book.cakephp.org/phinx/0/en/migrations.html#the-change-method
     *
     * Remember to call "create()" or "update()" and NOT "save()" when working
     * with the Table class.
     */
    public function change(): void
    {
        $table = $this->table('articles', ['signed' => false]);
        $table->addColumn('title', 'string', ['limit' => 32])
            ->addColumn('classify', 'string', ['limit' => 32])
            ->addColumn('cover', 'string', ['limit' => 255])
            ->addColumn('user_id', 'integer', ['signed' => false])
            ->addColumn('view_count', 'integer', ['signed' => false])
            ->addColumn('created', 'timestamp', ['default' => 'CURRENT_TIMESTAMP'])
            ->addIndex(['user_id'])
            ->create();
    }
}

文章内容表：article_contents

article_id：文章 ID
content：内容

执行命令：vendor/bin/phinx create ArticleContent

<?php
declare(strict_types=1);

use Phinx\Migration\AbstractMigration;

final class ArticleContent extends AbstractMigration
{
    /**
     * Change Method.
     *
     * Write your reversible migrations using this method.
     *
     * More information on writing migrations is available here:
     * https://book.cakephp.org/phinx/0/en/migrations.html#the-change-method
     *
     * Remember to call "create()" or "update()" and NOT "save()" when working
     * with the Table class.
     */
    public function change(): void
    {
        $table = $this->table('article_contents', ['signed' => false]);
        $table->addColumn('article_id', 'integer', ['signed' => false])
            ->addColumn('content', 'text')
            ->addIndex(['article_id'])
            ->create();
    }
}

email_codes：邮件验证码

email：邮箱
code：验证码
created：创建日期

执行命令：vendor/bin/phinx create EmailCode

<?php
declare(strict_types=1);

use Phinx\Migration\AbstractMigration;

final class EmailCode extends AbstractMigration
{
    /**
     * Change Method.
     *
     * Write your reversible migrations using this method.
     *
     * More information on writing migrations is available here:
     * https://book.cakephp.org/phinx/0/en/migrations.html#the-change-method
     *
     * Remember to call "create()" or "update()" and NOT "save()" when working
     * with the Table class.
     */
    public function change(): void
    {
        $table = $this->table('email_codes', ['signed' => false]);
        $table->addColumn('email', 'string', ['limit' => 64])
            ->addColumn('code', 'string', ['limit' => 8])
            ->addColumn('created', 'timestamp', ['default' => 'CURRENT_TIMESTAMP'])
            ->addIndex(['email'])
            ->create();
    }
}

生成表

执行命令：vendor/bin/phinx migrate

然后打开数据库，可以看到：

生成了这些表之后，就可以直接用框架集成的 ORM 调用了。

Model

ORM 默认使用的表名即复数形式，也可以指定一个表名，只需要修改 $table 变量即可。

创建一个用来保存模型文件的目录 app/Http/Model。

User

<?php
/**
 * Created by PhpStorm
 * Author：FireRabbit
 * Date：2021/2/19
 * Time：14:00
 **/


namespace App\Http\Model;


use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    protected $guarded = [];
    public $timestamps = false;
}

Article

<?php
/**
 * Created by PhpStorm
 * Author：FireRabbit
 * Date：2021/2/19
 * Time：19:43
 **/


namespace App\Http\Model;


use Illuminate\Database\Eloquent\Model;

class Article extends Model
{
    protected $guarded = [];
    public $timestamps = false;

    public function content()
    {
        return $this->hasOne(ArticleContent::class)->withDefault();
    }
}

ArticleContent

<?php
/**
 * Created by PhpStorm
 * Author：FireRabbit
 * Date：2021/2/19
 * Time：19:43
 **/


namespace App\Http\Model;


use Illuminate\Database\Eloquent\Model;

class ArticleContent extends Model
{
    protected $guarded = [];
    public $timestamps = false;
}

EmailCode

<?php
/**
 * Created by PhpStorm
 * Author：FireRabbit
 * Date：2021/2/19
 * Time：19:44
 **/


namespace App\Http\Model;


use Illuminate\Database\Eloquent\Model;

class EmailCode extends Model
{
    protected $guarded = [];
    public $timestamps = false;
}

结束语

现在数据库和模型已经设定好了，接下来就可以直接开始业务处理了！