$subQuery = DB::table('t1')->where('c1', 'xxx')->where('c2', xxx)->groupBy('c1');
$query = DB::table(DB::raw("({$subQuery->toSql()}) as sub"))
    ->select(['*'])
    ->where('c1', 'xxx')
    ->where('c2', 'xxx');
    ->mergeBindings($subQuery)
    ->get();

$subQuery = DB::table('t2')->groupBy('c1', 'c2');
$query = DB::table('t1')
    ->select(['t1.*', 'sub.c4'])
    ->leftJoin(DB::raw("({subQuery->toSql()}) as sub"), function ($join) {
        /** @var JoinClause $join */
        $join->on('t1.c1', '=', 't2.c1')
            ->on('t1.c2', '=', 't2.c2');
    })
    ->mergeBindings($subQuery)
    ->get();

namespace App\Models\Sys;

use App\Models\Model;
use Illuminate\Notifications\Notifiable;

class User extends Model
{
    use Notifiable;

    protected $table = 'user';
    
    /**
     * 用户接收广播通知的通道.
     *
     * @return mixed
     */
    public function receivesBroadcastNotificationsOn()
    {
        return 'user.' . $this->id;
    }

}

namespace App\Models\Common;

use App\Models\Model;
use App\Models\Sys\User;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\MorphTo;

class Comment extends Model
{
    protected $table = 'comment';

    protected $fillable = [
        'content', 'uid', 'commentable_id', 'commentable_type'
    ];

    protected $with = [
        'user'
    ];

    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class, 'uid');
    }

    public function commentable(): MorphTo
    {
        return $this->morphTo();
    }
}

namespace App\Observers;

use App\Models\Common\Comment;
use App\Notifications\CommentCreated;

class CommentObserver extends Observer
{
    /**
     * Handle the User "created" event.
     *
     * @param Comment $comment
     * @return void
     */
    public function created(Comment $comment)
    {
        event(new CommentCreated($comment));
    }
}

namespace App\Providers;

use App\Models\Common\Comment;
use App\Observers\CommentObserver;

use Illuminate\Support\ServiceProvider;


class AppServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
        //
    }

    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        Comment::observe(CommentObserver::class);
    }
}

namespace App\Events;

use App\Models\Common\Comment;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

class CommentCreated
{
    use Dispatchable, SerializesModels;

    /**
     * @var Comment
     */
    public $comment;

    /**
     * Create a new event instance.
     *
     * @param $comment
     */
    public function __construct($comment)
    {
        $this->comment = $comment;
    }
}

namespace App\Listeners;

use App\Events\CommentCreated as CommentCreatedEvent;
use App\Models\Gs\IssueLog;
use App\Models\Sys\User;
use App\Notifications\CommentCreated;

class NotifyComment extends Listener
{
    /**
     * Handle the notification.
     *
     * @param CommentCreatedEvent $event
     */
    public function handle(CommentCreatedEvent $event)
    {
        // 相关用户
        $users = [];
        if ($event->comment->commentable instanceof IssueLog) {
            // 工单跟进者
            $user[$event->comment->commentable->user->id] = $event->comment->commentable->user;
            // 工单创建者
            $user[$event->comment->commentable->creator->id] = $event->comment->commentable->creator;
            // 工单报表评论者
            foreach ($event->comment->commentable->comments as $cmt) {
                $users[$cmt->user->id] = $users[$cmt->user->id] ?? $cmt->user;
            }
        }

        // 发送通知
        foreach ($users as $user) {
            /** @var User $user */
            if ($user->id != $event->comment->uid) {
                $user->notify(new CommentCreated($event->comment));
            }
        }
    }
}

namespace App\Notifications;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use App\Models\Common\Comment;
use \Illuminate\Notifications\Notification

class CommentCreated extends BaseNotification implements ShouldQueue
{
    use Queueable;

    protected $comment;

    /**
     * Get the notification's delivery channels.
     *
     * @return array
     */
    public function via()
    {
        return ['broadcast', 'database'];
    }

    /**
     * Create a new notification instance.
     *
     * @param Comment $comment
     */
    public function __construct(Comment $comment)
    {
        $this->comment = $comment;
    }

    /**
     * Get the array representation of the notification.
     *
     * @return array
     */
    public function toArray()
    {
        return [
            'commentable' => $this->comment->commentable,
            'commentable_type' => get_class($this->comment->commentable),
            'comment' => $this->comment
        ];
    }
}

composer require ramsey/uuid;

use Ramsey\Uuid\Uuid;

$uuid = Uuid::uuid6();

$uuid->toString(); // 36位字符串
$uuid->getByte(); // 16位字节型

public static function uuid6(?Hexadecimal $node = null, ?int $clockSeq = null): UuidInterface 
{
    return self::getFactory()->uuid6($node, $clockSeq);
}

