Tipsy PHP Framework v2.0 - Modernized

A lightning-fast PHP micro-framework, modernized for PHP 8.3+

Originally created in 2014-2015, Tipsy has been completely modernized while maintaining its core philosophy: "Small and Fast, but Highly Flexible".

🚀 Performance Results

14.77x Performance Improvement over legacy PHP 5.6 version:

• Legacy (PHP 5.6): 167.46 req/sec
• NextGen (PHP 8.3): 2,474.34 req/sec

⚡ Quick Start

1. Run the Demo

# Start the modernized framework demo
./demo.sh

# Or check status first
./status.sh

Demo will be available at: http://localhost:8080

2. Available Demo URLs

• Main Demo: http://localhost:8080/ (Interactive showcase)
• JSON API: http://localhost:8080/api/test (Framework info)
• User Route: http://localhost:8080/user/123 (Dynamic parameters)
• Collections: http://localhost:8080/looper/demo (Looper demonstration)
• Dependency Injection: http://localhost:8080/injection/demo (Auto-injection)

3. Compare Legacy vs Modern

# Run full performance comparison
./real_comparison.sh

🎯 What's New in v2.0

✅ Fully Modernized Core

• PHP 8.3+ Required - Modern type system, match expressions, attributes
• Strict Types - declare(strict_types=1) in all files
• Performance Optimized - Critical path optimizations, zero legacy code
• Type Safety - Complete return types, union types, nullable types

✅ Legacy Code Eliminated

• ❌ No more call_user_func_array()
• ❌ No more PHP 5.x compatibility hacks
• ❌ No more error suppression @
• ❌ No more outdated function polyfills

✅ Modern PHP Features

• Match Expressions - Replace legacy switch statements
• String Functions - str_starts_with(), str_contains()
• Spread Operators - ...$args for function calls
• Constructor Property Promotion - Where applicable
• Union Types - string|int, callable|string

🏗️ Architecture

Core Components (21 modernized files)

• App.php - Service container with type safety
• Router.php - Performance-optimized routing
• Route.php - Individual route matching (critical path optimized)
• DependencyInjector.php - Modern reflection-based injection
• Request.php - HTTP request handling with match expressions
• View.php - Template engine with layout support
• Resource.php - Active Record ORM with multi-database support
• Looper.php - Collection processing with jQuery-like interface

📖 Quick Examples

Simple Routing

<?php
require 'vendor/autoload.php';

use Tipsy\Tipsy;

$app = new Tipsy();

$app->get('/', function($Request, $View) {
    $View->display('home', ['message' => 'Hello Tipsy v2.0!']);
});

$app->get('/api/users/:id', function($Params, $Response) {
    $user = ['id' => $Params->id, 'name' => 'John Doe'];
    $Response->json($user);
});

$app->run();

Database Resources

// Define a User resource
$app->service('User', [
    '_table' => 'users',
    '_id' => 'id'
]);

// Active Record operations
$user = User::o(1);              // Load by ID
$user->name = 'Updated Name';
$user->save();                   // Save changes

// Query with Looper collections
$admins = User::q('SELECT * FROM users WHERE role = ?', ['admin']);
$admins->each(function() {
    echo $this->name . "\n";
});

Collection Processing

$users = new Looper([
    (object)['name' => 'John', 'role' => 'admin'],
    (object)['name' => 'Jane', 'role' => 'user'],
]);

$admins = $users->filter(['role' => 'admin']);
echo $admins->json(); // JSON output

🐳 Docker Development

NextGen (PHP 8.3)

cd nextgen/baseline
docker-compose up -d
# Available at http://localhost:8080

Legacy Comparison (PHP 5.6)

cd legacy/baseline  
docker-compose up -d
# Available at http://localhost:8081

📁 Project Structure

tipsy/
├── README.md                    # This file
├── demo.sh                      # Quick demo script (./demo.sh)
├── status.sh                    # Check system status (./status.sh)
├── real_comparison.sh          # Performance comparison
├── nextgen/                    # Modernized PHP 8.3+ version
│   ├── src/                    # Framework source code (21 modernized files)
│   ├── baseline/               # Docker demo environment
│   └── composer.json           # Modern dependencies
└── legacy/                     # Original PHP 5.6 version
    ├── src/                    # Legacy source code
    └── baseline/               # Legacy Docker environment

🎯 Philosophy

Tipsy maintains its original philosophy while embracing modern PHP:

1. Small - Minimal dependencies, lightweight core
2. Fast - Performance-first design, optimized critical paths
3. Flexible - Convention over configuration, but configurable
4. Modern - PHP 8.3+ features, strict types, zero legacy code

🔧 Requirements

• PHP 8.3+ (Required)
• Docker (For demo environment)
• Composer (For autoloading)

📊 Benchmarks

Run ./real_comparison.sh to see the dramatic performance improvements:

Legacy (PHP 5.6):  167.46 req/sec,  47.91ms latency
NextGen (PHP 8.3): 2474.34 req/sec,  3.24ms latency
Improvement: 14.77x faster

🤝 Contributing

This is a modernization project showcasing how legacy PHP frameworks can be brought into the modern era while maintaining their core strengths.

📜 License

MIT License - Same as original Tipsy framework

---

Tipsy v2.0 - Proving that legacy frameworks can be modernized for dramatic performance gains while maintaining their essential character.