Download the PHP package softmax/installer without Composer
On this page you can find all versions of the php package softmax/installer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download softmax/installer
More information about softmax/installer
Files in softmax/installer
Package installer
Short Description Softmax installer package for Laravel apps with complete installation wizard
License MIT
Homepage https://github.com/softmax/installer
Informations about the package installer
SoftMax Installer Package
A comprehensive Laravel installation wizard package that provides a complete setup process for Laravel applications with license validation, system requirements checking, and guided installation flow. Perfect for commercial Laravel applications that need professional installation experience.
Features
- 🔐 License Validation: Integrate with SoftMax core system for license verification
- ⚙️ System Requirements Check: Automatically verify PHP version, extensions, and server requirements
- 📊 Directory Permissions: Check and validate directory write permissions
- 🗄️ Database Configuration: Guided setup and testing for database connections
- 🌍 Environment Setup: Configure essential .env variables securely
- 👤 Admin User Creation: Set up the initial administrator account with role assignment
- 🔄 Migration & Seeding: Run database migrations automatically
- 🔒 Installation Lock: Prevent re-installation and validate encryption keys
- 🎨 Beautiful UI: Modern, responsive installation wizard interface
- 🛡️ Security: CSRF protection, input validation, and secure key storage
- 📡 API Integration: Register installation with core licensing system
Requirements
- PHP 8.1 or higher
- Laravel 10.x or 11.x
- MySQL/MariaDB database
- Required PHP extensions: PDO, OpenSSL, Mbstring, ZIP, XML, cURL, GD, Fileinfo, Tokenizer, JSON
Installation
Install the package via Composer:
If you encounter a minimum stability error, you can install a specific stable version:
For Laravel 10+, the package will automatically register its service provider and middleware.
Quick Start
- Install the package:
If you encounter a minimum stability error, use:
-
Publish the configuration:
-
Configure your environment variables:
- Access the installer:
Navigate to
/softmax-installerin your browser to start the installation process.
Installation Process
The installer follows a comprehensive multi-step process:
- System Check: Verifies if application is already installed
- Requirements Validation: Checks PHP extensions and system requirements
- Permissions Check: Validates directory write permissions
- License Validation: Verifies customer ID and license key with API
- Database Configuration: Tests and configures database connection
- Environment Setup: Configures application name, URL, and essential settings
- Admin Account: Creates the initial administrator user
- Final Installation: Runs migrations and registers with core system
- Completion: Shows success message with launch button
Configuration
The package configuration can be customized in config/softmax-installer.php:
Environment Variables
Add these variables to your .env file:
Usage
Facade Usage
The package provides a convenient facade for checking installation status:
API Endpoints
The installer provides several API endpoints:
GET /softmax-installer/system-info- Get system requirements and permissionsPOST /softmax-installer/validate-license- Validate license credentialsPOST /softmax-installer/test-database- Test database connectionPOST /softmax-installer/install- Complete installation processPOST /softmax-installer/reset- Reset installation (development only)
Middleware
The package automatically applies the RedirectIfNotInstalled middleware to all web routes. This middleware:
- Redirects to installer if application is not installed
- Validates encryption key matches stored key
- Allows access to installer routes and assets
Customization
Publishing Views
Customize the installer's appearance by publishing the view files:
Views will be published to resources/views/vendor/softmax-installer/.
Custom Installation Steps
Extend the InstallerService to add custom installation logic:
Exception Handling
The package includes custom exceptions for different scenarios:
Development
Reset Installation
For development purposes, you can reset the installation:
Testing
Run the package tests:
The package includes comprehensive validation for:
- PHP extension requirements
- Directory permissions
- License validation
- Database connectivity
- Admin user creation
Security
- ✅ License validation with remote API
- ✅ Secure encryption key storage and verification
- ✅ CSRF protection on all forms
- ✅ Input validation and sanitization
- ✅ Production environment restrictions
- ✅ Prevents reinstallation attempts
Integration with Laravel
The package integrates seamlessly with Laravel:
- Service Provider:
InstallerServiceProviderautomatically registers services - Facade:
Installerprovides convenient static methods - Middleware:
RedirectIfNotInstalledprotects your application - Routes: Automatically loaded from
routes/web.php - Views: Responsive UI built with Tailwind CSS and Alpine.js
Code Quality & Analysis
This package includes comprehensive code quality analysis using SonarQube for maintaining the highest standards of code quality.
SonarQube Integration
Setup SonarQube Analysis
-
Create SonarQube Project:
- Set up a project in your SonarQube instance
- Generate a project token
- Note your SonarQube server URL
-
Configure GitHub Secrets:
- Automated Analysis:
- SonarQube analysis runs automatically on push/PR to main/develop branches
- Code coverage is collected and uploaded to SonarQube
- Quality gates are enforced to maintain code standards
Quality Metrics Tracked
- Code Coverage: Minimum 80% coverage required
- Maintainability: Technical debt ratio < 5%
- Reliability: Zero bugs on new code
- Security: Zero vulnerabilities on new code
- Duplications: Maximum 3% duplicated lines
- Code Smells: Clean code principles enforcement
Running Local Analysis
Manual SonarQube Scan
Configuration Files
sonar-project.properties: Main SonarQube configuration.github/workflows/sonarqube.yml: GitHub Actions workflowphpunit.xml: Coverage and testing configuration
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
If you discover a security vulnerability within this package, please send an e-mail to [email protected]. All security vulnerabilities will be promptly addressed.
License
This package is proprietary software owned by SoftMax. Unauthorized distribution is prohibited.
Support
- Documentation: Visit our documentation site
- Email Support: [email protected]
- Issue Tracker: GitHub Issues
Credits
- SoftMax Team
- All Contributors
Made with ❤️ by SoftMax
All versions of installer with dependencies
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/http Version ^10.0|^11.0|^12.0
illuminate/routing Version ^10.0|^11.0|^12.0
illuminate/database Version ^10.0|^11.0|^12.0
illuminate/validation Version ^10.0|^11.0|^12.0
guzzlehttp/guzzle Version ^7.0