atk4 / laravel-ad
Extension for Laravel to natively integrate with Agile Data (http://git.io/ad)
Requires
- php: >=5.5.0
- atk4/data: ~1.1
- foxxmd/php-utilities: dev-master
- illuminate/auth: >=5.1
- illuminate/console: >=5.1
- illuminate/container: >=5.1
- illuminate/contracts: >=5.1
- illuminate/support: >=5.1
- illuminate/validation: >=5.1
- orchestra/testbench: ~3.1
Requires (Dev)
- atk4/schema: *
- codeclimate/php-test-reporter: *
- illuminate/log: >=5.1
- itsgoingd/clockwork: ~1.9
- mockery/mockery: ~0.9
- phpunit/phpunit: ~4.0
Suggests
- atk4/laravel-ad-extensions: Integrate various Agile Data extensions into Laravel (audit, migrations, files, etc)
- atk4/ui: Lightweight UI Server-side Object library
- fzaninotto/faker: Required to use the entity factory builder (~1.4).
This package is auto-updated.
Last update: 2023-09-28 17:47:21 UTC
README
A drop-in integration for Laravel 5+ to allow use of Agile Data natively.
Installation
First install via composer
composer require "atk4/laravel-ad"
Next, add the ServiceProvider to the providers array in config/app.php
at4k\LaravelAD\AgileDataServiceProvider::class
Finally, publish the configuration file by running the command:
php artisan vendor:publish --tag="agiledata"
Configuration
Without any additional configuration LaravelAD will use the default connection specified in your config/database.php
configuration.
To use a different connection simply specify the connection name in config/agiledata.php
.
Usage
There are two ways to get an instance of atk4\data\Persistence
which follow the normal behavior of resolving a dependency in Laravel.
Through a type-hint in any class that is resolved through the service container:
use Illuminate\Routing\Controller; class MyController extends Controller { public function __construct(atk4\data\Persistence $db) { } }
or by resolving directly through the service container
$db = $this->app->make('agiledata'); // using the alias $db = $this->app->make(atk4\data\Persistence::class); // using the class name
Roadmap
- DI integration
- Facade for retrieving different
Persistence
objects - Authentication UserProvider
- Migrations using Console
- Support route validations that use DB
- Support Laravel Collections?