README

Fusion Framework adalah framework PHP modern dengan arsitektur modular yang powerful. Dibangun dengan PHP 8.0+ dan mengikuti standar PSR-4 untuk performa dan maintainability yang optimal.

🚀 Tentang Fusion Framework

Fusion Framework adalah framework PHP modern yang dirancang untuk developer yang menginginkan:

Modern PHP 8.0+ - Menggunakan fitur terbaru PHP untuk performa optimal
PSR-4 Compliant - Standar autoloading yang professional
Modular Architecture - Arsitektur yang scalable dan maintainable
Enterprise Queue System - 6 driver queue untuk berbagai kebutuhan
Clean MVC Pattern - Controller, Model, Service, Repository yang mudah dipahami
Comprehensive CLI - Command line tools yang powerful
Production Ready - Siap untuk development hingga production

Contoh konfigurasi .env dasar:

APP_NAME=FusionFramework
APP_ENV=development
APP_DEBUG=true
APP_URL=http://localhost
QUEUE_DRIVER=file

🎯 Fitur Utama

Core Features:

Modern PHP 8.0+ - Menggunakan fitur terbaru PHP
PSR-4 Autoloading - Standar professional untuk autoloading
Modular Architecture - Arsitektur yang scalable dan maintainable
Clean MVC Pattern - Controller, Model, Service, Repository
Enterprise Queue System - 6 driver queue (sync, file, redis, beanstalk, rabbitmq, sqs)
Comprehensive CLI - Command line tools yang powerful
Database Migrations - Sistem migrasi yang robust
Caching System - Multi-driver cache support
Authentication - Complete auth system
Plugin System - Extensible architecture
Security Features - CSRF, XSS protection, input validation
Performance Optimized - Built-in benchmarking tools

📊 System Requirements

Requirement	Minimum	Recommended
PHP Version	8.0+	8.1+
Memory	128MB	256MB+
Extensions	PDO, JSON, OpenSSL	All standard extensions
Database	MySQL 5.7+, SQLite 3, PostgreSQL 10+	MySQL 8.0+, PostgreSQL 13+
OS	Linux, macOS, Windows	Linux (production)
Web Server	Apache, Nginx	Nginx (production)

🚀 Quick Start

Installation

Clone Repository

git clone https://github.com/mwpn/fusion-framework.git
cd fusion-framework

Install Dependencies

composer install

Environment Setup

cp env.example .env
# Edit .env sesuai kebutuhan Anda
php fusion key:generate

Database Setup (Optional)

php fusion migrate
php fusion db:seed

Start Development Server

php fusion serve

Access Application

http://localhost:8000

Application Initialization

<?php
// public/index.php
use Fusion\Application;

// Recommended way - clean and simple
$app = Application::boot();
$app->run();

// Alternative alias method
$app = Application::create();
$app->run();

Create Your First Module

# Create a new module
php fusion make:module Blog

# Create controller
php fusion make:controller PostController Blog

# Create model
php fusion make:model Post Blog

# Create service
php fusion make:service PostService Blog

# Create repository
php fusion make:repository PostRepository Blog

Available Commands

Core Commands:

php fusion help                    # Show help
php fusion serve                   # Start server
php fusion migrate                 # Run migrations
php fusion migrate:status          # Show migration status
php fusion db:seed                 # Run seeders

Code Generation:

php fusion make:controller <name> [module]  # Create controller
php fusion make:model <name> [module]       # Create model
php fusion make:service <name> [module]     # Create service
php fusion make:repository <name> [module]  # Create repository
php fusion make:module <name>               # Create module
php fusion make:middleware <name>           # Create middleware
php fusion make:job <name>                  # Create job

Queue Commands:

php fusion queue:work [--driver=driver]     # Start queue worker
php fusion queue:push <job> [--driver=driver] # Push job to queue
php fusion queue:failed [--driver=driver]   # Show failed jobs
php fusion queue:retry <job-id> [--driver=driver] # Retry failed job
php fusion queue:clear [--driver=driver]    # Clear queue
php fusion queue:drivers                    # Show available drivers

Advanced Commands:

php fusion plugin:list             # List plugins
php fusion plugin:install <name>   # Install plugin
php fusion benchmark               # Run benchmarks
php fusion optimize                # Optimize app
php fusion cache:clear             # Clear cache
php fusion config:cache            # Cache config

Create Your First Module

# Create a new module
php fusion make:module Blog

# Create controller
php fusion make:controller PostController Blog

# Create model
php fusion make:model Post Blog

# Create service
php fusion make:service PostService Blog