public function generate($node = null, ?int $clockSeq = null): string
{
    if ($node instanceof Hexadecimal) {
        $node = $node->toString();
    }

    $node = $this->getValidNode($node);

    if ($clockSeq === null) {
        try {
            // This does not use "stable storage"; see RFC 4122, Section 4.2.1.1.
            $clockSeq = random_int(0, 0x3fff);
        } catch (Throwable $exception) {
            throw new RandomSourceException(
                $exception->getMessage(),
                (int) $exception->getCode(),
                $exception
            );
        }
    }

    $time = $this->timeProvider->getTime();

    $uuidTime = $this->timeConverter->calculateTime(
        $time->getSeconds()->toString(),
        $time->getMicroseconds()->toString()
    );

    $timeHex = str_pad($uuidTime->toString(), 16, '0', STR_PAD_LEFT);

    if (strlen($timeHex) !== 16) {
        throw new TimeSourceException(sprintf(
            'The generated time of \'%s\' is larger than expected',
            $timeHex
        ));
    }

    $timeBytes = (string) hex2bin($timeHex);

    return $timeBytes[4] . $timeBytes[5] . $timeBytes[6] . $timeBytes[7]
        . $timeBytes[2] . $timeBytes[3]
        . $timeBytes[0] . $timeBytes[1]
        . pack('n*', $clockSeq)
        . $node;
}

/**
 * Uses the node provider given when constructing this instance to get
 * the node ID (usually a MAC address)
 *
 * @param string|int|null $node A node value that may be used to override the node provider
 *
 * @return string 6-byte binary string representation of the node
 *
 * @throws InvalidArgumentException
 */
private function getValidNode($node): string
{
    if ($node === null) {
        $node = $this->nodeProvider->getNode();
    }

    // Convert the node to hex, if it is still an integer.
    if (is_int($node)) {
        $node = dechex($node);
    }

    if (!ctype_xdigit((string) $node) || strlen((string) $node) > 12) {
        throw new InvalidArgumentException('Invalid node value');
    }

    return (string) hex2bin(str_pad((string) $node, 12, '0', STR_PAD_LEFT));
}

/**
 * Returns a node provider configured for this environment
 */
private function buildNodeProvider(): NodeProviderInterface
{
    if ($this->ignoreSystemNode) {
        return new RandomNodeProvider();
    }

    return new FallbackNodeProvider(new NodeProviderCollection([
        new SystemNodeProvider(),
        new RandomNodeProvider(),
    ]));
}

<?php

namespace App\Http\Middleware;

use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Laravel\Telescope\Watchers\RequestWatcher;
use Ramsey\Uuid\Uuid;

class AppendRequestId
{
    /**
     * 为请求分配一个ID
     *
     * @param  \Illuminate\Http\Request  $request
     * @param \Closure $next
     * @return mixed
     */
    public function handle(Request $request, \Closure $next)
    {
        $uuid = Uuid::uuid6()->toString();
        $request->headers->set('X-Request-ID', $uuid);

        /** @var Response $response */
        $response = $next($request);

        $response->headers->set('X-Request-ID', $uuid);

        if ($response instanceof JsonResponse) {
            $response->setData(tap($response->getData(), function ($data) use ($uuid) {
                $data->request_id = $uuid;
            }));
        }

        return $response;
    }
}

<?php

namespace App\Providers;

use App\Models\System\Admin;
use Illuminate\Support\Facades\Gate;
use Laravel\Telescope\IncomingEntry;
use Laravel\Telescope\Telescope;
use Laravel\Telescope\TelescopeApplicationServiceProvider;

class TelescopeServiceProvider extends TelescopeApplicationServiceProvider
{
    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
        // ...

        Telescope::tag(function (IncomingEntry $entry) {
            if ($entry->type === 'request' && $requestId = request()->headers->get('x-request-id', null)) {
                return [$requestId];
            }
            return [];
        });
    }

    // ...

<?php

namespace App\Library\Database\Query\Grammars;

use Illuminate\Database\Query\Grammars\MySqlGrammar as Grammar;
use App\Library\Database\Query\MySqlBuilder as Builder;

class MySqlGrammar extends Grammar
{
    /**
     * Compile a replace into statement into SQL.
     *
     * @link https://dev.mysql.com/doc/refman/5.5/en/replace.html
     *
     * @param  \App\Library\Database\Query\MySqlBuilder $query
     * @param  array $values
     * @return string
     */
    public function compileReplace(Builder $query, array $values)
    {
        // Essentially we will force every insert to be treated as a batch insert which
        // simply makes creating the SQL easier for us since we can utilize the same
        // basic routine regardless of an amount of records given to us to insert.
        $table = $this->wrapTable($query->from);

        if (!is_array(reset($values))) {
            $values = [$values];
        }

        $columns = $this->columnize(array_keys(reset($values)));

        // We need to build a list of parameter place-holders of values that are bound
        // to the query. Each insert should have the exact same amount of parameter
        // bindings so we will loop through the record and parameterize them all.
        $parameters = [];

        foreach ($values as $record) {
            $parameters[] = '(' . $this->parameterize($record) . ')';
        }

        $parameters = implode(', ', $parameters);

        return "REPLACE INTO $table ($columns) VALUES $parameters";
    }

