slashequip/laravel-patchable

Laraval package to add a more declarative way to handle PATCH endpoints.

v1.0.0 2025-04-27 08:29 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^11.0||^12.0

Requires (Dev)

• larastan/larastan: ^2.9||^3.0
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.1.1||^7.10.0
• orchestra/testbench: ^10.0.0||^9.0.0
• pestphp/pest: ^3.0
• pestphp/pest-plugin-arch: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• phpstan/extension-installer: ^1.3||^2.0
• phpstan/phpstan-deprecation-rules: ^1.1||^2.0
• phpstan/phpstan-phpunit: ^1.3||^2.0

MIT

• Sam Jones

• laravel
• slashequip
• laravel-patcher

README

Laravel Patchable is an opinionated, declarative package to help simplify the building of PATCH routes.

It abstracts the boiler plate needed to validate and update individual Model attributes based on the request.

Installation

You can install the package via composer:

composer require slashequip/laravel-patchable

Usage

Your Model's can be made patchable by add the trait of the same name.

use SlashEquip\Patchable\Traits\Patchable;

class Property extends Model
{
    use Patchable;
}

In your patch controllers you can simply call patch on the Model.

class UpdatePropertyController
{
    public function __invoke(Property $property)
    {
        $property->patch();
    }
}

To configure you model you need to define your patchable attributes.

class Property extends Model
{
    public $patchable = [
        'name',
        'lat',
        'lng',
    ];
}

To get a little more advanced you can define validation for your patchable attributes.

This can be achieved either with Laravel's string or array syntax for validation rules.

class Property extends Model
{
    public $patchable = [
        'name' => 'string|max:255',
        'lat' => [
            'numeric',
            'regex:/^[-]?((([0-8]?[0-9])(\.[0-9]+)?)|90(\.0+)?)$/',
        ],
        'lng' => [
            'numeric',
            'regex:/^[-]?((([0-9]|1[0-7][0-9])(\.[0-9]+)?)|180(\.0+)?)$/',
        ],
    ];
}

To get even more advanced you can use Patch classes for your patchable attributes.

class Property extends Model
{
    public $patchable = [
        'name' => PropertyNamePatch::class,
    ];
}

use SlashEquip\Patchable\Contracts\Patch;

class PropertyNamePatch implements Patch
{
    public function authorize(Property $property): bool
    {
        return true;
    }

    public function rules(): string|array
    {
        return [
            'string',
            'max:255',
        ];
    }

    public function patch(Property $property, string $key, $value): void
    {
        $property->name = strtolower($value);
    }
}

If you want to handle patching with a more manual approach, you can use the Patcher class directly.

use SlashEquip\Patchable\Patcher;

class UpdatePropertyController
{
    public function __invoke(Property $property)
    {
        Patcher::patch(
            model: $property,
            patchable: [
                'name' => PropertyNamePatch::class,
                'lat' => [
                    'numeric',
                    'regex:/^[-]?((([0-8]?[0-9])(\.[0-9]+)?)|90(\.0+)?)$/',
                ],
                'lng' => [
                    'numeric',
                    'regex:/^[-]?((([0-9]|1[0-7][0-9])(\.[0-9]+)?)|180(\.0+)?)$/',
                ],
            ],
            attributes: request()->all(),
        )->finally(function (Property $property) {
            $property->save();
        });
    }
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Sam Jones
• All Contributors

License

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