Files
kulakpos_web/vendor/safiull/laravel-installer/README.md

108 lines
4.9 KiB
Markdown
Raw Normal View History

2026-03-30 14:54:57 +07:00
# 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
2026-04-18 20:32:18 +07:00
* [Laravel 7.x, 8.x, 9.x, 10.x, 11.x, 12+](https://laravel.com/docs/installation)
2026-03-30 14:54:57 +07:00
## 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
![Laravel web installer | Step 1](https://s3-us-west-2.amazonaws.com/github-project-images/laravel-installer/install/1-welcome.jpg)
![Laravel web installer | Step 2](https://s3-us-west-2.amazonaws.com/github-project-images/laravel-installer/install/2-requirements.jpg)
![Laravel web installer | Step 3](https://s3-us-west-2.amazonaws.com/github-project-images/laravel-installer/install/3-permissions.jpg)
![Laravel web installer | Step 4 Menu](https://s3-us-west-2.amazonaws.com/github-project-images/laravel-installer/install/4-environment.jpg)
![Laravel web installer | Step 4 Classic](https://s3-us-west-2.amazonaws.com/github-project-images/laravel-installer/install/4a-environment-classic.jpg)
![Laravel web installer | Step 4 Wizard 1](https://s3-us-west-2.amazonaws.com/github-project-images/laravel-installer/install/4b-environment-wizard-1.jpg)
![Laravel web installer | Step 4 Wizard 2](https://s3-us-west-2.amazonaws.com/github-project-images/laravel-installer/install/4b-environment-wizard-2.jpg)
![Laravel web installer | Step 4 Wizard 3](https://s3-us-west-2.amazonaws.com/github-project-images/laravel-installer/install/4b-environment-wizard-3.jpg)
![Laravel web installer | Step 5](https://s3-us-west-2.amazonaws.com/github-project-images/laravel-installer/install/5-final.jpg)
2026-04-18 20:32:18 +07:00
-->
2026-03-30 14:54:57 +07:00
### 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.
Its 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 youll be creating employment for local families and restoring wildlife habitats.
Read more about Treeware at https://treeware.earth