分类 PHP 下的文章

PHP 对象动态传参数(反射) / Laravel Cast 的相关使用用例

作者: Chuwen
时间: 2021-10-20
分类: Laravel,PHP
评论

## 序言

主要在用到 Laravel Cast，所以有了这个想法，暂时记录下用法，后面再慢慢解释（如果有空 哈哈哈哈）

## 代码

`MailSendLogComment.php`
```php
<?php
declare(strict_types=1);

namespace App\Casts\Manage;

class MailSendLogComment
{
    public function __construct(public string $test)
    {
    }

public function toArray(): array
    {
        return [
            'test' => $this->test
        ];
    }
}

```

`MailSendLogCommentCast.php`:
```php
<?php

namespace App\Casts\Manage;

use Illuminate\Contracts\Database\Eloquent\CastsAttributes;
use JetBrains\PhpStorm\Pure;
use ReflectionClass;

class MailSendLogCommentCast implements CastsAttributes
{
    /**
     * Cast the given value.
     *
     * @param \Illuminate\Database\Eloquent\Model $model
     * @param string                              $key
     * @param mixed                               $value
     * @param array                               $attributes
     *
     * @return mixed|object
     * @throws \ReflectionException
     */
    #[Pure]
    public function get($model, $key, $value, array $attributes)
    {
        if ($key !== 'comment') {
			// 看这里，用到了反射
            return (new ReflectionClass(MailSendLogComment::class))->newInstanceArgs(json_decode($value, true));
        }

return $value;
    }

/**
     * Prepare the given value for storage.
     *
     * @param \Illuminate\Database\Eloquent\Model $model
     * @param string                              $key
     * @param mixed                               $value
     * @param array                               $attributes
     *
     * @return array
     */
    public function set($model, $key, $value, array $attributes): array
    {
        if ($key === 'comments') {
            // 如果给的值不是 MailSendLogComment 对象就报错
            if ($value instanceof MailSendLogComment) {
                throw new InvalidArgumentException('The given value is not an ' . MailSendLogComment::class . ' instance.');
            }
            $attributes['comments'] = json_encode($value->toArray(), JSON_UNESCAPED_UNICODE);
        }

return $attributes;
    }
}

```

`MailSendLog.php`
```php
<?php

namespace App\Models;

use App\Casts\Manage\MailSendLogCommentCast;
use App\Enums\Manage\MailSendLogTypeEnum;
use Dcat\Admin\Traits\HasDateTimeFormatter;
use Illuminate\Database\Eloquent\Model;

/**
 * 邮件发送日志表
 * \App\Models\MailSendLog
 *
 * @property int                             $id
 * @property string                          $from_email 发送人邮箱
 * @property string                          $from_name  发送人名字
 * @property string                          $to_email   接收人邮箱
 * @property string                          $to_name    接收人名字
 * @property string                          $title      邮件标题
 * @property string                          $content    邮件内容
 * @property string                          $bid        顾名思义
 * @property MailSendLogCommentCast          $comments   备注，用以存放其他内容
 * @property int                             $status     0: 未发送 1: 发送成功 2: 发送失败
 * @property MailSendLogTypeEnum             $type       0: 未知发送类型，其它根据 MailSendLogTypeEnum.php 文件判断
 * @property string                          $exception  失败原因
 * @property \Illuminate\Support\Carbon|null $created_at
 * @property \Illuminate\Support\Carbon|null $updated_at
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog newModelQuery()
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog newQuery()
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog query()
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereBid($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereComments($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereContent($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereCreatedAt($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereException($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereFromEmail($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereFromName($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereId($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereStatus($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereTitle($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereToEmail($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereToName($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereType($value)
 * @method static \Illuminate\Database\Eloquent\Builder|MailSendLog whereUpdatedAt($value)
 * @mixin \Eloquent
 */
class MailSendLog extends Model
{
    use HasDateTimeFormatter;

protected $table = 'mail_send_logs';
    protected $casts = [
        'comments' => MailSendLogCommentCast::class,
        'type' => MailSendLogTypeEnum::class// 限定必须使用此枚举类型
    ];
}

```