# Create repository
php fusion make:repository PostRepository Blog

Mode Usage Examples

Lite Mode - Simple Blog:

// app/modules/Blog/Controllers/PostController.php
<?php
namespace App\Modules\Blog\Controllers;

use Fusion\Controller;

class PostController extends Controller
{
    public function index()
    {
        $posts = $this->service('PostService')->all();
        return $this->view('blog.index', compact('posts'));
    }
}

Enterprise Mode - Advanced Features:

// app/modules/Blog/Controllers/PostController.php
<?php
namespace App\Modules\Blog\Controllers;

use Fusion\Controller;

class PostController extends Controller
{
    public function index()
    {
        // Use cache in enterprise mode
        $posts = $this->cache->remember('posts', 3600, function() {
            return $this->service('PostService')->all();
        });

        return $this->view('blog.index', compact('posts'));
    }
}

Mode Detection in Code:

// Check current mode
$app = \Fusion\Application::getInstance();
$mode = $app->getMode();

if ($mode === 'enterprise') {
    // Use enterprise features
    $this->cache->put('key', 'value');
    $this->auth->check();
} else {
    // Use lite features
    $this->service('UserService')->all();
}

Migration Guide

From Lite to Enterprise:

# 1. Update .env
echo "APP_MODE=enterprise" >> .env

# 2. Install additional dependencies (if needed)
composer install

# 3. Run enterprise commands
php fusion enterprise optimize
php fusion enterprise benchmark

From Enterprise to Lite:

# 1. Update .env
echo "APP_MODE=lite" >> .env

# 2. Remove enterprise-specific code
# - Remove cache usage
# - Remove auth checks
# - Remove plugin calls

Performance Comparison

Lite Mode Performance:

Memory Usage: ~2MB
Startup Time: ~50ms
Commands: 15 basic commands
Dependencies: Minimal
Best for: Learning, prototyping, small apps

Enterprise Mode Performance:

Memory Usage: ~5MB
Startup Time: ~100ms
Commands: 25+ advanced commands
Dependencies: Full
Best for: Production, enterprise, large apps

Best Practices

Choose Lite Mode When:

Learning PHP frameworks
Building simple websites
Prototyping applications
Working with limited resources
Need fast development

Choose Enterprise Mode When:

Building production applications
Need advanced features (cache, auth, plugins)
Working with large teams
Building SaaS applications
Need performance optimization

Troubleshooting

Mode Not Switching:

# Clear application cache
php fusion cache:clear

# Reset application instance
php fusion enterprise help

Command Not Available:

# Check current mode
php fusion help

# Force enterprise mode
php fusion enterprise <command>

Performance Issues:

# Optimize for production
php fusion enterprise optimize

# Run benchmarks
php fusion enterprise benchmark

Basic Usage

Application Initialization:

use Fusion\Application;

// Recommended way - using static factory method
$app = Application::boot();
$app->run();

// Alternative alias method
$app = Application::create();
$app->run();

// Legacy method (still works but not recommended)
$app = Application::getInstance();
$app->run();

Controller Example:

<?php
namespace App\Modules\Blog\Controllers;

use Fusion\Controller;
use Fusion\Request;
use Fusion\Response;

class PostController extends Controller
{
    public function index(Request $request): Response
    {
        $posts = $this->service('PostService')->getAllPosts();
        return $this->view('Blog.post.index', ['posts' => $posts]);
    }

    public function show(Request $request): Response
    {
        $id = $request->input('id');
        $post = $this->service('PostService')->getPost($id);
        return $this->json($post);
    }
}

Model Example:

<?php
namespace App\Modules\Blog\Models;

use Fusion\Model;

class Post extends Model
{
    protected $table = 'posts';
    protected $fillable = ['title', 'content', 'status'];

    public function scopePublished($query)
    {
        return $query->where('status', 'published');
    }
}

Service Example:

<?php
namespace App\Modules\Blog\Services;

use Fusion\Service;

class PostService extends Service
{
    public function getAllPosts()
    {
        return $this->repository('PostRepository')->findAll();
    }

    public function createPost($data)
    {
        $validation = $this->validate($data, [
            'title' => 'required|string|max:255',
            'content' => 'required|string'
        ]);

        if (empty($validation)) {
            return $this->repository('PostRepository')->create($data);
        }

        return false;
    }
}

📁 Struktur Folder

