docs

PivotPHP Core v1.1.4 Documentation

Welcome to the complete documentation for PivotPHP Core v1.1.4 - a high-performance, lightweight PHP microframework inspired by Express.js, designed for building APIs and web applications with exceptional speed and simplicity.

🚀 Quick Navigation

Essential Guides

• Quick Start - Get running in 5 minutes
• API Reference - Complete API documentation
• Migration Guide - Upgrading from previous versions

Core Guides

• Architecture Guide - v1.1.3 architecture overview
• Performance Guide - Optimization and benchmarks
• Testing Guide - Testing strategies and examples

Reference Materials

• Examples Catalog - Complete examples collection
• Middleware Reference - All available middleware
• Routing Reference - Routing patterns and constraints
• Configuration Reference - Framework configuration

📚 Learning Paths

👶 Beginner Path (New to PivotPHP)

1. Quick Start - Basic setup and hello world
2. Basic Usage Examples - Simple API creation
3. Routing Guide - URL routing patterns
4. Request/Response - Handling HTTP

🏃 Intermediate Path (Building Production APIs)

1. Middleware Usage - Security and performance middleware
2. Authentication - JWT and API key auth
3. Testing - Unit and integration testing
4. Performance Optimization - Object pooling and optimization

🚀 Advanced Path (Framework Extension)

1. Architecture Guide - Framework internals
2. Custom Middleware - Building custom components
3. Service Providers - Dependency injection
4. Extensions - Framework extensions

✨ v1.1.4 Highlights

🔧 Infrastructure Consolidation

Complete infrastructure optimization and automation:

# Scripts reduced from 25 to 15 (40% reduction)
scripts/quality/quality-check.sh    # Consolidated validation
scripts/release/version-bump.sh     # Automatic version management

📦 Automatic Version Management

• VERSION file requirement - Single source of truth
• Automatic version detection - No more hardcoded versions
• Strict validation - X.Y.Z semantic versioning enforced
• Portuguese error messages - Clear developer feedback

🚀 GitHub Actions Optimization

• 25% workflow reduction (4 → 3 workflows)
• Consolidated scripts - No more duplicate functionality
• Fixed repository URLs - Corrected from express-php to pivotphp-core
• Enhanced validation - Consistent across all workflows

📚 Comprehensive Documentation

• 315-line versioning guide - Complete semantic versioning guidance
• Static file managers documentation - Two managers with clear use cases
• Release documentation - Complete v1.1.4 documentation suite
• Zero breaking changes - 100% backward compatibility maintained

🔧 Framework Status

• Current Version: v1.1.4 (Infrastructure Consolidation & Automation Edition)
• PHP Requirements: 8.1+ with strict typing
• Production Ready: Enterprise-grade quality with type safety
• Community: GitHub

🧩 Ecosystem

Official Extensions

• Cycle ORM Extension - Database integration
• ReactPHP Extension - Async runtime

Community Resources

• Benchmarks Repository - Performance testing
• Examples Collection - Practical usage examples

📖 Technical Documentation

Core Components

• Application - Framework bootstrap and lifecycle
• HTTP Layer - Request/response handling
• Routing - URL routing and static file management
• Static File Managers - Complete static file serving guide
• Middleware - Request/response pipeline

Advanced Topics

• Authentication - Multi-method authentication
• Performance - Object pooling and optimization
• JSON Optimization - Buffer pooling system
• PSR Compatibility - PSR-7/PSR-15 compliance

🤝 Contributing

Interested in contributing to PivotPHP Core? See our Contributing Guide for:

• Development setup
• Code style requirements
• Testing procedures
• Pull request process

📄 License

PivotPHP Core is open-source software licensed under the MIT License.

---

Built with ❤️ for the PHP community - Combining Express.js simplicity with PHP power