larasoft / laravel-remote
Manage your Laravel Applications remotely.
Requires
- php: ~5.6|~7.0
- illuminate/config: 5.0.* || 5.1.* || 5.2.* || 5.3.* || 5.4.* || 5.5.*
- illuminate/database: 5.0.* || 5.1.* || 5.2.* || 5.3.* || 5.4.* || 5.5.*
- illuminate/support: 5.0.* || 5.1.* || 5.2.* || 5.3.* || 5.4.* || 5.5.*
- spatie/laravel-backup: ^3.10
- vinelab/http: ^1.2
Requires (Dev)
- phpunit/phpunit: ^4.8 || ^5.0
- scrutinizer/ocular: ~1.1
- squizlabs/php_codesniffer: ~2.3
This package is auto-updated.
Last update: 2024-10-26 23:04:48 UTC
README
Laravel Remote supports Laravel 5.* currently.
Install
Via Composer
$ composer require larasoft/laravel-remote dev-master
Add following two providers in providers array of "config/app.php".
'providers' => [ ... \Larasoft\LaravelRemote\LaravelRemoteServiceProvider::class, Spatie\Backup\BackupServiceProvider::class, ];
Run "php artisan vendor:publish" in project root to publish config files and middleware.
Configure
Step 1 (Required)
In "app/Http/Kernel.php, replace "\Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class" with "LaravelRemoteCheckForMaintenanceMode::class" in "$middleware" array.
In "config/remote.php", replace 'LARAVEL_REMOTE_KEY' with your generated key in Laravel Remote Dashboard.
return [ 'key' => env('LARAVEL_REMOTE_KEY'), 'url' => env('LARAVEL_REMOTE_URL') ];
Step 2 (Required for Database Backups feature)
Configure your config/database.php as follows to enable Backups of your database.
'connections' => [
'mysql' => [
'dump_command_path' => '/path/to/the/binary', // only the path, so without 'mysqldump' or 'pg_dump'
'dump_command_timeout' => 60 * 5, // 5 minute timeout
'dump_using_single_transaction' => true, // perform dump using a single transaction
'driver' => 'mysql',
...
],
For more information regarding Database backups visit: https://docs.spatie.be/laravel-backup/v3/introduction
Step 3 (Required for Failed Job Notification feature)
In "config/remote.php", replace 'LARAVEL_REMOTE_URL' with base URL of Laravel Remote Dashboard (without trailing /). e.g: http://laravel-remote.com
return [ 'key' => env('LARAVEL_REMOTE_KEY'), 'url' => env('LARAVEL_REMOTE_URL') ];
Add following entry in $listen array of App\Providers\EventServiceProvider.
protected $listen = [ LaravelRemoteJobFailed::class => [ ListenLaravelRemoteJobFailed::class, ], ... ];
Override failed() method in your job classes i.e. in app/Jobs directory as follows.
public function failed() { $data = ['job' => class_basename($this)]; event(new LaravelRemoteJobFailed($data)); ... }
That's it.
Usage
Use Laravel Remote Dashboard to manage your Apps. Enjoy!
Change log
Please see CHANGELOG for more information what has changed recently.
Testing
$ composer test
Contributing
Please see CONTRIBUTING and CONDUCT for details.
Security
If you discover any security related issues, please email :author_email instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.