fusion/
├── src/                      ← Core framework (PSR-4 compliant)
│   ├── Application.php
│   ├── Autoloader.php
│   ├── Container.php
│   ├── Router.php
│   ├── Request.php
│   ├── Response.php
│   ├── Controller.php
│   ├── Model.php
│   ├── Service.php
│   ├── Repository.php
│   ├── Middleware.php
│   ├── Security.php
│   ├── Config.php
│   ├── Logger.php
│   ├── Console.php
│   ├── Database/
│   │   ├── Connection.php
│   │   ├── QueryBuilder.php
│   │   ├── Migration.php
│   │   └── Migrator.php
│   ├── Session/
│   │   └── SessionManager.php
│   ├── Cache/
│   │   ├── CacheManager.php
│   │   ├── CacheInterface.php
│   │   ├── FileCache.php
│   │   └── ArrayCache.php
│   ├── Auth/
│   │   ├── AuthManager.php
│   │   └── UserProvider.php
│   ├── Plugin/
│   │   ├── PluginInterface.php
│   │   └── PluginManager.php
│   ├── Queue/
│   │   ├── Job.php
│   │   ├── QueueManager.php
│   │   ├── QueueDriverInterface.php
│   │   └── Drivers/
│   │       ├── SyncQueueDriver.php
│   │       ├── FileQueueDriver.php
│   │       ├── RedisQueueDriver.php
│   │       ├── BeanstalkQueueDriver.php
│   │       ├── RabbitMQQueueDriver.php
│   │       └── SqsQueueDriver.php
│   └── Benchmark/
│       └── BenchmarkRunner.php
├── app/                      ← Application code
│   ├── modules/
│   │   └── {Module}/
│   │       ├── Controllers/
│   │       ├── Models/
│   │       ├── Services/
│   │       ├── Repositories/
│   │       ├── Views/
│   │       └── routes.php
│   └── Middleware/
├── config/
│   ├── app.php
│   ├── database.php
│   └── queue.php
├── plugins/                  ← Plugin modules
│   ├── Payment/
│   │   └── Payment.php
│   └── Queue/
│       └── Queue.php
├── storage/
│   ├── logs/
│   ├── cache/
│   └── queue/
├── database/
│   ├── migrations/
│   ├── seeders/
│   └── factories/
├── public/
│   ├── index.php
│   └── .htaccess
├── tests/
├── vendor/
├── fusion                    ← CLI executable
├── bootstrap.php
├── composer.json
├── phpunit.xml
├── .gitignore
└── README.md

🛠️ Instalasi

1. Clone Repository

git clone <repository-url> fusion-framework
cd fusion-framework

2. Install Dependencies

composer install

3. Setup Environment

cp .env.example .env
# Edit file .env sesuai konfigurasi Anda

4. Set Permissions

chmod +x fusion
chmod -R 755 storage/

5. Start Development Server

# Menggunakan CLI tool
./fusion serve

# Atau menggunakan PHP built-in server
php -S localhost:8000 -t public

📖 Penggunaan

1. Membuat Module Baru

# Menggunakan Fusion CLI (recommended)
./fusion make:module Blog

# Create module
./fusion make:module Blog

2. Membuat Komponen

# Controller
./fusion make:controller PostController Blog

# Model
./fusion make:model Post Blog

# Service
./fusion make:service PostService Blog

# Repository
./fusion make:repository PostRepository Blog

# Middleware
./fusion make:middleware AuthMiddleware

# Create components
./fusion make:controller PostController Blog

3. Routing

// app/modules/Blog/routes.php
use Fusion\Router;

$router = new Router();

// Basic routes
$router->get('/posts', 'Blog\Controllers\PostController@index');
$router->post('/posts', 'Blog\Controllers\PostController@store');
$router->get('/posts/{id}', 'Blog\Controllers\PostController@show');

// Route groups
$router->group(['prefix' => '/api', 'middleware' => ['AuthMiddleware']], function($router) {
    $router->get('/posts', 'Blog\Controllers\PostController@index');
    $router->post('/posts', 'Blog\Controllers\PostController@store');
});

4. Controller (Fusion Style)

<?php
namespace App\Modules\Blog\Controllers;

use Fusion\Controller;
use Fusion\Request;
use Fusion\Response;

class PostController extends Controller
{
    public function index(Request $request): Response
    {
        $posts = $this->service('PostService')->getAllPosts();
        return $this->view('Blog.post.index', ['posts' => $posts]);
    }

    public function store(Request $request): Response
    {
        $data = $request->input();
        $post = $this->service('PostService')->createPost($data);
        return $this->success($post, 'Post created successfully');
    }

    // Alternative view method
    public function renderView(string $view, array $data = []): void
    {
        $this->render($view, $data);
    }
}

