├── LICENSE
├── README.md
├── composer.json
└── src
├── Assets
├── bootstrap-icons.min.css
├── bootstrap.min.css
├── fonts
│ ├── bootstrap-icons.woff
│ └── bootstrap-icons.woff2
└── style.css
├── Components
├── InstallError.php
├── InstallInput.php
└── InstallSelect.php
├── Config
└── install.php
├── Controllers
├── DatabaseConyroller.php
└── InstallerController.php
├── InstallerServiceProvider.php
├── Main
├── DatabaseManager.php
├── EnvironmentManager.php
├── InstalledManager.php
├── PermissionsChecker.php
└── RequirementsChecker.php
├── Middleware
└── InstallMiddleware.php
├── Views
├── account.blade.php
├── app-layout.blade.php
├── components
│ ├── install-error.blade.php
│ ├── install-input.blade.php
│ └── install-select.blade.php
├── database-import.blade.php
├── finish.blade.php
├── index.blade.php
└── step.blade.php
└── routes.php
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2024 eramitgupta
4 |
5 | Permission is hereby granted, free of charge, to anyone obtaining a copy
6 | of this software and its associated documentation files (the "InstallerErag"), to use,
7 | copy, modify, merge, publish, distribute, sublicense, and/or sell copies
8 | of the Software. People using the software are allowed to do so under the following conditions:
9 |
10 | 1. The original copyright notice and this permission notice must be included in all copies
11 | or substantial portions of the Software.
12 |
13 | 2. If you use this code to create new software, it should not be an exact or substantially similar copy.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED. THE AUTHORS OR COPYRIGHT HOLDERS ARE NOT LIABLE FOR ANY CLAIM, DAMAGES,
17 | OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE,
18 | ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF THE SOFTWARE.
19 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | ## Laravel Installer: Easy & User-Friendly
2 |
3 |
4 |
5 | InstallerErag packages can be seamlessly integrated into any Laravel project. Designed for simplicity, this package allows you to dynamically configure essential settings such as:
6 |
7 | - Minimum PHP version required
8 | - PHP execution
9 | - Default Laravel folder permissions
10 | - `.env` file setup
11 | - Custom account form
12 |
13 | Additionally, InstallerErag automates database migrations and seeding processes.
14 |
15 | 
16 |
17 | ## Getting Started
18 |
19 | Install the package via Composer:
20 |
21 | ```bash
22 | composer require erag/installererag
23 | ```
24 |
25 | ### Step 1: Register the Service Provider
26 |
27 | #### Laravel 11.x
28 |
29 | Ensure the service provider is registered in `/bootstrap/providers.php`:
30 |
31 | ```php
32 | return [
33 | // ...
34 | InstallerErag\InstallerServiceProvider::class
35 | ];
36 | ```
37 |
38 | #### Laravel 10.x
39 |
40 | Add the service provider to `config/app.php`:
41 |
42 | ```php
43 | 'providers' => [
44 | // ...
45 | InstallerErag\InstallerServiceProvider::class,
46 | ];
47 | ```
48 |
49 | ### Step 2: Publish Vendor Files
50 |
51 | Run the following command to publish the necessary assets:
52 |
53 | ```bash
54 | php artisan vendor:publish --tag=InstallerErag --force
55 | ```
56 |
57 | ### Step 3: Start Installation
58 |
59 | Navigate to your installation URL:
60 |
61 | ```bash
62 | https://yourdomain.com/install-app
63 | ```
64 |
65 | ### Step 4: Set Folder Permissions
66 |
67 | Ensure the appropriate file or directory permissions with:
68 |
69 | ```bash
70 | sudo chmod -R 775 directory_name
71 | ```
72 |
73 | ## Customizing Requirements and Permissions
74 |
75 | To customize PHP requirements or folder permissions, edit `yourProject/config/install.php`:
76 |
77 | ```php
78 | 'requirements' => [
79 | // Add or remove PHP extensions as needed
80 | ],
81 | 'permissions' => [
82 | // Add or remove folder permissions as needed
83 | ]
84 | ```
85 |
86 | ## Adding Dynamic `.env` Variables
87 |
88 | To add new `.env` variables dynamically, modify `yourProject/config/install.php` like so:
89 |
90 | ```php
91 | 'needed="34dsf24bcgf"' . "\n" .
92 | 'apikey="123456"',
93 | ```
94 |
95 | ## Inserting Dynamic Fields to the Account Form
96 |
97 | To add extra fields to the account form:
98 |
99 | 1. Navigate to `resources/views/vendor/account.blade.php`.
100 | 2. Add the following code for a new field (e.g., phone number):
101 |
102 | ```html
103 |