erag/installererag

Laravel Installer: Simplifies Laravel application installation for a seamless setup experience. Requires PHP 8.0.0+

v1.8.0 2024-10-07 14:54 UTC

Requires

• php: >=8.0.0
• illuminate/support: ^8.12|^9.0|^10.0|^11.0

MIT

• Er Amiit Gupta

• installer
• installation
• laravel
• setup
• laravel package
• laravel Installer

README

InstallerErag packages can be seamlessly integrated into any Laravel project. Designed for simplicity, this package allows you to dynamically configure essential settings such as:

• Minimum PHP version required
• PHP execution
• Default Laravel folder permissions
• .env file setup
• Custom account form

Additionally, InstallerErag automates database migrations and seeding processes.

Getting Started

Install the package via Composer:

composer require erag/installererag

Step 1: Register the Service Provider

Laravel 11.x

Ensure the service provider is registered in /bootstrap/providers.php:

return [
    // ...
    InstallerErag\InstallerServiceProvider::class
];

Laravel 10.x

Add the service provider to config/app.php:

'providers' => [
    // ...
    InstallerErag\InstallerServiceProvider::class,
];

Step 2: Publish Vendor Files

Run the following command to publish the necessary assets:

php artisan vendor:publish --tag=InstallerErag --force

Step 3: Start Installation

Navigate to your installation URL:

https://yourdomain.com/install-app

Step 4: Set Folder Permissions

Ensure the appropriate file or directory permissions with:

sudo chmod -R 775 directory_name

Customizing Requirements and Permissions

To customize PHP requirements or folder permissions, edit yourProject/config/install.php:

'requirements' => [
    // Add or remove PHP extensions as needed
],
'permissions' => [
    // Add or remove folder permissions as needed
]

Adding Dynamic .env Variables

To add new .env variables dynamically, modify yourProject/config/install.php like so:

'needed="34dsf24bcgf"' . "\n" .
'apikey="123456"',

Inserting Dynamic Fields to the Account Form

To add extra fields to the account form:

1. Navigate to resources/views/vendor/account.blade.php.
2. Add the following code for a new field (e.g., phone number):

<div class="col-md-12 mb-3">
    <x-install-input label="Phone Number" required="true" name="phone_number" type="text"
        value="{{ old('phone_number') }}" />
    <x-install-error for="phone_number" />
</div>

1. Update the input tag in yourproject/config/install.php:

'account' => [
    'name' => 'required|string|max:255',
    'email' => 'required|email|unique:users|max:255',
    'password' => 'required|string|min:6',
    'phone_number' => 'required',
]