You are viewing documentation for an outdated version. It is no longer supported!

Registrar

The Api Resource Registrar is responsible for keeping track of each Eloquent Model's corresponding ApiResource. This component is, amongst other things, used to automatically find a relation's corresponding ApiResource.

Registration of Api Resources

Your registration should primarily be undertaken inside your config/api-resources.php. See how to register Api Resource introduction.

Nevertheless, the remaining of this sections will illustrate how to work with the Registrar, so that you may use it for more advanced approaches, if such is needed.

Obtain Registra instance

The Registrar component is bound as a singleton in the Service Container of your application. To obtain the instance, you can use ApiResourceRegistrarTrait.

use Aedart\Http\Api\Traits\ApiResourceRegistrarTrait;
use Illuminate\Http\Request;

class UsersController {
    use ApiResourceRegistrarTrait;
    
    public function index(Request $request){
        $registrar = $this->getApiResourceRegistrar();
        
        // ...remaining not shown...
    }
}

Register single Api Resource

If you wish to manually register a single Api Resource, for an Eloquent Model, use the set() method.

use App\Http\Resources\AddressResource;
use App\Models\Address;

$registrar->set(Address::class, AddressResource::class);

Register multiple Api Resources

To register a list of Api Resources, use register(). The method accepts an array of key-values;

  • key = class path to your eloquent model
  • value = class path to the model's corresponding Api Resource
$registrar->register([
    Address::class => AddressResource::class,
    User::class => UserResource::class,
    Book::class => BookResource::class
]);

Determine if Model has an Api Resource

The has() method can be used to determine if a model has an Api Resource registered. It accepts either a class path to an Eloquent Model or a Model instance.

echo $registrar->has(Address::class); // 1

Get Api Resource

The get() method returns a string class path to the registered Api Resource. If no Api Resource was registered for given model, then the method returns null.

echo $registrar->get(Address::class); // \App\Http\Resources\AddressResource

Find Api Resource by Type

To find an Api Resource (class path) by its type, use findResourceByType(). Method accepts a resource's string type in either singular or plural form. If an Api Resource exists for the given type, then its class path is returned. Null is returned if no Api Resource was found.

// Type in singular form
echo $registrar->findResourceByType('address'); // \App\Http\Resources\AddressResource

// Type in plural form
echo $registrar->findResourceByType('users'); // \App\Http\Resources\UserResource

Find Model by Resource Type

It is also possible to find the Eloquent Model of an Api Resource, by searching for the resource type via the findModelByType() method.

// Type in singular form
echo $registrar->findModelByType('address'); // \App\Models\Address

// Type in plural form
echo $registrar->findModelByType('users'); // \App\Models\User

Remove Api Resource

Should you be required to remove an Api Resource for a given model, then you can do so via the forget() method. The method will return true when Api Resource and successfully removed, for the given model. If not, false is returned.

echo $registrar->forget(Address::class); // 1