5. Model (Fusion Style)

<?php
namespace App\Modules\Blog\Models;

use Fusion\Model;

class Post extends Model
{
    protected $table = 'posts';
    protected $fillable = ['title', 'content', 'slug', 'published'];

    // Standard methods
    public static function all(): array
    {
        return parent::all();
    }

    // Alternative method
    public static function findAll(): array
    {
        return static::all();
    }

    public static function findById($id)
    {
        return static::find($id);
    }

    public static function findBy(string $column, $value)
    {
        return static::firstWhere($column, '=', $value);
    }
}

6. Service (Fusion Style)

<?php
namespace App\Modules\Blog\Services;

use Fusion\Service;

class PostService extends Service
{
    public function getAllPosts(): array
    {
        return $this->repository('PostRepository')->all();
    }

    public function createPost(array $data)
    {
        // Validation
        $errors = $this->validate($data, [
            'title' => 'required|min:3|max:255',
            'content' => 'required|min:10'
        ]);

        if (!empty($errors)) {
            throw new \Exception('Validation failed: ' . implode(', ', $errors));
        }

        // Sanitize data
        $data = $this->sanitize($data);

        return $this->repository('PostRepository')->create($data);
    }
}

7. Repository (Fusion Style)

<?php
namespace App\Modules\Blog\Repositories;

use Fusion\Repository;

class PostRepository extends Repository
{
    protected $table = 'posts';
    protected $primaryKey = 'id';

    // Standard methods
    public function all(): array
    {
        return parent::all();
    }

    // Alternative method
    public function findAll(): array
    {
        return $this->all();
    }

    public function findById($id): ?array
    {
        return $this->find($id);
    }

    public function findBy(string $column, $value): ?array
    {
        $stmt = $this->db->prepare("SELECT * FROM {$this->table} WHERE {$column} = ?");
        $stmt->execute([$value]);
        return $stmt->fetch(\PDO::FETCH_ASSOC) ?: null;
    }
}

🔧 CLI Commands

Fusion Commands (Recommended)

# Development
./fusion serve [host] [port]
./fusion migrate
./fusion migrate:rollback
./fusion migrate:reset
./fusion migrate:status

# Code Generation
./fusion make:controller <ControllerName> [Module]
./fusion make:model <ModelName> [Module]
./fusion make:service <ServiceName> [Module]
./fusion make:repository <RepositoryName> [Module]
./fusion make:middleware <MiddlewareName>
./fusion make:module <ModuleName>

# Project Management
./fusion new <template> <project-name>
./fusion benchmark [url] [concurrency] [requests]

# Plugin Management
./fusion plugin:list
./fusion plugin:install <plugin-name>
./fusion plugin:uninstall <plugin-name>
./fusion plugin:activate <plugin-name>
./fusion plugin:deactivate <plugin-name>

All Commands

# Development
./fusion serve [host] [port]
./fusion migrate
./fusion make:controller <ControllerName> [Module]
./fusion make:model <ModelName> [Module]
./fusion make:service <ServiceName> [Module]
./fusion make:repository <RepositoryName> [Module]
./fusion make:middleware <MiddlewareName>
./fusion make:module <ModuleName>

🔒 Security Features

CSRF Protection - Automatic CSRF token generation and validation
XSS Protection - Input sanitization and output escaping
Password Hashing - Secure password hashing using PHP's password_hash()
Rate Limiting - Built-in rate limiting functionality
Security Headers - Automatic security headers in responses
Session Security - Secure session management with configurable options
Input Validation - Built-in validation with custom rules

📝 Logging

// Menggunakan logger
$this->logger()->info('User logged in', ['user_id' => $userId]);
$this->logger()->error('Database error', ['error' => $errorMessage]);

// Alternative logging
$this->log('User action performed', 'info');

🗄️ Database & Migrations

// Query Builder
$users = User::query()
    ->where('active', true)
    ->orderBy('created_at', 'desc')
    ->limit(10)
    ->get();

Database Configuration

Fusion Framework mendukung multiple database drivers:

# SQLite (Default untuk development)
DB_CONNECTION=sqlite
DB_DATABASE=database.sqlite

# MySQL
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=fusion_framework
DB_USERNAME=root
DB_PASSWORD=

# PostgreSQL
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=fusion_framework
DB_USERNAME=postgres
DB_PASSWORD=your_password

Migration Commands

Command	Deskripsi
`php fusion migrate`	Menjalankan semua migration yang pending
`php fusion migrate:status`	Menampilkan status migration dalam bentuk tabel
`php fusion migrate:rollback`	Rollback migration terakhir
`php fusion migrate:reset`	Reset semua migration