## 用法
```php
// 查询数据
use App\Models\MailSendLog;

dump(MailSendLog::first()->comments);// 返回的是 \App\Casts\Manage\MailSendLogComment 对象

dump(MailSendLog::first()->comments->test);// 返回的是 \App\Casts\Manage\MailSendLogComment 对象 test 属性的值

// 新增数据
$M = new MailSendLog();
$M->title = '邮件标题';
$M->content = '<h1>邮件内容</h1>';
$M->comments = new MailSendLogComment('邮件备注'); //必须传入这个类型，否则将会报错
$M->exception = '错误日志';
$M->save();// 保存
```

编写 PHP 代码更优雅些 - 持续更新

作者: Chuwen
时间: 2021-09-05
分类: PHP技巧,PHP
评论

### 基础 PHP 8.0 +

#### 命名参数

```php
// PHP 7
htmlspecialchars($string, ENT_COMPAT | ENT_HTML401, 'UTF-8', false);

// PHP 8
htmlspecialchars($string, double_encode: false);
```

### 注解

> 现在可以用 PHP 原生语法来使用结构化的元数据，而非 PHPDoc 声明。

```php
// PHP 7
class PostsController
{
    /**
     * @Route("/api/posts/{id}", methods={"GET"})
     */
    public function get($id) { /* ... */ }
}

// PHP 8
class PostsController
{
    #[Route("/api/posts/{id}", methods: ["GET"])]
    public function get($id) { /* ... */ }
}
```

#### 构造器属性提升

```php
// PHP 7
class Point {
  public float $x;
  public float $y;
  public float $z;
  public function __construct(
    float $x = 0.0,
    float $y = 0.0,
    float $z = 0.0
  ) {
    $this->x = $x;
    $this->y = $y;
    $this->z = $z;
  }
}

// PHP 8
class Point {
  public function __construct(
    public float $x = 0.0,
    public float $y = 0.0,
    public float $z = 0.0,
  ) {}
}
```

#### 联合类型

> 相较于以前的 PHPDoc 声明类型的组合， 现在可以用原生支持的联合类型声明取而代之，并在运行时得到校验。

```php
// PHP 7
class Number {
  /** @var int|float */
  private $number;
  /**
   * @param float|int $number
   */
  public function __construct($number) {
    $this->number = $number;
  }
}
new Number('NaN'); // Ok

// PHP 8
class Number {
  public function __construct(
    private int|float $number
  ) {}
}
new Number('NaN'); // TypeError
```

#### Match 表达式

```php
// PHP 7
switch (8.0) {
  case '8.0':
    $result = "Oh no!";
    break;
  case 8.0:
    $result = "This is what I expected";
    break;
}
echo $result;
//> Oh no!

// PHP 8
echo match (8.0) {
  '8.0' => "Oh no!",
  8.0 => "This is what I expected",
};
//> This is what I expected
```

#### Nullsafe 运算符

```php
// PHP 7
$country =  null;
if ($session !== null) {
  $user = $session->user;
  if ($user !== null) {
    $address = $user->getAddress();
 
    if ($address !== null) {
      $country = $address->country;
    }
  }
}

// PHP 8
$country = $session?->user?->getAddress()?->country;
```

----

### 枚举
1. 使用 PHP 8.1，截止到 2021年9月4日，8.1 版本未正式发布

2. 使用扩展包实现：https://github.com/myclabs/php-enum
```shell
composer require myclabs/php-enum
```

### JSON 转 Class 使得 IDEA 语法提示

> Github: https://github.com/cweiske/jsonmapper

```shell
composer require netresearch/jsonmapper
```

### 泛型

https://github.com/mrsuh/php-generics

做个 Larvel Model 插入或更新小笔记，因为犯错比较多的

作者: Chuwen
时间: 2021-09-03
分类: Laravel,PHP
1 条评论

Laravel 验证器(Validation)验证数组及元素

作者: Chuwen
时间: 2021-08-30
分类: Laravel,PHP
评论

Laravel 迁移文件新增、修改、删除字段命名规则

作者: Chuwen
时间: 2021-08-27
分类: PHP
2 条评论

PHP 对象动态传参数(反射) / Laravel Cast 的相关使用用例

编写 PHP 代码更优雅些 - 持续更新

做个 Larvel Model 插入或更新小笔记，因为犯错比较多的

Laravel 验证器(Validation)验证数组及元素

Laravel 迁移文件新增、修改、删除字段命名规则

最新文章

最近回复

分类

归档

其它