43eb97c4创建于 2025年6月27日历史提交
<?php

namespace App\Repositories;

use App\Repositories\Contracts\Repository as RepositoryContract;
use Illuminate\Contracts\Auth\Guard;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Database\Eloquent\Model;

/**
 * @template T of Model
 * @implements RepositoryContract<T>
 */
abstract class Repository implements RepositoryContract
{
    /** @var class-string<T> $modelClass */
    public string $modelClass;

    protected Guard $auth;

    /** @param class-string<T> $modelClass */
    public function __construct(?string $modelClass = null)
    {
        $this->modelClass = $modelClass ?: self::guessModelClass();

        // This instantiation may fail during a console command if e.g. APP_KEY is empty,
        // rendering the whole installation failing.
        rescue(fn () => $this->auth = app(Guard::class));
    }

    /** @return class-string<T> */
    private static function guessModelClass(): string
    {
        return preg_replace('/(.+)\\\\Repositories\\\\(.+)Repository$/m', '$1\Models\\\$2', static::class);
    }

    /** @inheritDoc */
    public function getOne($id): Model
    {
        return $this->modelClass::query()->findOrFail($id);
    }

    /** @inheritDoc */
    public function findOne($id): ?Model
    {
        return $this->modelClass::query()->find($id);
    }

    /** @inheritDoc */
    public function getOneBy(array $params): Model
    {
        return $this->modelClass::query()->where($params)->firstOrFail();
    }

    /** @inheritDoc */
    public function findOneBy(array $params): ?Model
    {
        return $this->modelClass::query()->where($params)->first();
    }

    /** @inheritDoc */
    public function getMany(array $ids, bool $preserveOrder = false): Collection
    {
        $models = $this->modelClass::query()->find($ids);

        return $preserveOrder ? $models->orderByArray($ids) : $models;
    }

    /** @inheritDoc */ // @phpcs:ignore
    public function getAll(): Collection
    {
        return $this->modelClass::all(); // @phpstan-ignore-line
    }

    /** @inheritDoc */
    public function findFirstWhere(...$params): ?Model
    {
        return $this->modelClass::query()->firstWhere(...$params);
    }
}