Contoh Output migrate:status

Migration Status:
================
=====================================================
Migration                         Status     Batch
=====================================================
20231201120000_create_users_table ✓ Ran    1
20231201130000_create_posts_table ✗ Pending -
=====================================================

🚀 Queue System

Fusion Framework menyediakan sistem queue yang powerful dengan multiple drivers untuk menangani background jobs.

Queue Configuration

# .env configuration
QUEUE_DRIVER=file          # sync | file | redis
QUEUE_PATH=storage/queue   # Path untuk file driver
QUEUE_RETRY_AFTER=90       # Retry delay in seconds
QUEUE_MAX_TRIES=3          # Maximum retry attempts
QUEUE_TIMEOUT=60           # Job timeout in seconds

Queue Drivers

Driver	Deskripsi	Use Case	Dependencies
`sync`	Eksekusi langsung	Development, testing	-
`file`	Simpan ke file JSON	Production tanpa Redis	-
`redis`	Menggunakan Redis	High-performance production	`predis/predis`
`beanstalk`	Menggunakan Beanstalk	Simple queue system	`pheanstalk/pheanstalk`
`rabbitmq`	Menggunakan RabbitMQ	Enterprise messaging	`php-amqplib/php-amqplib`
`sqs`	Menggunakan Amazon SQS	Cloud-based queue	`aws/aws-sdk-php`

Queue Commands

Command	Deskripsi
`php fusion queue:push JobClass [--driver=driver]`	Push job ke queue
`php fusion queue:work [--driver=driver]`	Jalankan worker (consume jobs)
`php fusion queue:failed [--driver=driver]`	Tampilkan failed jobs
`php fusion queue:retry JobID [--driver=driver]`	Retry failed job
`php fusion queue:clear [--driver=driver]`	Clear semua jobs
`php fusion queue:drivers`	Tampilkan driver yang tersedia

Membuat Job

<?php
// app/Jobs/SendEmailJob.php
namespace App\Jobs;

use Fusion\Queue\Job;

class SendEmailJob extends Job
{
    public function handle(): void
    {
        $email = $this->data['email'] ?? 'user@example.com';
        $subject = $this->data['subject'] ?? 'Welcome!';

        echo "Sending email to {$email}\n";
        echo "Subject: {$subject}\n";

        // Your email sending logic here
    }
}

Menggunakan Queue

// Push job ke queue
$queue = $this->queue();
$queue->push(SendEmailJob::class, [
    'email' => 'user@example.com',
    'subject' => 'Welcome!'
]);

// Push dengan delay
$queue->push(SendEmailJob::class, $data, 60); // 60 seconds delay

Setup Driver

Redis Driver

# Install Predis
composer require predis/predis

# Konfigurasi .env
QUEUE_DRIVER=redis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_DATABASE=0
REDIS_PASSWORD=
QUEUE_REDIS_QUEUE=fusion_jobs

Beanstalk Driver

# Install Pheanstalk
composer require pheanstalk/pheanstalk

# Install Beanstalk server
# Ubuntu/Debian: sudo apt-get install beanstalkd
# macOS: brew install beanstalkd

# Konfigurasi .env
QUEUE_DRIVER=beanstalk
BEANSTALK_HOST=127.0.0.1
BEANSTALK_PORT=11300
BEANSTALK_QUEUE=fusion_jobs

RabbitMQ Driver

# Install PhpAmqpLib
composer require php-amqplib/php-amqplib

# Install RabbitMQ server
# Ubuntu/Debian: sudo apt-get install rabbitmq-server
# macOS: brew install rabbitmq

# Konfigurasi .env
QUEUE_DRIVER=rabbitmq
RABBITMQ_HOST=127.0.0.1
RABBITMQ_PORT=5672
RABBITMQ_USER=guest
RABBITMQ_PASS=guest
RABBITMQ_QUEUE=fusion_jobs

Amazon SQS Driver

# Install AWS SDK
composer require aws/aws-sdk-php

# Konfigurasi .env
QUEUE_DRIVER=sqs
AWS_KEY=your-aws-access-key
AWS_SECRET=your-aws-secret-key
AWS_REGION=ap-southeast-1
SQS_QUEUE_URL=https://sqs.ap-southeast-1.amazonaws.com/123456789012/your-queue
SQS_FAILED_QUEUE_URL=https://sqs.ap-southeast-1.amazonaws.com/123456789012/your-queue-failed

Contoh Penggunaan

# Lihat driver yang tersedia
php fusion queue:drivers