    /**
     * Compile an insert ignore statement into SQL.
     *
     * @link https://dev.mysql.com/doc/refman/5.5/en/insert.html
     *
     * @param  \App\Library\Database\Query\MySqlBuilder $query
     * @param  array $values
     * @return string
     */
    public function compileInsertIgnore(Builder $query, array $values)
    {
        // Essentially we will force every insert to be treated as a batch insert which
        // simply makes creating the SQL easier for us since we can utilize the same
        // basic routine regardless of an amount of records given to us to insert.
        $table = $this->wrapTable($query->from);

        if (!is_array(reset($values))) {
            $values = [$values];
        }

        $columns = $this->columnize(array_keys(reset($values)));

        // We need to build a list of parameter place-holders of values that are bound
        // to the query. Each insert should have the exact same amount of parameter
        // bindings so we will loop through the record and parameterize them all.
        $parameters = [];

        foreach ($values as $record) {
            $parameters[] = '(' . $this->parameterize($record) . ')';
        }

        $parameters = implode(', ', $parameters);

        return "INSERT IGNORE INTO $table ($columns) VALUES $parameters";
    }

    /**
     * Compile an insert update statement into SQL.
     *
     * @link https://dev.mysql.com/doc/refman/8.0/en/insert-on-duplicate.html
     * @link https://gist.github.com/RuGa/5354e44883c7651fd15c
     *
     * @param  \App\Library\Database\Query\MySqlBuilder $query
     * @param  array $values
     * @return string
     */
    public function compileInsertUpdate(Builder $query, array $values)
    {
        // Essentially we will force every insert to be treated as a batch insert which
        // simply makes creating the SQL easier for us since we can utilize the same
        // basic routine regardless of an amount of records given to us to insert.
        $table = $this->wrapTable($query->from);

        $columnNames = array_keys(reset($values));

        $columns = $this->columnize($columnNames);

        $parameters = implode(',', array_map(function ($row) {
            return '(' . $this->parameterize($row) . ')';
        }, $values));

        $updates = implode(',', array_map(function ($columnName) {
            return $this->wrap($columnName) . ' = VALUES(' . $this->wrap($columnName) . ')';
        }, $columnNames));

        return "INSERT INTO $table ($columns) VALUES $parameters ON DUPLICATE KEY UPDATE $updates";
    }
}

<?php

namespace App\Library\Database\Query;

use Illuminate\Database\Query\Builder as QueryBuilder;

class MySqlBuilder extends QueryBuilder
{
    /**
     * The database query grammar instance.
     *
     * @var Grammars\MySqlGrammar
     */
    public $grammar;

    /**
     * Insert a new record into the database, replace on primary key conflict.
     *
     * @param  array $values
     * @return bool
     */
    public function replace(array $values)
    {
        if (empty($values)) {
            return true;
        }

        // Since every insert gets treated like a batch insert, we will make sure the
        // bindings are structured in a way that is convenient for building these
        // inserts statements by verifying the elements are actually an array.
        if (!is_array(reset($values))) {
            $values = [$values];
        }

        // Since every insert gets treated like a batch insert, we will make sure the
        // bindings are structured in a way that is convenient for building these
        // inserts statements by verifying the elements are actually an array.
        else {
            foreach ($values as $key => $value) {
                ksort($value);
                $values[$key] = $value;
            }
        }

        // We'll treat every insert like a batch insert so we can easily insert each
        // of the records into the database consistently. This will make it much
        // easier on the grammars to just handle one type of record insertion.
        $bindings = [];

        foreach ($values as $record) {
            foreach ($record as $value) {
                $bindings[] = $value;
            }
        }

        $sql = $this->grammar->compileReplace($this, $values);

        // Once we have compiled the insert statement's SQL we can execute it on the
        // connection and return a result as a boolean success indicator as that
        // is the same type of result returned by the raw connection instance.
        $bindings = $this->cleanBindings($bindings);

        return $this->connection->insert($sql, $bindings);
    }

    /**
     * Insert a new record into the database, update on primary key conflict.
     *
     * @param  array $values
     * @return bool
     */
    public function insertUpdate(array $values)
    {
        if (empty($values)) {
            return true;
        }

        // Since every insert gets treated like a batch insert, we will make sure the
        // bindings are structured in a way that is convenient for building these
        // inserts statements by verifying the elements are actually an array.
        if (!is_array(reset($values))) {
            $values = [$values];
        } // Sort the keys in each row alphabetically for consistency
        else {
            foreach ($values as $key => $value) {
                ksort($value);
                $values[$key] = $value;
            }
        }

        // We'll treat every insert like a batch insert so we can easily insert each
        // of the records into the database consistently. This will make it much
        // easier on the grammars to just handle one type of record insertion.
        $bindings = [];

        foreach ($values as $record) {
            foreach ($record as $value) {
                $bindings[] = $value;
            }
        }

        $sql = $this->grammar->compileInsertUpdate($this, $values);

        // Once we have compiled the insert statement's SQL we can execute it on the
        // connection and return a result as a boolean success indicator as that
        // is the same type of result returned by the raw connection instance.

        $bindings = $this->cleanBindings($bindings);

        return $this->connection->insert($sql, $bindings);
    }

