🧱 Laravel Repo-Service Struct Generator

✅ Generate clean Repository-Service structure with interfaces, bindings, and optional MongoDB support for Laravel 11 and 12+

This library provides a powerful artisan command set to generate and manage Repository-Service architecture with optional binding, base classes, and multi-model support. It helps you follow a clean, testable architecture in Laravel projects.

🧾 Version Information

📚 Table of Contents

• Features
• Installation
• Generate Base Classes
• Full Structure Generation
• Create Simple Service
• Bindings
• Unbind
• Remove Structures
• Subdirectory Support
• BaseRepository Methods
• BaseService Methods
• Advanced Query Conditions
• Folder Structure

• Generate Repository, Service, Interface automatically.
• Optional Model generation (Eloquent or MongoDB).
• Auto-bind/unbind to AppServiceProvider.
• Subdirectory/nested folder support (e.g. Pay/Transaction).
• Generate App-level base classes for easy extension.
• transaction() support via DB facade.
• Reversible file generation (remove struct).
• Fast CLI operations.

composer require cuongnx/laravel-repo-service-generator

📦 For MongoDB support:

composer require mongodb/laravel-mongodb

php artisan cuongnx:make-base

Generates App-level base classes that extend the library's base classes, so you can add custom methods or override behavior without modifying the vendor code.

Options:

Generated files:

app/
├── Repositories/
│   ├── Contracts/
│   │   └── BaseRepositoryInterface.php   ← extends lib BaseRepositoryInterface
│   └── Eloquent/
│       └── BaseRepository.php            ← extends lib BaseRepository
└── Services/
    ├── Contracts/
    │   └── BaseServiceInterface.php      ← extends lib BaseServiceInterface
    └── BaseService.php                   ← extends lib BaseService

Once these files exist, all subsequently generated repositories and services will automatically extend your App-level base instead of the library's base. This allows you to add shared methods across your entire project.

⚠️ Run cuongnx:make-base before generating your first struct for best results.

php artisan cuongnx:make-struct Post

Options:

📌 Example with MongoDB:

php artisan cuongnx:make-struct Product --m --type=m

This command generates the following files:

app/
├── Models/
│   └── Post.php
├── Repositories/
│   ├── Contracts/
│   │   └── PostRepositoryInterface.php
│   └── Eloquent/
│       └── PostRepository.php
└── Services/
    ├── Contracts/
    │   └── PostServiceInterface.php
    └── PostService.php

📌 If --no-bind is not provided, the following bindings will be added to AppServiceProvider:

$this->app->bind(
    \App\Repositories\Contracts\PostRepositoryInterface::class,
    \App\Repositories\Eloquent\PostRepository::class
);

$this->app->bind(
    \App\Services\Contracts\PostServiceInterface::class,
    \App\Services\PostService::class
);

Creates a standalone service without a repository — useful for business logic that doesn't need direct database access.

php artisan cuongnx:make-service Custom

Options:

Generated files:

app/
└── Services/
    ├── Contracts/
    │   └── CustomServiceInterface.php
    └── CustomService.php

Bind both repository & service:

php artisan cuongnx:bind-model User

Options:

Bind individually:

php artisan cuongnx:bind-repo User
php artisan cuongnx:bind-service User

php artisan cuongnx:unbind-model User

Options:

Or directly:

php artisan cuongnx:unbind-repo User
php artisan cuongnx:unbind-service User

Remove all generated files (repo + service + optional model):

php artisan cuongnx:remove-struct Post --model

Options:

Remove only service:

php artisan cuongnx:remove-service Post

All commands support nested folder structure using / as separator. This is useful for grouping related models under a domain or module.

php artisan cuongnx:make-struct Pay/Transaction --m
php artisan cuongnx:make-service Pay/Notification
php artisan cuongnx:bind-model Pay/Transaction
php artisan cuongnx:unbind-model Pay/Transaction
php artisan cuongnx:remove-struct Pay/Transaction

For Pay/Transaction, the generated structure is:

app/
├── Models/
│   └── Pay/
│       └── Transaction.php
├── Repositories/
│   ├── Contracts/
│   │   └── Pay/
│   │       └── TransactionRepositoryInterface.php
│   └── Eloquent/
│       └── Pay/
│           └── TransactionRepository.php
└── Services/
    ├── Contracts/
    │   └── Pay/
    │       └── TransactionServiceInterface.php
    └── Pay/
        └── TransactionService.php

Bindings use the full namespaced class:

$this->app->bind(
    \App\Repositories\Contracts\Pay\TransactionRepositoryInterface::class,
    \App\Repositories\Eloquent\Pay\TransactionRepository::class
);

Supports any depth: Pay/Gateway/Transaction, Admin/Report/Monthly, etc.

All repositories extend BaseRepository and automatically gain access to these common data methods.

🔍 Read Methods

📊 Pagination

📈 Aggregate Methods

🔧 Utility Methods

✅ Existence Checks

📝 Create/Update Methods

❌ Delete / Restore Methods

All services extend BaseService and delegate every method to the underlying repository. The service layer is where you implement business logic on top of the repository.

BaseService exposes the same interface as BaseRepository — all read, write, aggregate, pagination, and utility methods are available. Additional service-level methods:

To add custom business logic, define methods in your generated service class:

