CRMEB/backend/crmeb/traits/ServiceTrait.php
2026-09-23 15:15:02 +08:00

72 lines
2.1 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
// +----------------------------------------------------------------------
// | CRMEB [ CRMEB赋能开发者,助力企业发展 ]
// +----------------------------------------------------------------------
// | Copyright (c) 2016~2026 https://www.crmeb.com All rights reserved.
// +----------------------------------------------------------------------
// | Licensed CRMEB并不是自由软件,未经许可不能去掉CRMEB相关版权
// +----------------------------------------------------------------------
// | Author: CRMEB Team <admin@crmeb.com>
// +----------------------------------------------------------------------
declare(strict_types=1);
namespace crmeb\traits;
/**
* 服务复用 Trait
* 提供通用的服务层辅助方法
* Trait ServiceTrait
* @package crmeb\traits
*/
trait ServiceTrait
{
/**
* 事务处理
* @param callable $callback
* @return mixed
* @throws \Throwable
*/
protected function transaction(callable $callback)
{
return \think\facade\Db::transaction($callback);
}
/**
* 获取请求参数
* @param array $field 需要获取的字段
* @param bool $must 是否必须
* @return array
*/
protected function requestParams(array $field, bool $must = false): array
{
$data = [];
foreach ($field as $k => $v) {
if (is_numeric($k)) {
$key = $v;
$default = null;
} else {
$key = $k;
$default = $v;
}
$value = request()->param($key, $default);
if ($must && is_null($value)) {
throw new \think\exception\ValidateException("参数 {$key} 不能为空");
}
$data[$key] = $value;
}
return $data;
}
/**
* 获取分页参数
* @return array{page: int, limit: int}
*/
protected function getPage(): array
{
$page = (int)request()->param('page', 1);
$limit = (int)request()->param('limit', 10);
$limit = min($limit, 100); // 最大100条
return compact('page', 'limit');
}
}