# Push job dengan driver tertentu
php fusion queue:push "App\Jobs\SendEmailJob" '{"email":"user@example.com"}' --driver=redis

# Jalankan worker dengan driver tertentu
php fusion queue:work --driver=file

# Lihat failed jobs dengan driver tertentu
php fusion queue:failed --driver=redis

# Retry failed job dengan driver tertentu
php fusion queue:retry job_1234567890 --driver=file

# Clear queue dengan driver tertentu
php fusion queue:clear --driver=redis

🔐 Authentication

// Login user
$auth = $this->auth();
$auth->attempt(['email' => $email, 'password' => $password]);

// Check authentication
if ($auth->check()) {
    $user = $auth->user();
}

// Logout
$auth->logout();

💾 Session & Cache

// Session
$this->session()->set('key', 'value');
$value = $this->session()->get('key');

// Cache
$this->cache()->set('key', 'value', 3600);
$value = $this->cache()->get('key');

🔌 Plugin System

// Plugin management
./fusion plugin:list
./fusion plugin:install Payment
./fusion plugin:activate Payment

// Create custom plugin
class MyPlugin implements PluginInterface {
    public function getName(): string {
        return 'MyPlugin';
    }
    // ... implement other methods
}

📊 Benchmarking

Fusion Framework menyediakan built-in benchmarking tools untuk mengukur performa aplikasi:

# Run basic performance benchmarks
./fusion benchmark

# HTTP load testing dengan custom parameters
./fusion benchmark http://localhost:8000 10 100

# Benchmark dengan concurrency tinggi
./fusion benchmark http://localhost:8000 50 1000

# Benchmark database operations
./fusion benchmark --type=database

# Benchmark queue operations
./fusion benchmark --type=queue

Benchmark Features:

HTTP Load Testing - Test endpoint dengan berbagai concurrency
Database Performance - Measure CRUD operations
Queue Performance - Test queue push/pop operations
Memory Usage - Monitor memory consumption
Response Time - Measure latency dan throughput
Concurrent Users - Simulate multiple users

⚙️ Konfigurasi

Framework menggunakan file konfigurasi di folder config/ dan environment variables dari file .env.

// Mengakses config
$appName = $this->config()->get('app.name');
$dbHost = $this->config()->get('database.connections.mysql.host');

🧪 Testing

# Run tests
composer test
# atau
./vendor/bin/phpunit

# Run specific test
./vendor/bin/phpunit tests/ExampleTest.php

🚀 Performance

Fusion Framework dirancang untuk performa tinggi:

Lightweight Core - Minimal overhead
Query Builder - Optimized database queries
Caching System - Built-in caching untuk performa
Memory Efficient - Optimized memory usage
Benchmark Tools - Built-in performance measurement

Benchmark Results

Test Environment:

PHP 8.1.0
8GB RAM
Intel i7-10700K
Ubuntu 20.04 LTS

Basic Routing Performance:

Test: Simple Route (GET /)
Requests: 10,000
Concurrency: 100
Duration: 2.3s
RPS: 4,347
Avg Latency: 23ms
95th Percentile: 45ms
Memory Usage: 2.1MB

Database Operations:

Test: Model CRUD Operations
Requests: 5,000
Concurrency: 50
Duration: 3.8s
RPS: 1,315
Avg Latency: 38ms
95th Percentile: 72ms
Memory Usage: 3.2MB

Queue Performance:

Test: Queue Push/Pop (File Driver)
Operations: 10,000
Duration: 1.2s
Ops/sec: 8,333
Avg Latency: 12ms
Memory Usage: 1.8MB

Cache Performance:

Test: Cache Set/Get (File Cache)
Operations: 20,000
Duration: 0.8s
Ops/sec: 25,000
Avg Latency: 4ms
Memory Usage: 1.5MB

Memory Usage Comparison:

Framework Startup:
- Fusion Framework: 2.1MB
- Laravel: 8.5MB
- CodeIgniter 4: 3.2MB
- Symfony: 12.1MB

🔧 Advanced Usage

CLI Commands

Fusion Framework menyediakan CLI yang comprehensive:

# Development
php fusion serve [host] [port]     # Start development server
php fusion tinker                   # Interactive shell

# Database
php fusion migrate                  # Run migrations
php fusion migrate:rollback         # Rollback last migration
php fusion migrate:reset            # Reset all migrations
php fusion migrate:status           # Show migration status
php fusion db:seed                  # Run database seeders