    /**
     * Insert a new record into the database, discard on primary key conflict.
     *
     * @param  array $values
     * @return bool
     */
    public function insertIgnore(array $values)
    {
        if (empty($values)) {
            return true;
        }

        // Since every insert gets treated like a batch insert, we will make sure the
        // bindings are structured in a way that is convenient for building these
        // inserts statements by verifying the elements are actually an array.
        if (!is_array(reset($values))) {
            $values = [$values];
        }

        // Since every insert gets treated like a batch insert, we will make sure the
        // bindings are structured in a way that is convenient for building these
        // inserts statements by verifying the elements are actually an array.
        else {
            foreach ($values as $key => $value) {
                ksort($value);
                $values[$key] = $value;
            }
        }
        
        // We'll treat every insert like a batch insert so we can easily insert each
        // of the records into the database consistently. This will make it much
        // easier on the grammars to just handle one type of record insertion.
        $bindings = [];

        foreach ($values as $record) {
            foreach ($record as $value) {
                $bindings[] = $value;
            }
        }

        $sql = $this->grammar->compileInsertIgnore($this, $values);

        // Once we have compiled the insert statement's SQL we can execute it on the
        // connection and return a result as a boolean success indicator as that
        // is the same type of result returned by the raw connection instance.

        $bindings = $this->cleanBindings($bindings);

        return $this->connection->insert($sql, $bindings);
    }
}

:::

<?php

namespace App\Library\Database;

use App\Library\Database\Query\MySqlBuilder as Builder;
use App\Library\Database\Query\Grammars\MySqlGrammar as QueryGrammar;
use Illuminate\Database\MySqlConnection as Connection;


class MySqlConnection extends Connection
{
    /**
     * Get the default query grammar instance.
     *
     * @return \Illuminate\Database\Grammar|\Illuminate\Database\Query\Grammars\MySqlGrammar
     */
    protected function getDefaultQueryGrammar()
    {
        return $this->withTablePrefix(new QueryGrammar);
    }

    /**
     * Get a new query builder instance.
     *
     * @return \App\Library\Database\Query\MySqlBuilder
     */
    public function query()
    {
        return new Builder(
            $this, $this->getQueryGrammar(), $this->getPostProcessor()
        );
    }
}

<?php

namespace App\Providers;

use App\Library\Database\MySqlConnection;
use Illuminate\Support\ServiceProvider;

class DatabaseServiceProvider extends ServiceProvider
{
    /**
     * Override the default connection for MySQL. This allows us to use `replace` etc.
     *
     * @link https://stidges.com/extending-the-connection-class-in-laravel
     * @link https://gist.github.com/VinceG/0fb570925748ab35bc53f2a798cb517c
     *
     * @return void
     */
    public function boot()
    {
        Connection::resolverFor('mysql', function ($connection, $database, $prefix, $config) {
            return new MySqlConnection($connection, $database, $prefix, $config);
        }); // 5.4及以上版本使用此方式绑定
    }

    /**
     * Register the service provider.
     *
     * @return void
     */
    public function register()
    {
        $this->app->bind('db.connection.mysql', MySqlConnection::class); // 5.4版本以下使用此方式绑定
    }
}

'providers' => [
    // 其他的服务提供者

    App\Providers\AppServiceProvider::class,
],

// 扩展的查询语法：Replace、InsertIgnore、InsertUpdate
$app->register(App\Providers\DatabaseServiceProvider::class);

return $app;

$data = [
    'name' => 'soap',
    'status' => 'kia'
];
\DB::connection('cod8')->table('141_members')->insertUpdate($data);

composer require bensampo/laravel-enum

composer require tencentcloud/tencentcloud-sdk-php

<?php

namespace App\Contracts;

interface Sms
{
    /**
     * 发送短信
     *
     * @param $phone
     * @param $templateId
     * @param $templateParams
     * @return bool
     */
    public function send($phone, $templateId, $templateParams);

    /**
     * 批量发送短信
     *
     * @param array $phones
     * @param $templateId
     * @param $templateParams
     * @return bool
     */
    public function batchSend($phones, $templateId, $templateParams);

    /**
     * 返回余额
     *
     * @return float
     */
    public function getBalance();

    /**
     * 获取模版
     *
     * @param string $for 模板用途
     * @return int
     */
    public function getTemplateId($for);
}

<?php

namespace App\Enums;

use BenSampo\Enum\Enum;

/**
 * 短信服务商
 *
 * @method static static TENCENT()
 */
final class SmsProvider extends Enum
{
    public const TENCENT = 'tencent';

    public static function getDescription($value): string
    {
        if ($value === self::TENCENT) {
            return '腾讯';
        }

        return parent::getDescription($value);
    }
}

<?php

return [
    // 默认服务商
    'default_provider' => env('SMS_DEFAULT_PROVIDER'),

    // 各服务商配置
    'tencent' => [
        'app_id' => env('SMS_TENCENT_APP_ID'),
        'secret_id' => env('SMS_TENCENT_SECRET_ID'),
        'secret_key' => env('SMS_TENCENT_SECRET_KEY'),
        'template_ids' => [
            'captcha' => env('SMS_TENCENT_TEMPLATE_IDS_CAPTCHA'),
        ],
    ]
];

<?php

namespace App\Services\Sms;

use App\Contracts\Sms;

abstract class BaseSms implements Sms
{
    /**
     * 服务商名称
     *
     * @var string
     */
    protected $name;

    /**
     * 短信模板ID映射
     *
     * @var array
     */
    protected $templateIds;

