serendipias/laravel-urn

Universal laravel urn identifier

0.5.0 2019-12-11 23:08 UTC

Requires

• php: ^7.2
• illuminate/contracts: ^6.6
• illuminate/support: ^6.6
• league/uri: ^5.3
• psy/psysh: ^0.9
• ramsey/uuid: ^3.8
• symfony/intl: ^4.3|^5.0

Requires (Dev)

• mockery/mockery: ^1.0
• phpunit/phpunit: ^8.0

MIT

• Jorge Y. C. Rodriguez

• composer
• laravel
• URN
• urn-identifier

README

Simple way to create urn identifiers for your laravel application, allowing a simple way to identifies resources or models a more descriptive way.

Installation

Application can be installed by running:

composer require serendipias/laravel-urn

The application requires laravel/lumen >= 6.x

Usage

Register provider:

In Laravel config/app.php add the urn service provider to your providers array:

\Serendipias\Urn\UrnServiceProvider::class,

if you are using Lumen you will need to register the service provider in your bootstrap/app.php

$app->register(\Serendipias\Urn\UrnServiceProvider::class);

Publishing configuration:

Publish the configuration, run the following command:

php artisan vendor:publish --tag=urn

In lumen you will need to manually copy the urn file to your config directory.

The package has 3 basic configurations that are required to work with laravel/lumen models:

• models_namespace: Models namespace, this is use to be able to get models instances from the urn
• service: this is use to declare where the urn was created, which application is the source for the identifier
• stage: determinate if the resource was generated in production, testing, stage or unit testing.

Enable models to generate urns

To allow a model to be urn identifiable the model must extend Serendipias\Urn\Contracts\UrnIdentifiable interface, the package provides a trait with the interface default implementations UrnIdentifiableTrait.

To generate urn with a model, inject or make Serendipias\Urn\Services\UrnService::class, from there you can encode a model, or decode an urn string, in both cases an Serendipias\Urn\Support\Urn is returned.

Urn instance example:

Serendipias\Urn\Support\Urn {
  -urn: "urn:laravel:local:user:1"
  -namespace: "App\Models"
  -parts: array:5 [
    0 => "urn"
    1 => "laravel"
    2 => "local"
    3 => "user"
    4 => "1"
  ]
}

To encode an model:

$service = app(\Serendipias\Urn\Services\UrnService::class);
$urn = $service->encode(\App\Models\User::find(1));
$urn->getUrnString(); // urn:laravel:local:user:1

To decode a urn string:

$service = app(\Serendipias\Urn\Services\UrnService::class);
$urn = $service->decode('urn:laravel:local:user:1');
$urn->find(); // will return User model or null if not found