README

A powerful step-by-step installation wizard for Laravel applications. It simplifies the initial setup process by validating server requirements, configuring the environment, connecting to the database, and completing the application installation through an intuitive interface.

Features

Step-by-step installation wizard
Server requirements validation
File and directory permissions check
Environment configuration
Database configuration
Secure installation lock to prevent reinstallation
Installer reset command for development and testing
Supports Laravel 10.x, 11.x, and 12.x

Requirements

PHP 8.2 or later
Laravel 10.x, 11.x, or 12.x
guzzlehttp/guzzle ^7.0

Installation

Production

Install the package using Composer:

composer require nativecode/laravel-installer:^1.0

Local Development

If you are developing the package locally, add the following repository to your application's composer.json:

"repositories": [
    {
        "type": "path",
        "url": "packages/nativecode/laravel-installer",
        "options": {
            "symlink": true
        }
    }
]

Then install the package:

composer require nativecode/laravel-installer:@dev

Usage

After installing the package, visit the following URL in your browser:

/install

The installation wizard includes the following steps:

Welcome
Server Requirements Check
File Permissions Check
Application Setup
- Purchase Code Validation
- Environment Configuration
- Database Configuration
Installation Complete

Once the installation is finished, a lock file is created at:

storage/installed

This prevents the installer from being accessed again for security reasons.

Reset the Installer

For development or testing, you can reset the installer by removing the installation lock file:

php artisan installer:reset

To skip the confirmation prompt:

php artisan installer:reset --force

Running Tests

composer install
./vendor/bin/phpunit

License

This package is released under the MIT License. See the LICENSE file for more information.

nativecode / laravel-installer

Maintainers

Package info

Statistics

Security