vaskiq/laravel-datalayer

A Laravel package that simplifies data handling across multiple sources using the Repository pattern and structured DTOs.

v0.2.x-dev 2025-02-23 21:19 UTC

Requires

• php: ^8.3
• illuminate/database: ^11.0
• illuminate/events: ^11.0
• illuminate/support: ^11.0
• spatie/laravel-data: ^4.10

Requires (Dev)

• larastan/larastan: ^2.0
• laravel/pint: ^1.18
• orchestra/testbench: ^9.5
• pestphp/pest: ^3.5
• phpunit/php-code-coverage: ^11.0

Suggests

• tapp/laravel-airtable: Required if you need to use the Airtable repository driver.

Apache-2.0

README

This package provides a repository implementation for Laravel applications.

Installation

To install the package, run:

composer require vaskiq/laravel-datalayer

Usage

EloquentModelRepository

The EloquentModelRepository class offers various methods to interact with Eloquent models.

Methods

• findModel(int|string $id): ?Model
• findModelOrFail(int|string $id): Model
• allModels(): Collection
• createModel(array $data): Model
• updateModel(int|string $id, array $data): ?Model
• deleteModel(int|string $id): bool
• query(): EloquentBuilder
• raw(): QueryBuilder
• modelClass(): string
• newModel(): Model
• updateOrCreateModel(array $attributes, array $values): Model
• deleteAllModelsBy(array|Closure|Expression $conditions): int
• findModelBy(array|Closure|Expression $conditions): ?Model
• findAllModelsBy(array|Closure|Expression $conditions): Collection

Example

use App\Models\User;
use Vaskiq\LaravelDataLayer\Repositories\EloquentModelRepository;

class UserRepository extends EloquentModelRepository
{
    public function __construct(User $model)
    {
        parent::__construct($model);
    }
}

// Usage
$userRepository = new UserRepository(new User());

// Find a user by ID
$user = $userRepository->findModel(1);

// Create a new user
$newUser = $userRepository->createModel(['name' => 'John Doe', 'email' => '[e-mail]']);

// Update a user
$updatedUser = $userRepository->updateModel(1, ['name' => 'Jane Doe']);

// Delete a user
$userRepository->deleteModel(1);

// Get all users
$users = $userRepository->allModels();