jag/common

Jag\Common

Nah, some boilerplate here. All included packages service provider are already registered.

Option service are not included out-of-the-box, instead add its service provider. See below for instruction.

Laravel Packager are not included out-of-the-box (updated since 1.0.2). See below for instruction

Table of Contents

• Included Packages
• Install
• Post Install
• IDE Helper
• Option Service Provider
• Clockwork Middleware
• How to use Laravel Packager
• Optional Facade
• Extend Exception Handler
• JSON Controller Response Trait
• Change Log
• Security
• Credits
• License

Included Packages

• Socialite - Fluent interface to OAuth authentication
• Image - PHP Image Manipulation
• Image(Cache) - Caching extension for the Intervention Image Class
• Html/Form - Illuminate HTML component
• Entrust - Role-based Permissions
• HTML Sanitizer- HTML Sanitizer
• iSeed - Inverse seed generator
• Whoops - PHP errors for cool kids
• Clockwork - Chrome extension for PHP development

Install

Via Composer

$ composer require jag/common

Post Install

After the installation/update completed, add the service provider to the $provider array in config/app.app

'Jag\Common\CommonServiceProvider'

After that, run

$ php artisan vendor:publish

Configurations from clockwork, ide-helper, image, imagecache, and entrust generated. Also, users migration will be generated.

IDE Helper

After installing/updating composer, you can now re-generate the docs yourself

$ php artisan ide-helper:generate

You can read the full documentation of this package

Option Service Provider

If you want to include the Option Service, add the service provider to the $provider array in config/app.app

'Jag\Common\OptionServiceProvider'

After that, publish the migrations.

$ php artisan vendor:publish --provider="Jag\Common\OptionServiceProvider"

Clockwork Middleware

You need to add Clockwork middleware, in your app/Http/Kernel.php

protected $middleware = [
    'Clockwork\Support\Laravel\ClockworkMiddleware',
    ...
]

How to use Laravel Packager

NOTE: This is for developing Laravel packages but only works for Laravel ~5.1.

If you are using Laravel ~5.1 add the service provider in config/app.php

'JeroenG\Packager\PackagerServiceProvider',

This package provides you with a simple tool to set up a new packages. Nothing more, nothing less. Read more of its documentation here.

However, an article teaches you to how to create packages.

Optional Facade

Edit and Add your config/app.php at $aliases array

'aliases' => [
    ...
    'Socialite' => 'Laravel\Socialite\Facades\Socialite',
    'Image'     => 'Intervention\Image\Facades\Image',
    'Html'      => 'Illuminate\Html\HtmlFacade',
    'Form'      => 'Illuminate\Html\FormFacade',
    'Entrust'   => 'Zizaco\Entrust\EntrustFacade',
],

You can also use the class name resolution via ::class

Extend Exception Handler

You can use the Exception handler specially for developing. This includes the Whoops. You can extend your app/Exceptions/Handler.php with Jag\Common\Exceptions\Handler.

JSON Controller Response Trait

For easy JSON response on your Controller, just included the trait Jag\Common\Traits\ControllerResponsesTrait to your app/Http/Controllers/Controller.php.

Change Log

Please see CHANGELOG for more information what has changed recently.

Security

If you discover any security related issues, please email jayaregalinada@gmail.com instead of using the issue tracker.

Credits

• Jay Are Galinada
• Frederic Minne

License

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