- 按 docs/renew-code-comment.md 将 PHP 文件头改为带边框的 Author 注释\n- 注释中的 crmeb.com 替换为 uj345.cn(代码字符串中的外链未改)\n- 新增 docs/renew-code-comment.md 说明 Made-with: Cursor
242 lines
4.7 KiB
PHP
242 lines
4.7 KiB
PHP
<?php
|
|
// +----------------------------------------------------------------------
|
|
// | Author: ScottPan Team
|
|
// +----------------------------------------------------------------------
|
|
|
|
namespace crmeb\services\wechat\message;
|
|
|
|
|
|
use crmeb\services\wechat\WechatException;
|
|
use EasyWeChat\Kernel\Support\Arr;
|
|
use think\helper\Str;
|
|
|
|
trait HasAttributes
|
|
{
|
|
/**
|
|
* @var array
|
|
*/
|
|
protected array $attributes = [];
|
|
|
|
/**
|
|
* @var bool
|
|
*/
|
|
protected bool $snakeable = true;
|
|
|
|
/**
|
|
* Set Attributes.
|
|
*
|
|
* @param array $attributes
|
|
*
|
|
* @return HasAttributes
|
|
*/
|
|
public function setAttributes(array $attributes = []): self
|
|
{
|
|
$this->attributes = $attributes;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Set attribute.
|
|
*
|
|
* @param string $attribute
|
|
* @param string $value
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function setAttribute(string $attribute, string $value)
|
|
{
|
|
Arr::set($this->attributes, $attribute, $value);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get attribute.
|
|
*
|
|
* @param string $attribute
|
|
* @param mixed|null $default
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function getAttribute(string $attribute, mixed $default = null)
|
|
{
|
|
return Arr::get($this->attributes, $attribute, $default);
|
|
}
|
|
|
|
/**
|
|
* @param string $attribute
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function isRequired(string $attribute)
|
|
{
|
|
return in_array($attribute, $this->getRequired(), true);
|
|
}
|
|
|
|
/**
|
|
* @return array|mixed
|
|
*/
|
|
public function getRequired(): mixed
|
|
{
|
|
return property_exists($this, 'required') ? $this->required : [];
|
|
}
|
|
|
|
/**
|
|
* Set attribute.
|
|
*
|
|
* @param string $attribute
|
|
* @param mixed $value
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function with(string $attribute, mixed $value)
|
|
{
|
|
$this->snakeable && $attribute = Str::snake($attribute);
|
|
|
|
$this->setAttribute($attribute, $value);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Override parent set() method.
|
|
*
|
|
* @param string $attribute
|
|
* @param mixed $value
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function set(string $attribute, mixed $value)
|
|
{
|
|
$this->setAttribute($attribute, $value);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Override parent get() method.
|
|
*
|
|
* @param string $attribute
|
|
* @param mixed|null $default
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function get(string $attribute, mixed $default = null)
|
|
{
|
|
return $this->getAttribute($attribute, $default);
|
|
}
|
|
|
|
/**
|
|
* @param string $key
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function has(string $key)
|
|
{
|
|
return Arr::has($this->attributes, $key);
|
|
}
|
|
|
|
/**
|
|
* @param array $attributes
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function merge(array $attributes)
|
|
{
|
|
$this->attributes = array_merge($this->attributes, $attributes);
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @param array|string $keys
|
|
*
|
|
* @return array
|
|
*/
|
|
public function only(array|string $keys)
|
|
{
|
|
return array_intersect_key($this->attributes, array_flip((array)$keys));
|
|
}
|
|
|
|
/**
|
|
* Return all items.
|
|
*
|
|
* @return array
|
|
*
|
|
*/
|
|
public function all()
|
|
{
|
|
$this->checkRequiredAttributes();
|
|
|
|
return $this->attributes;
|
|
}
|
|
|
|
/**
|
|
* Magic call.
|
|
*
|
|
* @param string $method
|
|
* @param array $args
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function __call($method, $args)
|
|
{
|
|
if (0 === stripos($method, 'with')) {
|
|
return $this->with(substr($method, 4), array_shift($args));
|
|
}
|
|
|
|
throw new \BadMethodCallException(sprintf('Method "%s" does not exists.', $method));
|
|
}
|
|
|
|
/**
|
|
* Magic get.
|
|
*
|
|
* @param string $property
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function __get($property)
|
|
{
|
|
return $this->get($property);
|
|
}
|
|
|
|
/**
|
|
* Magic set.
|
|
*
|
|
* @param string $property
|
|
* @param mixed $value
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function __set($property, $value)
|
|
{
|
|
return $this->with($property, $value);
|
|
}
|
|
|
|
/**
|
|
* Whether or not an data exists by key.
|
|
*
|
|
* @param string $key
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function __isset($key)
|
|
{
|
|
return isset($this->attributes[$key]);
|
|
}
|
|
|
|
/**
|
|
* Check required attributes.
|
|
*
|
|
*/
|
|
protected function checkRequiredAttributes()
|
|
{
|
|
foreach ($this->getRequired() as $attribute) {
|
|
if (is_null($this->get($attribute))) {
|
|
throw new WechatException(sprintf('"%s" cannot be empty.', $attribute));
|
|
}
|
|
}
|
|
}
|
|
}
|