Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/charlietyn/rest-generic-class/llms.txt

Use this file to discover all available pages before exploring further.

​
Installation via Composer

The Rest Generic Class package is installed through Composer, PHP’s dependency manager.
1

Install the package

Run the following command in your Laravel project root:
composer require ronu/rest-generic-class
Composer will:
  • Download the latest stable version (current: 2.1.8)
  • Install all required dependencies
  • Register the package with your Laravel application
Installation typically takes 30-60 seconds depending on your network speed and system performance.
2

Verify auto-discovery

Laravel’s package auto-discovery will automatically register the service provider. Verify the package is installed:
composer show ronu/rest-generic-class
You should see output confirming the package version and details:
name     : ronu/rest-generic-class
descrip. : Base Class for generic restfull api in laravel
versions : * 2.1.8
The service provider Ronu\RestGenericClass\Core\Providers\RestGenericClassServiceProvider is registered automatically via the extra.laravel.providers section in composer.json.
3

Publish configuration (optional)

Publishing the configuration file is optional but recommended if you want to customize package behavior:
php artisan vendor:publish --tag=rest-generic-class-config
This creates config/rest-generic-class.php in your application with default settings.
If you don’t publish the config file, the package will use its default configuration. This is perfectly fine for getting started.
4

Verify installation

Confirm the package is working by checking if the base classes are available:
php artisan tinker
Then in the Tinker shell:
>>> class_exists('Ronu\\RestGenericClass\\Core\\Models\\BaseModel');
=> true

>>> class_exists('Ronu\\RestGenericClass\\Core\\Services\\BaseService');
=> true

>>> class_exists('Ronu\\RestGenericClass\\Core\\Controllers\\RestController');
=> true
If all return true, the installation is successful!

​
Service Provider Registration

​
Automatic Registration

The package uses Laravel’s auto-discovery feature. The service provider is registered automatically through the extra.laravel section in composer.json: 
"extra": {
    "laravel": {
        "providers": [
            "Ronu\\RestGenericClass\\Core\\Providers\\RestGenericClassServiceProvider"
        ]
    }
}
You don’t need to manually add the service provider to config/app.php. Laravel 5.5+ handles this automatically.

​
Manual Registration (Edge Cases)

If auto-discovery is disabled in your project, manually register the provider in config/app.php:
config/app.php
'providers' => [
    // Other service providers...
    
    Ronu\RestGenericClass\Core\Providers\RestGenericClassServiceProvider::class,
],
Manual registration is rarely needed. Only use this approach if you’ve explicitly disabled package auto-discovery.

​
What Gets Installed

When you install the package, you get access to:

​
Core Classes

  • BaseModel: Extended Eloquent model with filtering, relations, and hierarchy support
  • BaseService: Service layer with CRUD operations, caching, and business logic
  • RestController: Controller base class with RESTful endpoints

​
Additional Features

  • Dynamic filtering with complex operators
  • Relation eager loading and nested selection
  • Hierarchical data listing with parent-child relationships
  • Request validation and column validation
  • Built-in caching with multiple store support
  • Export capabilities (with optional dependencies)
  • Permission management integration (with Spatie)

​
Configuration

  • Logging configuration for debugging and monitoring
  • Filtering rules and validation settings
  • Cache strategy and TTL settings
  • Query performance options

​
Troubleshooting Installation

​
Composer Memory Issues

If Composer runs out of memory during installation: 
php -d memory_limit=-1 /usr/local/bin/composer require ronu/rest-generic-class

​
Version Conflicts

If you encounter dependency conflicts: 
# Update existing packages first
composer update

# Then try installing again
composer require ronu/rest-generic-class
Check that your Laravel version is 12.0 or higher. Run php artisan --version to verify.

​
Auto-discovery Not Working

Verify auto-discovery is enabled in composer.json: 
"extra": {
    "laravel": {
        "dont-discover": []
    }
}
If the package is in the dont-discover array, remove it or register the provider manually.

​
Next Steps

Now that the package is installed, proceed to initial configuration to customize the package for your needs.

Build docs developers (and LLMs) love

Get started for freeTalk to us