Quick Start

This guide will walk you through creating your first PivotPHP v1.1.4 application. We’ll build a simple REST API for managing tasks.

🚀 PivotPHP v1.1.4 - Architectural Excellence & Performance Optimization Edition
Revolutionary PHP microframework with 84,998 ops/sec peak performance and ReactPHP continuous runtime (19,707 req/sec). Experience Express.js-style development with industry-leading performance.

Performance Highlights

🔥 Peak Performance: 84,998 ops/sec (application creation)
⚡ ReactPHP Runtime: 19,707 req/sec (market leader)
🎯 Core Performance: 2,122 req/sec Peak (Docker validated v1.2.0)
💫 Array Callable: PHP 8.4+ compatible syntax
🏆 Market Position: #1 with ReactPHP, competitive core

Step 1: Create Your Application

First, create a new file public/index.php:

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

use PivotPHP\Core\Core\Application;

// Create the application instance
$app = new Application();

// Define your first route
$app->get('/', function($request, $response) {
    return $response->json([
        'message' => 'Welcome to PivotPHP v1.1.4!',
        'version' => '1.1.4',
        'edition' => 'Architectural Excellence & Performance Optimization',
        'performance' => [
            'peak_ops_sec' => 84998,
            'reactphp_req_sec' => 19707,
            'core_req_sec' => 2122
        ],
        'timestamp' => time()
    ]);
});

// Run the application
$app->run();

Step 2: Start the Development Server

Run the built-in PHP development server:

php -S localhost:8000 -t public

Visit http://localhost:8000 in your browser. You should see a JSON response.

Step 3: Add More Routes

Let’s create a simple task management API with v1.1.4 features:

// In-memory task storage (for demo purposes)
$tasks = [];

// List all tasks
$app->get('/tasks', function($req, $res) use (&$tasks) {
    return $res->json($tasks);
});

// Get a specific task
$app->get('/tasks/:id', function($req, $res) use (&$tasks) {
    $id = $req->param('id');

    if (!isset($tasks[$id])) {
        return $res->status(404)->json([
            'error' => 'Task not found'
        ]);
    }

    return $res->json($tasks[$id]);
});

// Create a new task
$app->post('/tasks', function($req, $res) use (&$tasks) {
    $data = $req->body();

    // Simple validation
    if (empty($data['title'])) {
        return $res->status(400)->json([
            'error' => 'Title is required'
        ]);
    }

    $id = uniqid();
    $task = [
        'id' => $id,
        'title' => $data['title'],
        'completed' => false,
        'created_at' => date('Y-m-d H:i:s')
    ];

    $tasks[$id] = $task;

    return $res->status(201)->json($task);
});

// Update a task
$app->put('/tasks/:id', function($req, $res) use (&$tasks) {
    $id = $req->param('id');

    if (!isset($tasks[$id])) {
        return $res->status(404)->json([
            'error' => 'Task not found'
        ]);
    }

    $data = $req->body();
    $tasks[$id] = array_merge($tasks[$id], $data);

    return $res->json($tasks[$id]);
});

// Delete a task
$app->delete('/tasks/:id', function($req, $res) use (&$tasks) {
    $id = $req->param('id');

    if (!isset($tasks[$id])) {
        return $res->status(404)->json([
            'error' => 'Task not found'
        ]);
    }

    unset($tasks[$id]);

    return $res->status(204)->send();
});

Step 4: Add Middleware

Let’s add some middleware for logging and CORS using v1.1.4 optimizations:

// Logging middleware
$app->middleware(function($req, $handler) {
    $start = microtime(true);

    // Process the request
    $response = $handler->handle($req);

    // Log the request
    $duration = round((microtime(true) - $start) * 1000, 2);
    error_log(sprintf(
        "%s %s - %dms",
        $req->getMethod(),
        $req->getUri()->getPath(),
        $duration
    ));

    return $response;
});

// CORS middleware
$app->middleware(function($req, $handler) {
    $response = $handler->handle($req);

    return $response
        ->withHeader('Access-Control-Allow-Origin', '*')
        ->withHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS')
        ->withHeader('Access-Control-Allow-Headers', 'Content-Type');
});

