This package can be used to use your own applications implementation of a model which has been provided by a vendor package. This can be useful to manipulate behaviour on a model, access protected properties or use classes in your own namespace.
Extending a vendor's class is already possible, but you cannot change vendors invocation of the class. All references will still point to the original class name and namespace.
This package will change the actual class that is returned from Eloquent query builders, including all(), get(), first(), findOrFail() etc.
For example:
// Code which may exist out of your control, in a vendor's package for example
\Vendor\Package\Models\CountryCode::firstOrFail()
// \Vendor\Package\Models\CountryCode is returned
/**
* After using Model Swapper
*/
\Vendor\Package\Models\CountryCode::firstOrFail()
// \App\Models\CountryCode is returnedYou can install the package via composer:
composer require grizzlyware/model-swapperuse Grizzlyware\ModelSwapper\Facades\ModelSwapper;
use Grizzlyware\ModelSwapper\Traits\IsReplacementModel;
// Add the IsReplacementModel trait to your replacement class
class YourApplicationsClass extends ClassFromVendorPackage
{
use IsReplacementModel;
}
// Swap the model out - this would usually be in your AppServiceProvider, in the boot method.
ModelSwapper::swap(
ClassFromVendorPackage::class,
YourApplicationsClass::class
);
// From now on, all queries for ClassFromVendorPackage will return instances of YourApplicationsClassuse Grizzlyware\ModelSwapper\Contracts\ModelSwapperServiceInterface;
// Or typehint from the container
public function __construct(ModelSwapperServiceInterface::class $modelSwapper)
// Or resolve from the container
resolve(ModelSwapperServiceInterface::class)->swap(
ClassFromVendorPackage::class,
YourApplicationsClass::class
);
// You can access the original, non-replaced model query like so:
YourApplicationsClass::replacedModelQuery()->firstOrFail();composer testPlease see CHANGELOG for more information on what has changed recently.
Please notify contact@grizzlyware.com about any security vulnerabilities, do not open an issue for them.
The MIT License (MIT). Please see License File for more information.