🦠 Phage - Modern PHP Development Environment

🔒 Sponsorware — Phage becomes 100% open source when we reach 50 sponsors. Become a sponsor →

Phage is a modern, multiplatform PHP development environment built in Go with FrankenPHP integration. Think of it as an open-source alternative to Laravel Herd or Laragon.

✨ Features

🚀 Runtime & Server

• 🚀 FrankenPHP Integration - Lightning-fast PHP 8.4.17 with Caddy server
• 🐘 Multi-PHP Versions - Run PHP 8.4, 8.3, 8.2, 8.1, 8.0, 7.4, 7.3, 7.2, 7.1, 7.0, 5.6 simultaneously
• ⚡ Hybrid Architecture - FrankenPHP for PHP 8.4 performance, PHP-FPM for older versions
• 🎯 Smart Backend Selection - Automatic fallback from FrankenPHP to PHP-FPM when needed
• 🌐 Multi-Project Support - Run multiple PHP projects with different versions simultaneously

🔧 Project Management

• 🔀 Built-in Proxy - Automatic routing via custom .test domains
• 🔧 Auto DNS - Automatic domain resolution (via dnsmasq)
• 👁️ Auto-Detection - Automatically detects new PHP projects in real-time
• ⚡ Auto-Start - Newly detected projects start automatically without restart
• 📋 Project Configuration - Per-project phage.yaml for custom settings
• 🚀 Project Templates - One-click creation: Laravel, Symfony, Laravel + Filament v4, WordPress, CakePHP, Drupal, PHP Vanilla
• 🔌 Port 80 Helper - Optional privileged daemon for native port 80 access

🗄️ Database Support

• 🗄️ MySQL Integration - Built-in MySQL management (no system MySQL required)
• 🐘 PostgreSQL Support - Built-in PostgreSQL with multiple versions
• 📦 SQLite Support - File-based SQLite database management
• 🎛️ Database CLI - Interactive shells for all databases

🐛 Development Tools

• 🐛 Built-in Debugger - Zero-configuration debug system (Phage Debug)
  • Real-time WebSocket-based UI with dark theme
  • Caller tracking (file, line, method)
  • IDE integration (VSCode, PHPStorm one-click navigation)
  • Interactive tree views for complex data structures
  • SQLite persistence for debug history
  • Methods: log(), dump(), table(), json(), http(), exception(), trace(), sql(), measure()
• 📊 Advanced Filtering & Search - Find and analyze debug events
• 💾 Persistent History - Debug data stored in SQLite database

🔗 Sharing & Tunneling (v0.9.1+)

• Public Tunnels - Share projects with team members
  • 🌐 Cloudflare Tunnel - Enterprise-grade tunneling
  • 🏃 Pinggy Tunnel - Fast, lightweight alternative
  • One-click URL copy and browser open
  • Live tunnel status in Dashboard
• 📨 Mailpit Integration - Local email testing without external SMTP
  • Intercept all PHP mail() calls
  • Web-based email viewer
  • Test email delivery in development

👁️ Project Preview (v0.9.1+)

• Live Preview - See project changes in real-time
  • Embedded iframe preview in Sites dashboard
  • Toggle between preview and full browser view
  • Auto-refresh on file changes
  • Works with local ports and tunnel URLs

💻 System & Experience

• 💻 Cross-Platform - macOS, Linux, and Windows support
  • Platform Abstraction Layer - Unified service and DNS management
  • macOS: launchctl + dnsmasq
  • Linux: systemctl + dnsmasq
  • Windows: Windows Services API + hosts file (native, no WSL)
• 📦 Zero Configuration - Works out of the box
• 🔒 No Root Required - Run without sudo after initial setup
• 🎨 Modern UI - Beautiful, intuitive command-line interface

📋 Requirements

• macOS: macOS 12+ (Apple Silicon or Intel)
• Linux: Ubuntu 20.04+ / Debian 11+ / Fedora 35+
• Windows: Windows 10+ (native support via hosts file management)