在 Hyperf 框架中，如何定製 gen:model 命令

李銘昕發表於2020-12-16

Hyperf v2.0 版本中，會將 decimal 轉化為 float，從而存在精度丟失的風險。如果直接修改這個問題，可能會導致 v2.0 出現 BC，所以我們在 v2.1 中得到了處理，詳情可見 PR#2979

但還在使用 v2.0 版本的同學要怎麼辦呢，其實我們可以通過重寫 ModelUpdateVisitor，很簡單的處理這件事。

建立模型

我們先在原來的情況下，執行 gen:model，為了後面高度定製，我們先將 $timestamps 設定為 false，這樣 created_at 和 updated_at 預設都會轉化為 string。

以下為生成的模型：

<?php

declare(strict_types=1);
/**
 * This file is part of Hyperf.
 *
 * @link     https://www.hyperf.io
 * @document https://hyperf.wiki
 * @contact  group@hyperf.io
 * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
 */
namespace App\Model;

/**
 * @property int $id
 * @property int $count
 * @property float $float_num
 * @property string $str
 * @property string $json
 * @property string $created_at
 * @property string $updated_at
 */
class UserExt extends Model
{
    public $timestamps = false;

    /**
     * The table associated with the model.
     *
     * @var string
     */
    protected $table = 'user_ext';

    /**
     * The attributes that are mass assignable.
     *
     * @var array
     */
    protected $fillable = ['id', 'count', 'float_num', 'str', 'json', 'created_at', 'updated_at'];

    /**
     * The attributes that should be cast to native types.
     *
     * @var array
     */
    protected $casts = ['id' => 'integer', 'count' => 'integer', 'float_num' => 'float'];
}

我們可以看到，float_num 會被 cast 強制轉化為 float。

重寫 ModelUpdateVisitor

接下來我們重寫 ModelUpdateVisitor，將以下注釋的程式碼刪掉。

<?php

declare(strict_types=1);
/**
 * This file is part of Hyperf.
 *
 * @link     https://www.hyperf.io
 * @document https://hyperf.wiki
 * @contact  group@hyperf.io
 * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
 */
namespace App\Visitor;

use Hyperf\Database\Commands\Ast\ModelUpdateVisitor as Visitor;

class ModelUpdateVisitor extends Visitor
{
    protected function formatDatabaseType(string $type): ?string
    {
        switch ($type) {
            case 'tinyint':
            case 'smallint':
            case 'mediumint':
            case 'int':
            case 'bigint':
                return 'integer';
            // case 'decimal':
            // case 'float':
            // case 'double':
            // case 'real':
            //     return 'float';
            case 'bool':
            case 'boolean':
                return 'boolean';
            default:
                return null;
        }
    }
}

然後將其配置到 dependencies.php 中：

<?php

declare(strict_types=1);
/**
 * This file is part of Hyperf.
 *
 * @link     https://www.hyperf.io
 * @document https://hyperf.wiki
 * @contact  group@hyperf.io
 * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
 */
return [
    Hyperf\Database\Commands\Ast\ModelUpdateVisitor::class => App\Visitor\ModelUpdateVisitor::class,
];

然後讓我們重新執行 php bin/hyperf.php gen:model --force-casts，就可以看到，對應的 float_num 已經不會再轉化成 float 了。

<?php

declare (strict_types=1);
/**
 * This file is part of Hyperf.
 *
 * @link     https://www.hyperf.io
 * @document https://hyperf.wiki
 * @contact  group@hyperf.io
 * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
 */
namespace App\Model;

/**
 * @property int $id
 * @property int $count
 * @property string $float_num
 * @property string $str
 * @property string $json
 * @property string $created_at
 * @property string $updated_at
 */
class UserExt extends Model
{
    public $timestamps = false;
    /**
     * The table associated with the model.
     *
     * @var string
     */
    protected $table = 'user_ext';
    /**
     * The attributes that are mass assignable.
     *
     * @var array
     */
    protected $fillable = ['id', 'count', 'float_num', 'str', 'json', 'created_at', 'updated_at'];
    /**
     * The attributes that should be cast to native types.
     *
     * @var array
     */
    protected $casts = ['id' => 'integer', 'count' => 'integer'];
}

當然除此之外，我們也可以通過這種方式，自動處理 json 和 datetime 格式，修改我們的 ModelUpdateVisitor

<?php

declare(strict_types=1);
/**
 * This file is part of Hyperf.
 *
 * @link     https://www.hyperf.io
 * @document https://hyperf.wiki
 * @contact  group@hyperf.io
 * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
 */
namespace App\Visitor;

use Hyperf\Database\Commands\Ast\ModelUpdateVisitor as Visitor;

class ModelUpdateVisitor extends Visitor
{
    protected function formatDatabaseType(string $type): ?string
    {
        switch ($type) {
            case 'tinyint':
            case 'smallint':
            case 'mediumint':
            case 'int':
            case 'bigint':
                return 'integer';
            case 'timestamp':
            case 'datetime':
                return 'datetime';
            case 'json':
                return 'json';
            case 'bool':
            case 'boolean':
                return 'boolean';
            default:
                return null;
        }
    }
}

然後重新執行 php bin/hyperf.php gen:model --force-casts，就可以看到結果了。

<?php

declare(strict_types=1);
/**
 * This file is part of Hyperf.
 *
 * @link     https://www.hyperf.io
 * @document https://hyperf.wiki
 * @contact  group@hyperf.io
 * @license  https://github.com/hyperf/hyperf/blob/master/LICENSE
 */
namespace App\Model;

/**
 * @property int $id
 * @property int $count
 * @property string $float_num
 * @property string $str
 * @property array $json
 * @property \Carbon\Carbon $created_at
 * @property \Carbon\Carbon $updated_at
 */