    /**
     * 短信模板用途集合
     *
     * @var array
     */
    protected $templateUses = ['captcha'];

    /**
     * BaseSms constructor.
     */
    public function __construct()
    {
        foreach ($this->templateUses as $templateUse) {
            $this->templateIds[$templateUse] = config("system.sms.{$this->name}.template_ids.{$templateUse}}");
        }
    }

    /**
     * 获取模版
     *
     * @param $for
     * @return int|mixed|null
     * @throws \Exception
     */
    public function getTemplateId($for)
    {
        if (empty($this->templateIds[$for])) {
            throw new \Exception("{$for}短信模板不存在");
        }

        return $this->templateIds[$for];
    }
}

<?php

namespace App\Services\Sms;

use App\Enums\SmsProvider;
use TencentCloud\Common\Credential;
use TencentCloud\Common\Profile\ClientProfile;
use TencentCloud\Common\Profile\HttpProfile;
use TencentCloud\Sms\V20190711\Models\SendSmsRequest;
use TencentCloud\Sms\V20190711\Models\SmsPackagesStatisticsRequest;
use TencentCloud\Sms\V20190711\SmsClient;

class TencentSms extends BaseSms
{
    protected $appId;

    protected $secretId;

    protected $secretKey;

    /**
     * TencentSMS constructor.
     */
    public function __construct()
    {
        $this->name = SmsProvider::TENCENT;
        $this->appId = config('system.sms.tencent.app_id');
        $this->secretId = config('system.sms.tencent.secret_id');
        $this->secretKey = config('system.sms.tencent.secret_key');

        parent::__construct();
    }

    /**
     * 发送短信
     *
     * @param $phone
     * @param $templateId
     * @param $templateParams
     * @return bool
     */
    public function send($phone, $templateId, $templateParams)
    {
        return $this->batchSend([$phone], $templateId, $templateParams);
    }

    /**
     * 批量发送短信
     *
     * @param array $phones
     * @param $templateId
     * @param $templateParams
     * @return bool
     */
    public function batchSend($phones, $templateId, $templateParams)
    {
        // 处理参数
        $phones = is_array($phones) ? $phones : [$phones];
        $phones = array_map('addPhoneAreaCode', $phones);
        $templateParams = array_map('strval', $templateParams);

        // 实例化一个证书对象，入参需要传入腾讯云账户secretId，secretKey
        $cred = new Credential($this->secretId, $this->secretKey);

        $httpProfile = new HttpProfile();
        $httpProfile->setEndpoint("sms.tencentcloudapi.com");

        $clientProfile = new ClientProfile();
        $clientProfile->setHttpProfile($httpProfile);

        // 实例化要请求产品(以cvm为例)的client对象
        $client = new SmsClient($cred, "ap-guangzhou");

        // 实例化一个请求对象
        $req = new SendSmsRequest();
        $req->fromJsonString(json_encode([
            'PhoneNumberSet' => $phones,
            'TemplateID' => $templateId,
            'Sign' => config('system.sms.tencent.sign'),
            'TemplateParamSet' => $templateParams,
            'SmsSdkAppid' => $this->appId,
        ]));

        // 通过client对象调用想要访问的接口，需要传入请求对象
        $res = $client->SendSms($req);

        foreach ($res->SendStatusSet as $sendStatus) {
            /** @var \TencentCloud\Sms\V20190711\Models\SendStatus $sendStatus */
            if ($sendStatus->Code != 'Ok') {
                return false;
            }
        }

        return true;
    }

    /**
     * 返回余额
     *
     * @return float
     */
    public function getBalance()
    {
        $cred = new Credential($this->secretId, $this->secretKey);
        $httpProfile = new HttpProfile();
        $httpProfile->setEndpoint("sms.tencentcloudapi.com");

        $clientProfile = new ClientProfile();
        $clientProfile->setHttpProfile($httpProfile);
        $client = new SmsClient($cred, "", $clientProfile);

        $req = new SmsPackagesStatisticsRequest();
        $params = ['Limit' => 100, 'Offset' => 0, 'SmsSdkAppid' => $this->appId];
        $params = json_encode($params);
        $req->fromJsonString($params);

        $resp = $client->SmsPackagesStatistics($req);
        $smsPackagesStatisticsSet = $resp->SmsPackagesStatisticsSet;

        $maxSmsPackagesStatistics = $this->getMaxSmsPackagesStatistics($smsPackagesStatisticsSet);
        // 当前套餐包剩余使用量
        $remainingNumber = $maxSmsPackagesStatistics->AmountOfPackage - $maxSmsPackagesStatistics->CurrentUsage;
        $balance = $remainingNumber * 0.05;

        return $balance;
    }

