Files
2026-11-11 14:22:02 +08:00

346 lines
7.5 KiB
PHP

<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2025 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------
declare (strict_types = 1);
namespace think;
use ArrayAccess;
use InvalidArgumentException;
use JsonSerializable;
use ReflectionClass;
use think\contract\Arrayable;
use think\contract\Jsonable;
use think\model\contract\Modelable;
use WeakMap;
/**
* Class Entity.
* @mixin Model
*/
abstract class Entity implements JsonSerializable, ArrayAccess, Arrayable, Jsonable, Modelable
{
private static ?WeakMap $weakMap = null;
/**
* 架构函数.
*
* @param Model $model 模型连接对象
*/
public function __construct(?Model $model = null)
{
$this->initWeakMap();
// 获取实体模型参数
$baseOptions = $this->getBaseOptions();
$options = $this->getOptions();
foreach (['viewMapping', 'autoMapping'] as $item) {
$options[$item] = array_merge($baseOptions[$item] ?? [], $options[$item] ?? []);
}
$options = array_merge($baseOptions, $options);
if (is_null($model)) {
$class = !empty($options['modelClass']) ? $options['modelClass'] : str_replace('\\entity\\', '\\model\\', static::class);
$model = new $class();
}
$model->entity($this);
self::$weakMap[$this] = [
'model' => $model,
];
// 初始化模型
$this->setOptions($options);
$this->init($options);
}
protected function initWeakMap()
{
if (!self::$weakMap) {
self::$weakMap = new WeakMap;
}
}
/**
* 定义实体模型的基础配置参数.
*
* @return array
*/
protected function getBaseOptions(): array
{
return [];
}
/**
* 定义实体模型相关配置参数.
*
* @return array
*/
protected function getOptions(): array
{
return [];
}
/**
* 批量设置模型参数
* @param array $options 值
* @return void
*/
public function setOptions(array $options): void
{
foreach ($options as $name => $value) {
$this->setOption($name, $value);
}
}
/**
* 设置模型参数
*
* @param string $name 参数名
* @param mixed $value 值
*
* @return $this
*/
public function setOption(string $name, $value)
{
self::$weakMap[$this][$name] = $value;
return $this;
}
/**
* 获取模型参数
*
* @param string $name 参数名
* @param mixed $default 默认值
*
* @return mixed
*/
public function getOption(string $name, $default = null)
{
return self::$weakMap[$this][$name] ?? $default;
}
/**
* 创建新的实例.
*
* @param Model $model 模型连接对象
* @param array $options 查询参数
*/
public function newInstance(?Model $model, array $options = [])
{
$entity = new static();
return $entity->setModel($model, $options);
}
/**
* 初始化模型.
*
* @param array $options 模型参数
* @return void
*/
protected function init(array $options = []): void {}
/**
* 获取模型对象实例.
* @return Model
*/
public function model()
{
return self::$weakMap[$this]['model'];
}
/**
* 设置模型.
*
* @param Model $model 模型对象
* @return $this
*/
public function setModel(Model $model)
{
self::$weakMap[$this]['model'] = $model;
return $this;
}
/**
* 获取克隆的模型实例.
*
* @return static
*/
public function clone()
{
$model = new static();
self::$weakMap[$model] = self::$weakMap[$this];
return $model;
}
/**
* 克隆模型实例
*
* @return void
*/
public function __clone()
{
throw new InvalidArgumentException('use $modelObj->clone() replace clone $modelObj');
}
/**
* 序列化模型对象
*
* @return array
*/
public function __serialize(): array
{
return array_diff_key(self::$weakMap[$this]);
}
/**
* 反序列化模型对象
*
* @param array $data
* @return void
*/
public function __unserialize(array $data)
{
$this->initWeakMap();
self::$weakMap[$this] = $data;
}
/**
* 获取属性 支持获取器
*
* @param string $name 名称
*
* @return mixed
*/
public function __get(string $name)
{
return $this->model()->get($name);
}
/**
* 设置数据 支持类型自动转换
*
* @param string $name 名称
* @param mixed $value 值
*
* @return void
*/
public function __set(string $name, $value): void
{
$this->model()->set($name, $value);
}
/**
* 检测数据对象的值
*
* @param string $name 名称
*
* @return bool
*/
public function __isset(string $name): bool
{
return $this->model()->__isset($name);
}
/**
* 销毁数据对象的值
*
* @param string $name 名称
*
* @return void
*/
public function __unset(string $name): void
{
$this->model()->__unset($name);
}
public function __toString()
{
return $this->model()->toJson();
}
public function __debugInfo()
{
return $this->model()->getData();
}
// JsonSerializable
public function jsonSerialize(): array
{
return $this->model()->toArray();
}
/**
* 模型数据转数组.
*
* @return array
*/
public function toArray(): array
{
return $this->model()->toArray();
}
/**
* 模型数据转Json.
*
* @param int $options json参数
* @return string
*/
public function toJson(int $options = JSON_UNESCAPED_UNICODE): string
{
return $this->model()->toJson($options);
}
// ArrayAccess
public function offsetSet(mixed $name, mixed $value): void
{
$this->__set($name, $value);
}
public function offsetGet(mixed $name): mixed
{
return $this->__get($name);
}
public function offsetExists(mixed $name): bool
{
return $this->__isset($name);
}
public function offsetUnset(mixed $name): void
{
$this->__unset($name);
}
public static function __callStatic($method, $args)
{
$entity = new static();
if (in_array($method, ['destroy', 'create', 'update', 'saveAll'])) {
// 调用model的静态方法
$db = $entity->model();
} else {
// 调用Query类查询方法
$db = $entity->model()->db();
}
return call_user_func_array([$db, $method], $args);
}
public function __call($method, $args)
{
// 调用Model类方法
return call_user_func_array([$this->model(), $method], $args);
}
}