class UserExt extends Model
{
    public $timestamps = false;

    /**
     * The table associated with the model.
     *
     * @var string
     */
    protected $table = 'user_ext';

    /**
     * The attributes that are mass assignable.
     *
     * @var array
     */
    protected $fillable = ['id', 'count', 'float_num', 'str', 'json', 'created_at', 'updated_at'];

    /**
     * The attributes that should be cast to native types.
     *
     * @var array
     */
    protected $casts = ['id' => 'integer', 'count' => 'integer', 'json' => 'json', 'created_at' => 'datetime', 'updated_at' => 'datetime'];
}

寫在最後

Hyperf 是基於 Swoole 4.5+ 實現的高效能、高靈活性的 PHP 協程框架，內建協程伺服器及大量常用的元件，效能較傳統基於 PHP-FPM 的框架有質的提升，提供超高效能的同時，也保持著極其靈活的可擴充套件性，標準元件均基於 PSR 標準實現，基於強大的依賴注入設計，保證了絕大部分元件或類都是可替換與可複用的。

框架元件庫除了常見的協程版的 MySQL 客戶端、Redis 客戶端，還為您準備了協程版的 Eloquent ORM、WebSocket 服務端及客戶端、JSON RPC 服務端及客戶端、GRPC 服務端及客戶端、Zipkin/Jaeger (OpenTracing) 客戶端、Guzzle HTTP 客戶端、Elasticsearch 客戶端、Consul 客戶端、ETCD 客戶端、AMQP 元件、Apollo 配置中心、阿里雲 ACM 應用配置管理、ETCD 配置中心、基於令牌桶演算法的限流器、通用連線池、熔斷器、Swagger 文件生成、Swoole Tracker、Blade 和 Smarty 檢視引擎、Snowflake 全域性ID生成器等元件，省去了自己實現對應協程版本的麻煩。

Hyperf 還提供了基於 PSR-11 的依賴注入容器、註解、AOP 面向切面程式設計、基於 PSR-15 的中介軟體、自定義程式、基於 PSR-14 的事件管理器、Redis/RabbitMQ 訊息佇列、自動模型快取、基於 PSR-16 的快取、Crontab 秒級定時任務、Translation 國際化、Validation 驗證器等非常便捷的功能，滿足豐富的技術場景和業務場景，開箱即用。

本作品採用《CC 協議》，轉載必須註明作者和本文連結

Any fool can write code that a computer can understand. Good programmers write code that humans can understand.

如何在定製化元件中實現並使用v-model
2018-04-25
元件
如何在非 Hyperf 框架中使用 Hyperf Docker 映象
2020-01-08
框架Docker
[Hyperf] 在 Hyperf 框架中使用 prometheus + grafana 部署基本的監控
2020-03-05
框架PrometheusGrafana
CAD中如何繪製填充命令
2021-07-23
Hyperf - windows11 使用docker搭建hyperf框架
2024-04-23
WindowsDocker框架
如何減少 Hyperf 框架的掃描時間
2020-04-07
框架
在swoole中製作一款仿製laravel的框架
2021-03-15
Laravel框架
使用 xclip 在 Linux 命令列中複製貼上
2019-07-12
Linux命令列
在Visio中如何繪製直線
2020-11-14
bo 框架之 beego 框架 model curd
2019-03-24
框架Go
如何在其他框架中使用 Hyperf 國際化元件
2020-04-08
框架元件
在Linux中如何使用at命令安排任務
2020-04-22
Linux
在 hyperf 中使用 MongoDB
2019-12-27
MongoDB
CAD複製命令如何使用
2021-08-04
在Linux中，如何設定網路路由？
2024-05-01
Linux路由
XXL-JOB定時任務框架(Oracle定製版)
2023-04-13
框架Oracle
Spring Boot專案中如何定製攔截器
2021-09-09
Spring Boot
在pytorch框架下，訓練model過程中，loss=nan問題時該怎麼解決？
2018-08-16
PyTorch框架NaN
v-model指令在元件中怎麼玩
2019-03-04
元件
Hyperf 框架建立 JSON-rpc 服務
2019-12-03
框架JSONRPC
hyperf 框架動態修改或追加配置
2022-03-01
框架
記錄hyperf框架表單驗證中的細枝末節
2021-07-01
框架
如何在 Fedora 30 中設定核心命令列引數
2019-04-26
命令列
在 Linux 中如何從命令列查詢 VirtualBox 版本
2019-07-14
Linux命令列
在CAD夢想畫圖中如何使用PLAN命令
2021-06-17
PHP-Parse 簡介以及在 Hyperf 中的應用
2020-11-16
PHP
在Linux中，如何設定防火牆規則？
2024-05-24
Linux防火牆
CAD如何繪製批註命令
2021-07-27
hyperf如何接入swoole enterprise
2019-07-23
在Linux中，如何使用logrotate命令管理日誌檔案?
2024-05-04
Linuxlogrotate
zsh 命令在 alias 中如何轉義 ' 字元(單引號)
2023-04-13
字元
在.bashrc 裡用 alias 設定快捷命令
2019-04-04
在Qml 中定義訊號並如何觸發
2024-07-01
在Java中是如何定義和宣告介面的?
2021-09-06
Java
在Linux中，如何使用grep命令查詢檔案中的內容？
2024-03-31
Linux
如何定製 Spring Boot 的 Banner？
2021-09-09
Spring Boot
Yii 框架Model和ActiveRecord 的區別
2020-09-28
框架
記在 Hyperf 中多庫連線操作事務注意事項
2020-07-24

在 Hyperf 框架中，如何定製 gen:model 命令

建立模型

重寫 ModelUpdateVisitor

寫在最後

相關文章