PHP怎么实现Eloquent Attribute Business Process States属性业务流程状态

在Laravel项目的工作流建模中，管理模型属性的业务流程状态是常见需求，比如用户账号的激活、禁用状态，订单的创建、支付、发货、完成等状态流转。传统的状态管理往往将状态值直接存储在数据库字段中，状态判断和流转逻辑分散在控制器、服务层各个地方，后期维护成本很高。Eloquent Attribute Business Process States可以将状态相关的逻辑封装在Eloquent模型的属性中，让状态管理更规范、更集中。

基础状态定义实现

首先我们需要在Eloquent模型中定义业务流程状态，通常会用一个常量数组来维护所有合法的状态值，同时定义当前状态的访问器。

<?php

namespace AppModels;

use IlluminateDatabaseEloquentModel;

class Order extends Model
{
    // 定义订单业务流程的所有合法状态
    const STATUS_PENDING = 'pending';
    const STATUS_PAID = 'paid';
    const STATUS_SHIPPED = 'shipped';
    const STATUS_COMPLETED = 'completed';
    const STATUS_CANCELED = 'canceled';

    // 所有状态的映射关系，方便展示
    public static $statusMap = [
        self::STATUS_PENDING => '待支付',
        self::STATUS_PAID => '已支付',
        self::STATUS_SHIPPED => '已发货',
        self::STATUS_COMPLETED => '已完成',
        self::STATUS_CANCELED => '已取消',
    ];

    // 状态字段
    protected $fillable = ['status'];

    // 状态访问器，返回状态对应的中文名称
    public function getStatusNameAttribute()
    {
        return self::$statusMap[$this->status] ?? '未知状态';
    }
}

状态流转规则封装

业务流程状态不是随意变更的，比如已完成的订单不能再改为待支付状态，我们需要封装状态流转的校验逻辑，确保状态变更符合业务规则。

<?php

namespace AppModels;

use IlluminateDatabaseEloquentModel;
use Exception;

class Order extends Model
{
    // 前面的常量和属性定义省略

    // 定义状态流转规则，键是原状态，值是允许变更的目标状态数组
    public static $statusTransitions = [
        self::STATUS_PENDING => [self::STATUS_PAID, self::STATUS_CANCELED],
        self::STATUS_PAID => [self::STATUS_SHIPPED, self::STATUS_CANCELED],
        self::STATUS_SHIPPED => [self::STATUS_COMPLETED],
        self::STATUS_COMPLETED => [],
        self::STATUS_CANCELED => [],
    ];

    // 校验状态是否可以流转
    public function canTransitionTo($targetStatus)
    {
        // 先检查目标状态是否合法
        if (!in_array($targetStatus, array_keys(self::$statusMap))) {
            return false;
        }
        // 检查当前状态是否允许流转到目标状态
        $allowedTransitions = self::$statusTransitions[$this->status] ?? [];
        return in_array($targetStatus, $allowedTransitions);
    }

    // 执行状态流转
    public function transitionTo($targetStatus)
    {
        if (!$this->canTransitionTo($targetStatus)) {
            throw new Exception('非法的状态流转：从' . $this->status_name . '到' . self::$statusMap[$targetStatus]);
        }
        $this->status = $targetStatus;
        return $this->save();
    }
}

实际业务场景应用

定义好状态和流转规则后，我们可以在业务逻辑中直接使用，比如订单支付成功后变更状态，发货时变更状态等。

<?php

namespace AppServices;

use AppModelsOrder;
use Exception;

class OrderService
{
    // 处理订单支付成功逻辑
    public function handlePaid(Order $order)
    {
        try {
            // 将订单状态从待支付流转为已支付
            $order->transitionTo(Order::STATUS_PAID);
            // 后续支付成功后的其他业务逻辑，比如发送通知
            return true;
        } catch (Exception $e) {
            // 处理状态流转异常
            return false;
        }
    }

    // 处理订单发货逻辑
    public function handleShipped(Order $order)
    {
        try {
            $order->transitionTo(Order::STATUS_SHIPPED);
            // 发货后的其他逻辑，比如更新物流信息
            return true;
        } catch (Exception $e) {
            return false;
        }
    }
}

状态查询扩展

有时候我们需要根据状态查询对应的模型数据，可以给模型添加状态相关的查询作用域，方便快速筛选。

<?php

namespace AppModels;

use IlluminateDatabaseEloquentModel;
use IlluminateDatabaseEloquentBuilder;

class Order extends Model
{
    // 前面的定义省略

    // 查询指定状态的订单
    public function scopeWhereStatus(Builder $query, $status)
    {
        return $query->where('status', $status);
    }

    // 查询待处理的订单（待支付和已支付未发货）
    public function scopeWherePendingProcess(Builder $query)
    {
        return $query->whereIn('status', [self::STATUS_PENDING, self::STATUS_PAID]);
    }
}

通过上述实现，我们就完成了Eloquent Attribute Business Process States的核心功能，所有状态相关的逻辑都封装在Order模型中，业务层只需要调用transitionTo方法即可完成状态变更，同时自动校验流转合法性，大大降低了状态管理的复杂度。如果后续需要新增状态或者调整流转规则，只需要修改模型中的状态定义和流转规则数组即可，不需要改动大量业务代码。

PHPEloquent_Attribute_Business_Process_StatesLaravel工作流建模修改时间：2026-07-21 20:03:30