    /**
     * 从集合中查找出剩余短信条数最大的套餐包
     *
     * @param $smsPackagesStatisticsSet
     * @return mixed | object
     */
    protected function getMaxSmsPackagesStatistics($smsPackagesStatisticsSet)
    {
        if (empty($smsPackagesStatisticsSet) || !is_array($smsPackagesStatisticsSet)) {
            return $smsPackagesStatisticsSet;
        }

        $maxRemainingNumber = 0; // 最大套餐包剩余使用量
        $maxSmsPackagesStatistics = null; // 剩余短信条数最大的套餐包
        foreach ($smsPackagesStatisticsSet as $smsPackagesStatistics) {
            // 当前套餐包剩余使用量
            $remainingNumber = $smsPackagesStatistics->AmountOfPackage - $smsPackagesStatistics->CurrentUsage;
            if ($remainingNumber >= $maxRemainingNumber) {
                $maxRemainingNumber = $remainingNumber;
                $maxSmsPackagesStatistics = $smsPackagesStatistics;
            }
        }

        return $maxSmsPackagesStatistics;
    }
}

<?php

namespace App\Providers;

use App\Contracts\Sms;
use App\Services\Sms\TencentSms
use Illuminate\Support\ServiceProvider;

class SmsServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
        //
    }

    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        $this->app->extend(Sms::class, function ($service, $app) {
            $smsProvider = config('system.sms.provider');
            if ($smsProvider === SmsProvider::TENCENT) {
                return new TencentSMS();
            }
            return new TencentSms();
        });

        $this->app->singleton(Sender::class, function ($app) {
            return new Sender($app->make(Sms::class));
        });
    }
}

<?php

namespace App\Services\Sms;

use App\Enums\SmsProvider;
use Illuminate\Support\Facades\Redis;

class Sender
{
    /**
     * @var TencentSms
     */
    protected $sms;

    public function __construct(Sms $smsProvider)
    {
        $this->smsProvider = $smsProvider;
    }

    /**
     * 发送验证码
     *
     * @template 验证码 {1}，15分钟内有效，请勿向任何人泄露。
     * @param int|string $phone
     * @param int $length 验证码长度, 范围4-6
     * @param int $ttl 有效时间(分钟)
     * @return bool
     * @throws \Exception
     */
    public function sendCaptcha($phone, $length = 4, $ttl = 15)
    {
        $captcha = substr(mt_rand(100000, 999999), 0, $length);
        $templateId = $this->sms->getTemplateId('captcha');
        Redis::setex("captcha:{$phone}", $ttl * 60, $captcha);
        return $this->sms->send($phone, $templateId, [$captcha]);
    }
}

use App\Services\Sms\Sender;

public function index(Request $request, Sender $sender)
{
    // do some work and send a message
    $sender->sendCaptcha();
}

use App\Services\Sms\Sender;

$sender = resolve(Sender::class);
$sender->sendCaptcha();

<?php

namespace App\Providers;

use App\Services\Sms\TencentSms;
use Illuminate\Contracts\Support\DeferrableProvider;
use Illuminate\Support\ServiceProvider;

class SmsServiceProvider extends ServiceProvider implements DeferrableProvider
{
    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
        $this->app->singleton(TencentSms::class, function () {
            return new TencentSms();
        });
    }

    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        //
    }

    /**
     * Get the services provided by the provider.
     *
     * @return array
     */
    public function provides()
    {
        return [TencentSms::class];
    }
}

<?php

namespace App\Services\Sms;

use App\Enums\SmsProvider;
use Illuminate\Support\Facades\Redis;

class Sender
{
    /**
     * @var TencentSms
     */
    protected $sms;

    public function __construct($smsProvider = null)
    {
        $smsProvider = $smsProvider ?: config('system.sms.default_provider');
        if ($smsProvider === SmsProvider::TENCENT) {
            $this->sms = resolve(TencentSms::class); // 获取单例
        }
    }

    /**
     * 发送验证码
     *
     * @template 验证码 {1}，15分钟内有效，请勿向任何人泄露。
     * @param int|string $phone
     * @param int $length 验证码长度, 范围4-6
     * @param int $ttl 有效时间(分钟)
     * @return bool
     * @throws \Exception
     */
    public function sendCaptcha($phone, $length = 4, $ttl = 15)
    {
        $captcha = substr(mt_rand(100000, 999999), 0, $length);
        $templateId = $this->sms->getTemplateId('captcha');
        Redis::setex("captcha:{$phone}", $ttl * 60, $captcha);
        return $this->sms->send($phone, $templateId, [$captcha]);
    }
}

use App\Enums\SmsProvider;
use App\Services\Sms\Sender;

$sender = new Sender(SmsProvider::TENCENT);
$sender->sendCaptcha();

<?php

$valid_token = '3.1415926535857'; // GitLab web hook的token
$valid_ip = ['127.0.0.1']; // GitLab服务器IP

$client_token = $_SERVER['HTTP_X_GITLAB_TOKEN'];
$client_ip = $_SERVER['REMOTE_ADDR'];

if ($client_token !== $valid_token) die('Token mismatch!');
if (!in_array($client_ip, $valid_ip)) die('Ip mismatch!');

$ouptut = [];
exec("cd /data/www/satis/; php bin/satis build satis.json ./web -v 2>&1", $output); // 创建索引的命令
var_dump($output);

/* @var \Dingo\Api\Routing\Router $api */
$api = app('Dingo\Api\Routing\Router');

