108 lines
4.9 KiB
Markdown
Executable File
108 lines
4.9 KiB
Markdown
Executable File
# Laravel Web Installer | A Web Installer [Package](https://packagist.org/packages/safiull/laravel-installer)
|
||
|
||
- [About](#about)
|
||
- [Requirements](#requirements)
|
||
- [Installation](#installation)
|
||
- [Routes](#routes)
|
||
- [Usage](#usage)
|
||
- [Contributing](#contributing)
|
||
- [Help](#help)
|
||
- [License](#license)
|
||
<!-- - [Screenshots](#screenshots) -->
|
||
|
||
## About
|
||
|
||
Do you want your clients to be able to install a Laravel project just like they do with WordPress or any other CMS?
|
||
This Laravel package allows users who don't use Composer, SSH etc to install your application just by following the setup wizard.
|
||
The current features are :
|
||
|
||
- Check For Server Requirements.
|
||
- Check For Folders Permissions.
|
||
- Ability to set database information.
|
||
- .env text editor
|
||
- .env form wizard
|
||
- Migrate The Database.
|
||
- Seed The Tables.
|
||
|
||
## Requirements
|
||
|
||
* [Laravel 7.x, 8.x, 9.x, 10.x, 11.x, 12+](https://laravel.com/docs/installation)
|
||
|
||
## Installation
|
||
|
||
1. From your projects root folder in terminal run:
|
||
|
||
```bash
|
||
composer require safiull/laravel-installer
|
||
```
|
||
|
||
2. Register the package
|
||
|
||
* Laravel 5.5 and up
|
||
Uses package auto discovery feature, no need to edit the `config/app.php` file.
|
||
|
||
* Laravel 5.4 and below
|
||
Register the package with laravel in `config/app.php` under `providers` with the following:
|
||
|
||
```php
|
||
'providers' => [
|
||
Safiull\LaravelInstaller\Providers\LaravelInstallerServiceProvider::class,
|
||
];
|
||
```
|
||
|
||
3. Publish the packages views, config file, assets, and language files by running the following from your projects root folder:
|
||
|
||
```bash
|
||
php artisan vendor:publish --tag=laravelinstaller
|
||
```
|
||
|
||
## Routes
|
||
|
||
* `/install`
|
||
|
||
## Usage
|
||
|
||
* **Install Routes Notes**
|
||
* In order to install your application, go to the `/install` route and follow the instructions.
|
||
* Once the installation has ran the empty file `installed` will be placed into the `/storage` directory. If this file is present the route `/install` will abort to the 404 page.
|
||
|
||
* Additional Files and folders published to your project :
|
||
|
||
|File|File Information|
|
||
|:------------|:------------|
|
||
|`config/installer.php`|In here you can set the requirements along with the folders permissions for your application to run, by default the array cotaines the default requirements for a basic Laravel app.|
|
||
|`public/installer/assets`|This folder contains a css folder and inside of it you will find a `main.css` file, this file is responsible for the styling of your installer, you can overide the default styling and add your own.|
|
||
|`resources/views/vendor/installer`|This folder contains the HTML code for your installer, it is 100% customizable, give it a look and see how nice/clean it is.|
|
||
|`lang/en.json`|This file holds all the messages/text, currently only English is available, if your application is in another language, you can copy/past it in your language folder and modify it the way you want.|
|
||
|
||
|
||
<!-- ## Help
|
||
|
||
* Cannot figure it out? Need more help? Here is a video tutorial: [Laravel Installer by Devdojo](https://www.youtube.com/watch?v=Jput5doFYLg) -->
|
||
|
||
<!-- ## Screenshots
|
||
|
||
###### Installer
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
-->
|
||
|
||
### Changelog
|
||
|
||
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
|
||
|
||
## Treeware
|
||
|
||
You're free to use this package, but if it makes it to your production environment I would highly appreciate you buying the world a tree.
|
||
|
||
It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to [plant trees](https://www.bbc.co.uk/news/science-environment-48870920). If you contribute to my forest you’ll be creating employment for local families and restoring wildlife habitats.
|
||
|
||
Read more about Treeware at https://treeware.earth
|