Download the PHP package jmrashed/php-installer without Composer

PHP Installer Package

A professional, reusable web installer for any PHP application. Simplify your deployment process with an intuitive step-by-step installation wizard.

✨ Features

• System Requirements Check - Validates PHP version, extensions, and directory permissions
• Database Setup - Automated database creation and schema import
• PHP Migration Support - Execute PHP-based migrations and seeders
• Configuration Management - Generates application config files
• Admin Account Creation - Optional administrator user setup
• Installation Lock - Prevents reinstallation after completion
• CSRF Protection - Secure form handling
• Responsive UI - Bootstrap-powered interface
• Debug Control - Environment-based debug output control
• Error Handling - Comprehensive validation and user feedback

🚀 Quick Start

Installation

Integration

1. Copy the php-installer folder to your project root
2. Create your database schema file at database/db.sql
3. Configure installer settings in config/installer.php
4. Access via browser: http://yourdomain.com/php-installer/

📋 Requirements

• PHP 7.4 or higher
• PDO extension
• MySQL/MariaDB database
• Web server (Apache/Nginx)

🛠️ Configuration

Screenshot

Basic Setup

Edit config/installer.php:

Database Schema

Option 1: SQL Schema File

Place your SQL schema in database/db.sql:

Option 2: PHP Migrations (Recommended)

Create PHP migration files in database/migrations/:

Seeders

Create seeder files in database/seeders/:

📁 Directory Structure

🎯 Usage Example

For Laravel Projects

For Custom PHP Projects

Installation Options

During the database import step, users can choose:

1. Run database migrations & seeders (Recommended)

   • Executes PHP migration files
   • Runs seeder files after migrations
   • Provides detailed logging

2. Use default database schema

   • Imports from database/db.sql
   • Traditional SQL file approach
3. Upload custom SQL file
   • Allows custom .sql or .zip uploads
   • Useful for existing database schemas

🔧 Customization

Debug Control

Control debug output using your application's .env file:

Alternatively, add ?debug=1 to any installer URL for temporary debugging.

Custom Installation Steps

Extend the installer by modifying src/Core/Installer.php:

Migration and Seeder Integration

The installer automatically detects and runs:

• PHP Migrations: Files in database/migrations/*.php
• Seeders: Files in database/seeders/*.php (run after migrations)
• SQL Files: Traditional .sql files as fallback

Custom Templates

Create custom config templates in src/Templates/:

• config_template.php - Application configuration
• env_template.php - Environment variables

📋 Changelog

See CHANGELOG.md for a detailed list of changes and version history.

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Md Rasheduzzaman
Full-Stack Engineer & Technical Project Manager

• Email: [email protected]
• GitHub: @jmrashed
• LinkedIn: Md Rasheduzzaman

🙏 Acknowledgments

• Bootstrap for the responsive UI framework
• PHP community for best practices and standards

📊 Stats

⭐ Star this repository if it helped you!