# Code Generation
php fusion make:controller <name> [module]  # Create controller
php fusion make:model <name> [module]       # Create model
php fusion make:service <name> [module]     # Create service
php fusion make:repository <name> [module]  # Create repository
php fusion make:middleware <name>            # Create middleware
php fusion make:module <name>                # Create module
php fusion make:seeder <name>                # Create seeder
php fusion make:factory <name>               # Create factory
php fusion make:request <name>               # Create form request
php fusion make:job <name>                   # Create job

# Configuration
php fusion key:generate             # Generate application key
php fusion config:cache             # Cache configuration
php fusion cache:clear              # Clear application cache
php fusion optimize                 # Optimize application

# Routing
php fusion route:list               # List all routes

# Queue
php fusion queue:work               # Start queue worker
php fusion queue:restart            # Restart queue workers

# Storage
php fusion storage:link             # Create storage link

# Plugin Management
php fusion plugin:list              # List installed plugins
php fusion plugin:install <name>    # Install plugin
php fusion plugin:uninstall <name>  # Uninstall plugin
php fusion plugin:activate <name>   # Activate plugin
php fusion plugin:deactivate <name> # Deactivate plugin

# Performance
php fusion benchmark [url]          # Run performance benchmarks

# Project Management
php fusion new <template> <name>    # Create new project

Plugin System

Fusion Framework memiliki sistem plugin yang powerful:

<?php
// plugins/MyPlugin/MyPlugin.php
namespace Plugins\MyPlugin;

use Fusion\Plugin\PluginInterface;

class MyPlugin implements PluginInterface
{
    public function boot()
    {
        // Plugin initialization
    }

    public function register()
    {
        // Register services, routes, etc.
    }

    public function activate()
    {
        // Plugin activation logic
    }

    public function deactivate()
    {
        // Plugin deactivation logic
    }
}

Middleware System

<?php
// app/Middleware/AuthMiddleware.php
namespace App\Middleware;

use Fusion\Middleware;
use Fusion\Request;
use Fusion\Response;

class AuthMiddleware extends Middleware
{
    public function handle(Request $request): ?Response
    {
        if (!$this->isAuthenticated($request)) {
            return $this->redirect('/login');
        }

        return null; // Continue to next middleware/controller
    }

    private function isAuthenticated(Request $request): bool
    {
        // Your authentication logic
        return isset($_SESSION['user_id']);
    }
}

Database Migrations

<?php
// database/migrations/20231201120000_create_users_table.php
use Fusion\Database\Migration;

class CreateUsersTable extends Migration
{
    public function up()
    {
        $this->createTable('users', function($table) {
            $table->id();
            $table->string('name');
            $table->string('email')->unique();
            $table->string('password');
            $table->timestamps();

            $table->index('email');
        });
    }

    public function down()
    {
        $this->dropTable('users');
    }
}

Database Seeders

<?php
// database/seeders/UserSeeder.php
class UserSeeder
{
    public function run()
    {
        $users = [
            [
                'name' => 'John Doe',
                'email' => 'john@example.com',
                'password' => password_hash('password', PASSWORD_DEFAULT)
            ],
            [
                'name' => 'Jane Smith',
                'email' => 'jane@example.com',
                'password' => password_hash('password', PASSWORD_DEFAULT)
            ]
        ];

        foreach ($users as $user) {
            // Insert user logic
        }
    }
}

Caching System

<?php
// Using cache in your application
use Fusion\Cache\CacheManager;

$cache = CacheManager::getInstance();

// Store data
$cache->set('key', 'value', 3600); // 1 hour

// Retrieve data
$value = $cache->get('key');

// Check if exists
if ($cache->has('key')) {
    // Do something
}

// Remove data
$cache->forget('key');

// Clear all cache
$cache->flush();

Authentication System

<?php
// Using authentication
use Fusion\Auth\AuthManager;

$auth = AuthManager::getInstance();

// Login user
if ($auth->attempt($email, $password)) {
    // User logged in successfully
}

// Check if user is authenticated
if ($auth->check()) {
    $user = $auth->user();
}

// Logout user
$auth->logout();

// Get current user
$user = $auth->user();

Performance Optimization

# Optimize application
php fusion optimize

# Clear cache
php fusion cache:clear

# Cache configuration
php fusion config:cache

# Run benchmarks
php fusion benchmark

# Run specific benchmark
php fusion benchmark http://localhost:8000 10 100

🎯 Perbandingan dengan Framework Lain

