Download the PHP package mouhamad-mahfouz/helpers without Composer

Mahfouz Helpers

A Laravel package that provides helpful tools and utilities for API development. This package includes service classes, API controller generators, and other utilities to streamline your Laravel API development process.

Compatibility

This package supports Laravel 11 and 12.

Installation

You can install the package via composer:

The package will automatically register its service provider.

Features

Format Response Trait

Easily format consistent JSON responses in your controllers:

Available methods:

• successResponse(?string $message = null, mixed $data = null): array
• errorResponse(string $message): array

Base Service Class

The package provides a BaseService class that implements common CRUD operations for your models. It integrates with Spatie's Query Builder for advanced filtering and pagination.

API Controller Generator

Generate API controllers with a single command:

Options:

• --methods: Comma-separated list of methods to generate (index, store, show, update, destroy)
• --resource: Fields to include in the resource
• --store-request: Fields for the store request validation
• --update-request: Fields for the update request validation

You can also use --methods=* to generate all standard CRUD methods.

Service Generator

Generate service classes for your models:

This will create a service class that extends the BaseService class and is configured for your model.

Media Cleanup Command

Clean up unused media files that are not referenced in the media table:

This command will:

• Delete media files that exist in the storage but are not referenced in the database
• Remove empty directories after file cleanup

Note: This command requires the Spatie Media Library package to be installed and configured in your application.

Usage

Services

Once you've created a service, you can use it in your controllers:

Available Service Methods

The BaseService class provides the following methods:

• get(?callable $callback = null): Get all records with optional callback for query customization
• paginate(array $with = [], $per_page = null, ?callable $callback = null): Paginate records with eager loading
• store(object $data): Create a new record
• update(Model $model, object $data): Update an existing record
• destroy(Model $model): Delete a record

Customization

You can publish the stubs to customize them:

This will publish the stubs to stubs/mahfouz in your application.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

The MIT License (MIT). Please see License File for more information.