marufnwu/laravel-utils

Reusable Laravel utilities including response pipeline, helpers, and common functionality

1.0.2 2025-05-28 11:07 UTC

Requires

• php: ^7.4|^8.0
• illuminate/console: ^8.0|^9.0|^10.0|^11.0|^12.0
• illuminate/database: ^8.0|^9.0|^10.0|^11.0|^12.0
• illuminate/http: ^8.0|^9.0|^10.0|^11.0|^12.0
• illuminate/support: ^8.0|^9.0|^10.0|^11.0|^12.0
• illuminate/view: ^8.0|^9.0|^10.0|^11.0|^12.0

Requires (Dev)

• laravel/pint: ^1.0
• mockery/mockery: ^1.4
• orchestra/testbench: ^7.0|^8.0|^9.0
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^9.5|^10.0

MIT

• Maruf Ahmed

• helpers
• response
• laravel
• utilities
• pipeline
• maruf

README

A comprehensive Laravel package providing reusable utilities including response pipeline, array helpers, string helpers, and more.

Features

• 🔄 Response Pipeline: Standardized API responses with success/error handling
• 🔧 Array Helper: Dot notation access, filtering, grouping, and more
• 📝 String Helper: Advanced string manipulation utilities
• 🎨 Blade Directives: Custom Blade directives for pipeline responses
• 📦 Facades: Easy-to-use facades for all helpers
• 🌍 Global Helpers: Optional global helper functions

Installation

Install via Composer:

composer require marufnwu/laravel-utils

For Laravel < 11, register the service provider in config/app.php:

'providers' => [
    // ...
    Marufnwu\Utils\LaravelUtilsServiceProvider::class,
],

Publish configuration and resources:

php artisan utils:install

Quick Start

Pipeline Usage

use Marufnwu\Utils\Pipeline;

// Success response
return Pipeline::success($data, 'User created successfully')->toApiResponse();

// Error response
return Pipeline::error('Validation failed', 422, $errors)->toApiResponse();

// For views
return Pipeline::success($users)->toViewResponse('users.index');

// For redirects
return Pipeline::success()->toRedirectResponse('dashboard');

Array Helper Usage

use Marufnwu\Utils\Helpers\ArrayHelper;

$array = ['user' => ['name' => 'John', 'profile' => ['age' => 25]]];

// Dot notation access
$name = ArrayHelper::get($array, 'user.name'); // 'John'
$age = ArrayHelper::get($array, 'user.profile.age'); // 25

// Set values
ArrayHelper::set($array, 'user.email', '[e-mail]');

// Filter arrays
$users = [
    ['name' => 'John', 'age' => 25],
    ['name' => 'Jane', 'age' => 30],
];
$adults = ArrayHelper::where($users, 'age', '>=', 18);

// Group by key
$grouped = ArrayHelper::groupBy($users, 'age');

// Pluck values
$names = ArrayHelper::pluck($users, 'name'); // ['John', 'Jane']

String Helper Usage

use Marufnwu\Utils\Helpers\StringHelper;

// Case conversion
StringHelper::camel('hello_world'); // 'helloWorld'
StringHelper::snake('HelloWorld'); // 'hello_world'
StringHelper::kebab('Hello World'); // 'hello-world'
StringHelper::studly('hello_world'); // 'HelloWorld'

// String manipulation
StringHelper::limit('Long text here...', 10); // 'Long text...'
StringHelper::words('One two three four', 2); // 'One two...'
StringHelper::slug('Hello World!'); // 'hello-world'

// String checks
StringHelper::startsWith('Hello World', 'Hello'); // true
StringHelper::contains('Hello World', 'World'); // true
StringHelper::endsWith('Hello World', 'World'); // true

// Masking
StringHelper::mask('1234567890', '*', 3, 4); // '123****890'

Using Facades

use Pipeline;
use ArrayHelper;
use StringHelper;