$api->version('v1', function () use ($api) {
    $api->group(['middleware' => ['api', 'bindings']], function () use ($api) {
        // 系统调试日志
        $api->get('dev-logs', ['as' => 'dev-logs', 'uses' => '\Rap2hpoutre\LaravelLogViewer\LogViewerController@index', 'middleware' => ['auth']]);

        // 验证
        $api->group(['prefix' => 'auth'], function () use ($api) {
            $api->post('login', ['as' => 'auth.login', 'uses' => 'App\Http\Controllers\AuthController@login']);
            $api->get('me', ['as' => 'auth.me', 'uses' => 'App\Http\Controllers\AuthController@me']);
            $api->post('refresh', ['as' => 'auth.refresh', 'uses' => 'App\Http\Controllers\AuthController@refresh']);
            $api->post('logout', ['as' => 'auth.logout', 'uses' => 'App\Http\Controllers\AuthController@logout']);
            $api->put('reset-pwd', ['as' => 'auth.reset-pwd', 'uses' => 'App\Http\Controllers\AuthController@resetPwd']);
        });

        // 系统
        $api->group(['prefix' => 'sys'], function () use ($api) {
            // 当前用户能看到的菜单与拥有的权限(别名)
            $api->get('menu', ['as' => 'sys.menu', 'uses' => 'App\Http\Controllers\System\AdminController@menu']);

            // 系统资源
            $api->resource('permissions', 'App\Http\Controllers\System\PermissionController', ['names' => 'sys.permissions']);
            $api->resource('roles', 'App\Http\Controllers\System\RoleController', ['names' => 'sys.roles']);
            $api->resource('admins', 'App\Http\Controllers\System\AdminController', ['names' => 'sys.admins']);
        });

        ...
    });
});

class UpdateResourceFailedException extends \Dingo\Api\Exception\UpdateResourceFailedException
{
    protected $message = '更新失败';

    public function __construct($message = null, $errors = null, \Exception $previous = null, $headers = [], $code = 0) {
        $message = $message ?? $this->getMessage();
        parent::__construct($message, $errors, $previous, $headers, $code);
    }
}

class AppServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
        // 优化显示验证异常
        app('Dingo\Api\Exception\Handler')->register(function (ValidationException $exception) {
            $error = $exception->validator->errors()->first();
            throw new ValidationHttpException($error);
        });
    }

    ...

'providers' => [

    ...

    Tymon\JWTAuth\Providers\LaravelServiceProvider::class,
]

class Controller extends BaseController
{
    use AuthorizesRequests, DispatchesJobs, ValidatesRequests, Helpers;

    /**
     * Create a new AuthController instance.
     *
     * @return void
     */
    public function __construct()
    {
        if (needAuth()) { // 助手函数，开发环境不验证Token
            $this->middleware('auth:api', ['except' => ['login']]);
        }
    }
}

class AuthController extends Controller
{
    public function login(LoginRequest $request)
    {
        $credentials = $request->only(['email', 'password']);

        $auth = auth();
        if (!$token = $auth->attempt($credentials)) {
            return response()->json(['error' => 'Unauthorized', 'status_code' => 401], 401);
        }

        return $this->respondWithToken($token);
    }

    public function me()
    {
        return response()->json(auth()->user());
    }

    public function logout()
    {
        auth()->logout();

        return response()->json(['message' => 'Successfully logged out']);
    }
    
    public function refresh()
    {
        /** @noinspection PhpUndefinedMethodInspection */
        return $this->respondWithToken(auth()->refresh());
    }

    public function resetPwd(ResetPwdRequest $request)
    {
        $oldPassword = $request->get('old_password');
        $newPassword = $request->get('new_password');

        // 检查旧密码
        $admin = auth()->user();
        if (!password_verify($oldPassword, $admin->password)) {
            throw new AuthenticationException('密码错误');
        }

        // 更新密码
        $admin->update([
            'password' => password_hash($newPassword, PASSWORD_DEFAULT)
        ]);

        return success();
    }
    
    protected function respondWithToken($token)
    {
        /** @noinspection PhpUndefinedMethodInspection */
        return $this->response->array([
            'access_token' => $token,
            'token_type' => 'bearer',
            'expires_in' => auth()->factory()->getTTL() * 60
        ])->withHeader('Authorization', $token);
    }
}

'providers' => [

    ...

    L5Swagger\L5SwaggerServiceProvider::class,
]

