mrlee/MrleeAdmin

Fork 0

Files

T

mrlee 663f74b633 初始化本地仓库

2026-08-31 11:33:59 +08:00

3.2 KiB

Raw Blame History

name, description, globs

name

description

globs

backend-gen-service

Generate Service class. Only needs DAO injection in constructor. BaseService __call method auto-delegates to DAO.

app/service/admin/**/*.php

plugin/**/app/service/admin/**/*.php

Service 生成规范

原则

Service 只需注入 DAO，其他方法全部由 BaseService::__call 自动代理到 DAO！

当前项目真实约定补充：

必须显式导入 use core\base\BaseService;，不能只写 extends BaseService。
必须在构造函数中注入 DAO，例如 __construct(FooDao $dao)。
不要在 Service 内部手动 new FooDao()，避免与容器注入和项目真实风格不一致。

class {Model}Service extends BaseService
{
    public function __construct({Model}Dao $dao)
    {
        $this->dao = $dao;
    }
}

BaseService::__call() 会自动将所有方法调用转发给 $this->dao。

文件位置

App:

app/service/admin/{module}/{Model}Service.php

Plugin:

plugin/{Plugin}/app/service/admin/{module}/{Model}Service.php

Service 模板

<?php

declare(strict_types=1);
/**
 *+------------------
 * madong
 *+------------------
 * Copyright (c) https://gitee.com/motion-code All rights reserved.
 *+------------------
 * Author: Mr. April (405784684@qq.com)
 *+------------------
 */

namespace {ns}\service\admin\{module};

use {dao_ns}\{module}\{Model}Dao;
use core\base\BaseService;

/**
 * {Model}服务层
 */
class {Model}Service extends BaseService
{
    public function __construct({Model}Dao $dao)
    {
        $this->dao = $dao;
    }
}

只有需要特殊业务逻辑时才加方法

class {Model}Service extends BaseService
{
    public function __construct({Model}Dao $dao)
    {
        $this->dao = $dao;
    }

    // 只有特殊业务逻辑才定义方法
    // 普通 CRUD 直接通过 __call 代理到 DAO
}

业务逻辑示例

/**
 * 批量操作示例
 */
public function batchAssign(array $ids, int $categoryId): void
{
    $this->transaction(function () use ($ids, $categoryId) {
        foreach ($ids as $id) {
            $item = $this->dao->get($id);
            if ($item) {
                $item->category_id = $categoryId;
                $item->save();
            }
        }
    });
}

调用示例

// Service 实例化后直接调用，__call 自动代理到 DAO
$service = new {Model}Service(new {Model}Dao());
$list = $service->selectList($where, '*', $page, $limit);  // 代理到 DAO
$item = $service->get($id);                                 // 代理到 DAO
$count = $service->count($where);                          // 代理到 DAO
$service->save($data);                                     // 代理到 DAO

BaseService 提供的方法

方法	说明
`transaction(callable)`	事务执行
`cacheDriver()`	获取缓存服务
`getPageValue()`	获取分页配置
`passwordHash()`	密码加密
`__call()`	自动代理到 DAO

生成检查清单

命名空间正确（App/Plugin）
引入 BaseService
引入 DAO 类
构造函数注入 DAO
只有特殊业务逻辑才加方法
未在 Service 内部手动 new Dao()

3.2 KiB Raw Blame History Unescape Escape