class PostService extends BaseService implements PostServiceInterface
{
    public function publish(int $id): bool
    {
        return $this->transaction(function () use ($id) {
            return $this->update($id, ['status' => 'published', 'published_at' => now()]);
        });
    }
}

The BaseRepository supports flexible query conditions for both Eloquent and MongoDB.

1️⃣ Simple Conditions

$conditions = [
    'status' => 'active',
    'user_id' => 123
];

$posts = $postRepo->getByAttributes($conditions);

2️⃣ Comparison Operators

$conditions = [
    'price' => ['>=', 100],
    'stock' => ['<', 50],
    'rating' => ['>', 4.5]
];

$products = $productRepo->getByAttributes($conditions);

3️⃣ MongoDB Operators

// Using MongoDB $gte, $lte operators
$conditions = [
    'expired_at' => [
        '$gte' => now(),
        '$lte' => now()->addDays(30)
    ]
];

// Using MongoDB $elemMatch for array fields
$conditions = [
    'tags' => [
        '$elemMatch' => ['name' => 'Laravel', 'type' => 'framework']
    ]
];

4️⃣ Range Queries

// Using from/to syntax
$conditions = [
    'created_at' => [
        'from' => now()->subDays(7),
        'to' => now()
    ]
];

// Using min/max syntax
$conditions = [
    'price' => [
        'min' => 100,
        'max' => 1000
    ]
];

// Using between operator
$conditions = [
    'age' => ['between', [18, 65]]
];

Both from/to and min/max use whereBetween() internally.

5️⃣ IN / NOT IN Queries

$conditions = [
    'status' => ['in', ['active', 'pending', 'processing']],
    'category_id' => ['not_in', [5, 10, 15]]
];

6️⃣ NULL Checks

$conditions = [
    'deleted_at' => ['null'],
    'email_verified_at' => ['not_null']
];

7️⃣ OR Groups

Use the 'or' key to group conditions with OR logic:

$conditions = [
    'status' => 'active',
    'or' => [
        ['role' => 'admin'],
        ['role' => 'moderator', 'verified' => true],
    ]
];
// WHERE status = 'active' AND (role = 'admin' OR (role = 'moderator' AND verified = 1))

8️⃣ Combined Complex Queries

$conditions = [
    'status' => 'active',
    'price' => [
        '$gte' => 100,
        '$lte' => 1000
    ],
    'category_id' => ['in', [1, 2, 3]],
    'created_at' => [
        'from' => now()->subMonth(),
        'to' => now()
    ],
    'tags' => [
        '$elemMatch' => ['featured' => true]
    ]
];

$products = $productRepo->getByAttributes(
    conditions: $conditions,
    fields: ['id', 'name', 'price'],
    relations: ['category', 'images'],
    orderBy: ['created_at' => 'desc']
);

9️⃣ Ordering Results

// Simple string (defaults to asc)
$orderBy = 'created_at';

// Single indexed field (defaults to asc)
$orderBy = ['created_at'];

// Associative array
$orderBy = ['created_at' => 'desc'];

// Multiple fields
$orderBy = [
    'status' => 'asc',
    'created_at' => 'desc'
];

// Indexed array of tuples
$orderBy = [
    ['status', 'asc'],
    ['created_at', 'desc']
];

Real-World Examples

Get Active Products Expiring Soon

$products = $productRepo->getByAttributes([
    'status' => 'active',
    'expired_at' => [
        '$gte' => now(),
        '$lte' => now()->addDays(30)
    ]
], orderBy: ['expired_at' => 'asc']);

Get Orders from Last Month in Price Range

$orders = $orderRepo->getByAttributes([
    'total_amount' => [
        'min' => 1000,
        'max' => 5000
    ],
    'created_at' => [
        'from' => now()->subMonth()->startOfMonth(),
        'to' => now()->subMonth()->endOfMonth()
    ],
    'status' => ['in', ['completed', 'shipped']]
], relations: ['user', 'items']);

Process Large Dataset in Chunks

$stopped = $userRepo->chunk(200, function ($users) {
    foreach ($users as $user) {
        if ($user->shouldStop()) {
            return false; // stops chunking, chunk() returns false
        }
        // process...
    }
});

Run Operations in a Transaction

$result = $orderService->transaction(function () use ($data) {
    $order = $this->create($data['order']);
    $this->getRepository()->deleteBy(['cart_id' => $data['cart_id']]);
    return $order;
});

app/
├── Repositories/
│   ├── Contracts/
│   │   ├── BaseRepositoryInterface.php     ← generated by make-base
│   │   ├── UserRepositoryInterface.php
│   │   └── PostRepositoryInterface.php
│   └── Eloquent/
│       ├── BaseRepository.php              ← generated by make-base
│       ├── UserRepository.php
│       └── PostRepository.php
├── Services/
│   ├── Contracts/
│   │   ├── BaseServiceInterface.php        ← generated by make-base
│   │   ├── CustomServiceInterface.php
│   │   ├── UserServiceInterface.php
│   │   └── PostServiceInterface.php
│   ├── BaseService.php                     ← generated by make-base
│   ├── CustomService.php
│   ├── UserService.php
│   └── PostService.php
└── Models/
    ├── User.php
    └── Post.php

• Email: xuancuong220691@gmail.com

• MIT License © Cuong Nguyen