Step 5: Test Your API

You can test your API using curl or any HTTP client:

# Create a task
curl -X POST http://localhost:8000/tasks \
  -H "Content-Type: application/json" \
  -d '{"title": "Learn PivotPHP"}'

# List all tasks
curl http://localhost:8000/tasks

# Update a task
curl -X PUT http://localhost:8000/tasks/{id} \
  -H "Content-Type: application/json" \
  -d '{"completed": true}'

# Delete a task
curl -X DELETE http://localhost:8000/tasks/{id}

Complete Example

Here’s the complete code for reference:

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

use PivotPHP\Core\Core\Application;

$app = new Application();

// Middleware
$app->middleware(function($req, $handler) {
    $start = microtime(true);
    $response = $handler->handle($req);
    $duration = round((microtime(true) - $start) * 1000, 2);
    error_log(sprintf("%s %s - %dms", $req->getMethod(), $req->getUri()->getPath(), $duration));
    return $response;
});

$app->middleware(function($req, $handler) {
    $response = $handler->handle($req);
    return $response
        ->withHeader('Access-Control-Allow-Origin', '*')
        ->withHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS')
        ->withHeader('Access-Control-Allow-Headers', 'Content-Type');
});

// Routes
$tasks = [];

$app->get('/', function($req, $res) {
    return $res->json(['message' => 'Task API', 'version' => '1.0']);
});

$app->get('/tasks', function($req, $res) use (&$tasks) {
    return $res->json(array_values($tasks));
});

$app->get('/tasks/{id}', function($req, $res) use (&$tasks) {
    $id = $req->param('id');
    if (!isset($tasks[$id])) {
        return $res->status(404)->json(['error' => 'Task not found']);
    }
    return $res->json($tasks[$id]);
});

$app->post('/tasks', function($req, $res) use (&$tasks) {
    $data = $req->body();
    if (empty($data['title'])) {
        return $res->status(400)->json(['error' => 'Title is required']);
    }

    $id = uniqid();
    $task = [
        'id' => $id,
        'title' => $data['title'],
        'completed' => false,
        'created_at' => date('Y-m-d H:i:s')
    ];

    $tasks[$id] = $task;
    return $res->status(201)->json($task);
});

$app->put('/tasks/{id}', function($req, $res) use (&$tasks) {
    $id = $req->param('id');
    if (!isset($tasks[$id])) {
        return $res->status(404)->json(['error' => 'Task not found']);
    }

    $tasks[$id] = array_merge($tasks[$id], $req->body());
    return $res->json($tasks[$id]);
});

$app->delete('/tasks/{id}', function($req, $res) use (&$tasks) {
    $id = $req->param('id');
    if (!isset($tasks[$id])) {
        return $res->status(404)->json(['error' => 'Task not found']);
    }

    unset($tasks[$id]);
    return $res->status(204)->send();
});

$app->run();

What’s Next?

Congratulations! You’ve built your first PivotPHP v1.1.4 application. To learn more:

Core Features

Explore Routing for advanced routing features with array callable support
Learn about Middleware for request processing with PSR-15 compliance
Understand Service Container for dependency injection
Check out Database integration with Cycle ORM

Performance Extensions

ReactPHP Extension: Achieve 19,707 req/sec with continuous runtime
Cycle ORM Extension: Zero-configuration database with 457,870 ops/sec
Performance Monitoring: Real-time metrics and optimization tools

Advanced Topics

Array Callable Syntax: Use [Controller::class, 'method'] for PHP 8.4+ compatibility
Object Pooling: Benefit from 100% Request and 99.9% Response reuse
JSON Optimization: Automatic buffer pooling for high-performance APIs
Docker Deployment: Production-ready containerized deployments

Community & Support

Discord Community: https://discord.gg/DMtxsP7z
GitHub: https://github.com/PivotPHP/pivotphp-core
Performance Results: See our benchmark documentation for detailed performance analysis