Extensions

PivotPHP has a rich ecosystem of extensions that add powerful features to the core framework. These modular packages allow you to pick exactly what you need for your project.

Official Extensions

Database & ORM

Cycle ORM v1.0.1

A powerful DataMapper ORM that provides a complete database solution with zero-configuration setup.

composer require pivotphp/cycle-orm

Features:

  • Zero-configuration setup with sensible defaults
  • Automatic schema generation and migrations
  • Repository pattern with performance caching
  • Complex relationships support
  • Transaction middleware
  • Multiple database connections (SQLite, MySQL)
  • Performance monitoring and query profiling

Async Runtime

ReactPHP Extension v0.0.2

Production-ready continuous runtime using ReactPHP’s event-driven architecture for high-performance applications.

composer require pivotphp/reactphp

Features:

  • Continuous HTTP server without restarts (40K+ req/s)
  • PSR-7 bridge compatibility with global state protection
  • Event-driven, non-blocking I/O
  • Memory management and isolation
  • Graceful shutdown handling
  • Production deployment ready

Community Extensions

The PivotPHP ecosystem is designed to be extended! We’re excited about the extensions that the community will create.

Official Extensions Available

Built-in Features

The PivotPHP Core framework already includes several advanced features:

  • OpenAPI/Swagger - Automatic API documentation generation via OpenApiExporter utility
  • High-Performance Mode - Object pooling and lazy loading (v1.2.0)
  • JSON Optimization - Automatic buffer pooling for JSON operations (v1.2.0)
  • Security Middleware - Built-in CSRF, XSS protection, rate limiting
  • Performance Monitoring - Real-time metrics and profiling tools

Planned Extensions

We’re planning to develop or support community development of:

  • Queue System - Background job processing with multiple drivers
  • Advanced Caching - Multi-driver caching (Redis, Memcached, File)
  • Mail Service - Email abstraction with provider support
  • WebSocket Server - Real-time bidirectional communication
  • GraphQL - Modern API query language support
  • Admin Panel - Auto-generated admin interfaces
  • Testing Utilities - Enhanced testing helpers and assertions

Check our GitHub organization and Packagist for updates on new extensions.

Creating Extensions

Extensions in PivotPHP follow a simple pattern using Service Providers:

namespace YourVendor\YourExtension;

use PivotPHP\Core\Providers\ServiceProvider;

class YourExtensionServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        // Register services
        $this->container->singleton('your-service', function($container) {
            return new YourService($container);
        });
    }
    
    public function boot(): void
    {
        // Bootstrap extension
        // Register routes, middleware, etc.
    }
}

Extension Structure

A typical PivotPHP extension structure:

your-extension/
├── src/
│   ├── Providers/
│   │   └── YourExtensionServiceProvider.php
│   ├── Services/
│   ├── Middleware/
│   └── Commands/
├── config/
│   └── your-extension.php
├── tests/
├── composer.json
└── README.md

Publishing an Extension

  1. Create your extension following the structure above
  2. Register on Packagist with naming convention: vendor/pivotphp-{extension-name}
  3. Tag your releases following semantic versioning
  4. Submit to the official extensions list via PR

Extension Guidelines

  • Follow PSR standards (PSR-4, PSR-12)
  • Include comprehensive tests
  • Provide clear documentation
  • Use semantic versioning
  • Be compatible with the latest PivotPHP version
Cycle ORM Extension v1.0.1 →