Fitur	Fusion	Laravel	CodeIgniter 4	Symfony
Learning Curve	⭐⭐⭐⭐⭐	⭐⭐	⭐⭐⭐⭐	⭐⭐
Performance	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐
Security	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐
Modularity	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐⭐
CLI Tools	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐
Plugin System	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐	⭐⭐⭐⭐
Benchmarking	⭐⭐⭐⭐⭐	⭐⭐	⭐⭐	⭐⭐
Queue System	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐	⭐⭐⭐

🏆 Keunggulan Fusion Framework

Modern Architecture - Built with PHP 8.0+ and PSR-4 standards
Enterprise-Grade - Siap untuk production dengan fitur lengkap
Developer-Friendly - Mudah dipelajari dan digunakan
High Performance - Optimized untuk kecepatan
Modular Architecture - Scalable dan maintainable
Plugin Ecosystem - Extensible dengan plugin system
Enterprise Queue System - 6 drivers untuk berbagai kebutuhan
Multiple Database Support - MySQL, SQLite, PostgreSQL
Clean Code - Kode yang bersih dan mudah dipahami
Indonesian-First - Dibuat untuk developer Indonesia

📄 Lisensi

Framework ini menggunakan lisensi MIT. Lihat file LICENSE untuk detail lebih lanjut.

🤝 Kontribusi

Kontribusi sangat diterima! Silakan buat issue atau pull request untuk perbaikan dan fitur baru.

📞 Support

Jika Anda memiliki pertanyaan atau butuh bantuan, silakan buat issue di repository ini.

🎉 Getting Started

Install the framework
Run ./fusion migrate to set up the database
Start the server with ./fusion serve
Create your first module with ./fusion make:module YourModule
Start building your application with modern PHP features

🚀 Fusion Framework - Modern PHP Framework

Status: Production Ready & Modern Architecture! 🚀✨

📚 Quick Reference

CLI Commands Summary

# Development (Recommended)
./fusion serve                    # Start server
./fusion migrate                  # Run migrations

# Code Generation (Recommended)
./fusion make:module Blog         # Create module
./fusion make:controller Post     # Create controller

# Project Management (Recommended)
./fusion new blog my-blog         # Create new project
./fusion benchmark                # Run benchmarks
./fusion plugin:list              # List plugins

# All Commands
./fusion serve                   # Start server
./fusion make:controller Post    # Create controller

Core Classes Usage

// Controller
class MyController extends Controller {
    public function index() {
        return $this->view('module.view', $data);  // Standard method
        $this->render('module/view', $data);       // Alternative method
    }
}

// Model
class MyModel extends Model {
    // Both methods work
    MyModel::all();           // Standard method
    MyModel::findAll();       // Alternative method
}

// Service
class MyService extends Service {
    // Enhanced validation
    $errors = $this->validate($data, $rules);
    $clean = $this->sanitize($data);
}

Happy coding with Fusion Framework! 🚀

fusionfw/framework

包简介

README 文档

README

🚀 Tentang Fusion Framework

🎯 Fitur Utama

Core Features:

📊 System Requirements

🚀 Quick Start

Installation

Application Initialization

Create Your First Module

Available Commands

Create Your First Module

Mode Usage Examples

Migration Guide

Performance Comparison

Best Practices

Troubleshooting

Basic Usage

📁 Struktur Folder

🛠️ Instalasi

1. Clone Repository

2. Install Dependencies

3. Setup Environment

4. Set Permissions

5. Start Development Server

📖 Penggunaan

1. Membuat Module Baru

2. Membuat Komponen

3. Routing

4. Controller (Fusion Style)

5. Model (Fusion Style)

6. Service (Fusion Style)

7. Repository (Fusion Style)

🔧 CLI Commands

Fusion Commands (Recommended)

All Commands

🔒 Security Features

📝 Logging

🗄️ Database & Migrations

Database Configuration

Migration Commands

Contoh Output migrate:status

🚀 Queue System

Queue Configuration

Queue Drivers

Queue Commands

Membuat Job

Menggunakan Queue

Setup Driver

Redis Driver

Beanstalk Driver

RabbitMQ Driver

Amazon SQS Driver

Contoh Penggunaan

🔐 Authentication

💾 Session & Cache

🔌 Plugin System

📊 Benchmarking

Benchmark Features:

⚙️ Konfigurasi

🧪 Testing

🚀 Performance

Benchmark Results

🔧 Advanced Usage

CLI Commands

Plugin System

Middleware System

Database Migrations

Database Seeders

Caching System

Authentication System

Performance Optimization

🎯 Perbandingan dengan Framework Lain

🏆 Keunggulan Fusion Framework

📄 Lisensi

🤝 Kontribusi

📞 Support

🎉 Getting Started