return [
    'api' => [
        /*
        |--------------------------------------------------------------------------
        | Edit to set the api's title
        |--------------------------------------------------------------------------
        */

        'title' => '后台Api文档', # 文档页面的标题
    ],

    'routes' => [
        /*
        |--------------------------------------------------------------------------
        | Route for accessing api documentation interface
        |--------------------------------------------------------------------------
        */

        'api' => 'api/docs', # 文档页面的路由

        /*
        |--------------------------------------------------------------------------
        | Route for accessing parsed swagger annotations.
        |--------------------------------------------------------------------------
        */

        'docs' => 'docs', # 路由别名

        ...

<?php

/**
 *
 * @OA\OpenApi(
 *     security={
 *         {
 *             "Bearer":{}
 *         }
 *     },
 *     @OA\Server(
 *         url=L5_SWAGGER_CONST_HOST
 *     )
 * )
 *
 * @OA\Info(
 *     version="1.0",
 *     title="小程序后台Api文档",
 *     @OA\Contact(
 *         name="火星救援网络科技有限公司",
 *         url="http://www.example.com/"
 *     )
 * )
 *
 * @OA\SecurityScheme(
 *     securityScheme="Bearer",
 *     type="apiKey",
 *     name="Authorization",
 *     in="header",
 * )
 *
 */

/**
 * @OA\Tag(
 *     name="Auth",
 *     description="验证模块"
 * )
 *
 * @OA\Tag(
 *     name="System.Permission",
 *     description="系统模块中的权限管理"
 * )
 *
 * @OA\Tag(
 *     name="System.Role",
 *     description="系统模块中的角色管理"
 * )
 *
 * @OA\Tag(
 *     name="System.Admin",
 *     description="系统模块中的用户管理"
 * )
 */

class AuthController extends Controller
{
    /**
     * @OA\Post(
     *     path="/auth/login",
     *     summary="获取凭证",
     *     tags={"Auth"},
     *     description="通过账号密码获取Access Token",
     *     @OA\Parameter(
     *         name="email",
     *         in="query",
     *         required=true,
     *         @OA\Schema(
     *             type="string"
     *         ),
     *         example="[email protected]",
     *         description="邮箱"
     *     ),
     *     @OA\Parameter(
     *         name="password",
     *         in="query",
     *         required=true,
     *         @OA\Schema(
     *             type="string"
     *         ),
     *         description="密码"
     *     ),
     *     @OA\Response(
     *         response=200,
     *         description="返回凭证",
     *         ref="#/components/schemas/Token"
     *     ),
     *     @OA\Response(
     *         response=401,
     *         description="账号不存在或密码错误"
     *     )
     * )
     *
     * @param LoginRequest $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function login(LoginRequest $request) {
         ...

$ composer require 'squizlabs/php_codesniffer' --dev

$ composer phpcs ./
$ composer phpcbf ./

    'redis' => [

        'cluster' => false,

        'default' => [
            'host' => env('REDIS_HOST', 'localhost'),
            'password' => env('REDIS_PASSWORD', null),
            'port' => env('REDIS_PORT', 6379),
            'database' => 0,
        ],

        'queue' => [
            'host' => env('QUEUE_REDIS_HOST', 'localhost'),
            'password' => env('QUEUE_REDIS_PASSWORD', null),
            'port' => env('QUEUE_REDIS_PORT', 6379),
            'database' => 0,
        ],
    ],

'default' => env('QUEUE_DRIVER', 'sync'),
...
'connections' => [
        'redis' => [
            'driver' => 'redis',
            'connection' => 'queue',
            'queue' => 'default',
            'expire' => 60,
        ],
],
...

class SaveMatchLog extends Job implements ShouldQueue
{
    use InteractsWithQueue, SerializesModels;

    /**
     * 请求的订单号
     * @var string
     */
    private $orderNo;

    /**
     * 请求时间
     * @var array
     */
    private $time;

    /**
     * 请求IP
     * @var array
     */
    private $ip;

    /**
     * 客户端系统信息
     * @var array
     */
    private $userAgent;

    /**
     * 响应信息
     * @var array
     */
    private $msg;

    /**
     * saveMatchLog constructor.
     * @param Request $req
     * @param \Illuminate\Http\JsonResponse $res
     */
    public function __construct($req, $res)
    {
        $this->orderNo = $req->get('order_no');
        $this->time = date('Y-m-d H:i:s', $req->server->get('REQUEST_TIME'));
        $this->ip = $req->getClientIp();
        $this->userAgent = $req->header('user-agent');
        $this->msg = $res->getData();
    }

    /**
     * Execute the job.
     *
     * @return void
     */
    public function handle()
    {
        // 日志内容
        $content = $this->getLogContent();

        // 输出日志
        $logWriter = new Writer(new Logger('match'));
        $logWriter->useDailyFiles(storage_path('logs/match/match.log'));
        $logWriter->info($content);
    }

    public function failed()
    {
        $content = $this->getLogContent();
        \Log::error('记录请求响应日志到logs/match.log失败，日志将记录在系统日志logs/laravel.log中');
        \Log::info($content);
    }

    /**
     * @return string
     */
    private function getLogContent()
    {
        return json_encode([
            'orderNo' => $this->orderNo,
            'time' => $this->time,
            'ip' => $this->ip,
            'userAgent' => $this->userAgent,
            'msg' => $this->msg,
        ], JSON_UNESCAPED_UNICODE);
    }
}

    /**
     * 接口入口
     * @param Request $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function match(Request $request)
    {
        $response = $this->_match($request);
        $job = (new SaveMatchLog($request, $response));
        $this->dispatch($job); // 使用队列存储日志，提高接口响应速度
        return $response;
    }

    /**
     * @param Request $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function _match(Request $request)
    {
        // do sth
    }

namespace App\Models;

trait UseUnixTimestamp
{
    public function freshTimestamp() {
        return time();
    }

    public function fromDateTime($value) {
        return $value;
    }

    public function getDateFormat() {
        return 'U';
    }
}

namespace App\Models;

use UseUnixTimestamp;

class MyModel extends Model
{
    use UseUnixTimestamp;
    
    //
}