Benchmarks de Performance

O PivotPHP oferece performance excepcional através de simplicidade educacional e otimizações mantidas. Nossos benchmarks abrangentes demonstram performance real de APIs em vários cenários, executados em containers Docker padronizados para testes justos e reproduzíveis. v1.2.0 “Simplicidade sobre Otimização Prematura” alcança 3,6M ops/s geração Swagger UI, 2.122 req/s performance HTTP pico, e 1.418 req/s throughput HTTP médio, estabelecendo excelência educacional sem sacrificar capacidades técnicas.

Performance Oficial Release - PivotPHP v1.2.0 - 21 de Julho de 2025

Análise Performance Oficial PivotPHP v1.2.0

Framework: PivotPHP Core v1.2.0 (Simplicity Edition - “Simplicidade sobre Otimização Prematura”)
Data de Release: 21 de julho de 2025
Ambiente: Container Docker com PHP 8.4.8 (OPcache + JIT habilitado)
Status: ✅ Release Oficial Validado

Inovações Performance OpenAPI/Swagger (NOVO v1.2.0) - Docker Validado

Performance Média OpenAPI: 1.783.236 ops/seg (Ambiente Docker)

Performance Core Framework (Comparação Docker Validado)

Impacto Performance Médio: -4.4% (Excelente trade-off para simplicidade e valor educacional)

Performance HTTP Real Ambiente Docker (NOVO)

Performance HTTP Média: 1.417,89 req/seg (Ambiente Docker)
Melhor Performance: 2.121,79 req/seg (endpoint Health)
Resposta Mais Rápida: 0.36ms

Resumo Validação Ambiente Docker

Metodologia de Benchmark e Ambiente de Teste

Infraestrutura de Teste v1.2.0

Estrutura de Testes Isolada Docker:

pivotphp-benchmarks/
├── docker-compose-v120.yml        # Orquestração completa v1.2.0
├── http_benchmark_v120.php         # Script HTTP real benchmark
├── phase1/                         # Testes Core Framework
│   ├── Dockerfile-v120            # Container otimizado v1.2.0
│   └── benchmarks/run-v120.php    # Execução testes v1.2.0
├── phase2/                         # Testes Extensões
│   ├── docker/Dockerfile-orm-v120 # Container ORM v1.2.0
│   └── docker/Dockerfile-reactphp-v120 # Container ReactPHP v1.2.0
└── phase3/                         # Validação Ecossistema
    ├── ecosystem-validation/ecosystem-v120-benchmark.php
    └── docker/docker-compose-v120.yml # Ambiente completo

Configuração Ambiente Docker Padronizado

Especificações Técnicas do Container:

• Sistema Operativo: Ubuntu 22.04 LTS
• PHP: 8.4.8-cli (OPcache + JIT habilitado)
• Recursos: 2 CPUs, 1GB RAM por container
• Rede: Isolamento completo com portas expostas específicas
• Storage: Volumes persistentes para logs e resultados

Configuração PHP Otimizada:

opcache.enable=1
opcache.jit=1255
opcache.jit_buffer_size=128M
memory_limit=1024M
max_execution_time=300

Comando Docker Benchmark Executado:

# Container PivotPHP v1.2.0 executando em localhost:8090
docker-compose -f docker-compose-v120.yml up -d
php http_benchmark_v120.php  # 1000 requisições, 100 por endpoint

Metodologia de Validação HTTP Real

Script de Teste HTTP (http_benchmark_v120.php):

• Endpoints Testados: 4 endpoints principais (/, /health, /api/test, /openapi.json)
• Requisições por Endpoint: 100 requisições sequenciais por endpoint
• Timeout: 5 segundos por requisição
• Métricas Coletadas: req/seg, tempo médio resposta, taxa sucesso, tempo min/max
• Validação SSL: Desabilitada para testes locais
• Dados Salvos: JSON com timestamp para reprodutibilidade

Estrutura Dados Coletados:

{
  "benchmark_info": {
    "version": "1.2.0",
    "date": "2025-07-21T20:36:02+00:00",
    "requests": 1000,
    "concurrent": 10
  },
  "results": {
    "/health": {
      "requests_per_second": 2121.79,
      "avg_response_time": 0.000469,
      "success_rate": 100
    }
  }
}

Comparação Cross-Framework (Metodologia Equivalente)

Frameworks Testados em Ambiente Idêntico:

• Slim 4: Container independente, mesma configuração PHP
• Laravel Lumen: Container independente, mesma configuração PHP
• Flight Framework: Container independente, mesma configuração PHP
• PivotPHP: Container independente, configuração otimizada

Garantias de Equidade:

• ✅ Isolamento Completo: Cada framework em container separado
• ✅ Recursos Idênticos: 2 CPUs, 1GB RAM para todos
• ✅ PHP Idêntico: Versão 8.4.8 com OPcache + JIT
• ✅ Benchmarks Idênticos: Mesmos endpoints e cenários de teste
• ✅ Ambiente Controlado: Docker elimina variações do sistema host

Reprodutibilidade e Transparência

Comandos para Reproduzir Benchmarks:

# Clonar repositório benchmarks
git clone https://github.com/PivotPHP/pivotphp-benchmarks.git
cd pivotphp-benchmarks

# Executar benchmarks v1.2.0
make -f Makefile-v120 build       # Build containers v1.2.0
make -f Makefile-v120 up          # Iniciar ambiente
php http_benchmark_v120.php       # Executar teste HTTP

# Executar benchmarks comparativos
make -f Makefile-v120 benchmark-all    # Todos frameworks
make -f Makefile-v120 report           # Gerar relatórios

# Acessar resultados
ls -la *.json                     # Arquivos resultado timestamp

Validação Contínua:

• Execução Diária: Benchmarks executados automaticamente
• Versionamento Resultados: Todos resultados com timestamp e hash git
• Ambiente Limpo: Containers reconstruídos para cada teste
• Logs Detalhados: Traces completos de execução disponíveis
• Comparação Histórica: Tracking de performance entre versões

Interpretação dos Resultados

Métricas de Performance Explicadas:

• req/seg: Requisições processadas por segundo (throughput HTTP)
• ops/seg: Operações internas por segundo (processamento framework)
• Tempo Resposta: Latência end-to-end da requisição HTTP
• Taxa Sucesso: Percentual de requisições com código 2xx
• Uso Memória: Consumo RAM pico durante teste

Categorias de Performance:

• 🚀 Revolucionário: >3M ops/seg ou >2K req/seg
• 🔥 Excepcional: >1M ops/seg ou >1K req/seg
• ⚡ Excepcional: >500K ops/seg ou >500 req/seg
• 💫 Excelente: >100K ops/seg ou >100 req/seg
• ✨ Sólido: >50K ops/seg ou >50 req/seg

Principais Insights da Validação v1.2.0

• Foco Educacional Mantém Performance: 1.418 req/seg médio com arquitetura simplificada
• OpenAPI Revolucionário: 3,6M ops/seg geração Swagger UI automática
• Zero Breaking Changes: 100% compatibilidade com código v1.1.4
• Docker Validado: Todos resultados verificáveis em ambiente isolado
• Transparência Total: Código, configuração e dados publicly available

Resultados de Benchmark Internos - PivotPHP Core v1.2.0

Análise Cross-Framework

Benchmarks abrangentes comparando PivotPHP com frameworks estabelecidos (Docker v1.2.0 - Gerado: 21/07/2025):

PivotPHP Core v1.2.0 - Resultados Benchmark Docker

PivotPHP v1.2.0 Performance JSON (Docker)

Pontos Fortes do Ecossistema PivotPHP

Performance de Concorrência

O PivotPHP mantém excelente performance sob vários níveis de carga concorrente:

Resultados de Teste de Carga

Performance Real de API (Benchmarks Cross-Framework)

Performance real de processamento de API medida contra frameworks estabelecidos:

Distribuição de Latência

O PivotPHP mantém latência baixa e consistente através dos percentis:

Comparação com Outros Frameworks

A performance do PivotPHP é competitiva com microframeworks estabelecidos:

Comportamento de Escala

O PivotPHP demonstra excelentes características de escala:

• Requisições Leves: -10,4% de degradação (500 → 1500 requisições)
• Requisições Normais: -19,3% de degradação (500 → 1500 requisições)
• Requisições Pesadas: +14,5% de melhoria (500 → 1500 requisições)

Performance no Mundo Real

Tempos de Resposta da API

// Endpoint leve - média de 0,11ms
$app->get('/status', fn($req, $res) => $res->json(['ok' => true]));

// Endpoint normal - média de 0,20ms
$app->get('/usuarios', function($req, $res) {
    $usuarios = Usuario::paginate(10);
    return $res->json($usuarios);
});

// Endpoint pesado - média de 2,28ms
$app->post('/analisar', function($req, $res) {
    $resultado = CalculoComplexo::processar($req->body());
    return $res->json($resultado);
});

Dicas de Otimização

1. Use Endpoints Apropriados

• Reserve processamento pesado para endpoints dedicados
• Implemente cache para operações computacionalmente caras
• Use respostas leves para verificações de saúde

2. Aproveite Middleware de Forma Eficiente

// Bom: Middleware condicional
$app->group('/api', function($app) {
    $app->use(new RateLimitMiddleware());
    $app->use(new AuthMiddleware());
    // Rotas aqui
});

// Evite: Middleware pesado global
$app->use(new MiddlewareCaro()); // Aplicado a todas as rotas

3. Otimize Consultas ao Banco de Dados

// Use carregamento antecipado
$usuarios = Usuario::with('posts', 'comentarios')->get();

// Use query builder para consultas complexas
$estatisticas = DB::table('pedidos')
    ->select(DB::raw('DATE(created_at) as data'), DB::raw('SUM(total) as receita'))
    ->groupBy('data')
    ->get();

Metodologia de Benchmark

Todos os benchmarks foram conduzidos com containers Docker padronizados:

• Ambiente: Containers Docker isolados para testes justos
• Padronização: Ambiente PHP 8.1+ idêntico em todos os testes
• Configuração: Setup padrão Docker compose
• Isolamento: Cada variante do framework testada separadamente
• Reprodutibilidade: Todos os testes podem ser replicados com docker-compose up
• Métricas: Operações/segundo, requisições/hora, uso de memória
• Variantes Testadas: Core v1.2.0, ORM v1.0.1, ReactPHP v0.1.0

Entendendo Nossas Métricas de Benchmark

Esclarecimento: Operações vs Requisições

“Operações por segundo” mede operações individuais do framework:

• Parsing de requisição, roteamento, formatação de resposta
• Múltiplas operações por requisição HTTP
• Usado para análise de performance interna

“Requisições por hora” mede ciclos HTTP completos:

• Uma chamada de API do início ao fim
• Mais relevante para planejamento de capacidade de produção
• Conversão: requisições/hora ≈ (ops/seg para HTTP) × 3600

Metodologia de Comparação Cross-Framework

# Executar análise comparativa
cd pivotphp-benchmarks
php scripts/run-comparative-analysis.php

# Benchmarks incluídos:
# - http-performance: Requisição/resposta HTTP completa
# - rest-api: Operações CRUD com validação
# - api-middleware: Autenticação, CORS, rate limiting
# - json-performance: Codificação/decodificação JSON

# Resultados mostram performance real de processamento de API
# vs frameworks estabelecidos como Slim 4

Avaliação Honesta de Performance

Baseado em análise cross-framework abrangente (Julho 2025):

🏆 Onde PivotPHP v1.2.0 se Destaca

• Experiência do Desenvolvedor: Sintaxe estilo Express.js com performance competitiva
• Eficiência de Memória: Ultra-eficiente com pegada de 1,61MB
• Latência: Excelente tempo médio de resposta de 0,32ms no Docker
• Otimização JSON: Sistema revolucionário de pooling interno (505K ops/s JSON pequeno)
• Arquitetura: Conformidade PSR moderna com API intuitiva

🥉 Performance de Validação Docker (Realista)

• Performance HTTP Real: 6.227 req/s em ambiente Docker padronizado
• Posicionamento Competitivo: 3º lugar, apenas 9,5% atrás do líder (Slim 4)
• Resultados Consistentes: Performance reproduzível em condições controladas
• Comparação de Frameworks: 96% mais rápido que Flight, competitivo com Lumen
• Alternativa Express.js: Forte posicionamento para desenvolvimento PHP estilo Express.js

📊 Transparência dos Benchmarks

• Metodologia: Containers Docker padronizados, 2K iterações
• Framework de Comparação: Direto com Slim 4
• Data do Teste: 10 de julho de 2025
• Ambiente: PHP 8.1+ com OPcache e JIT

🎯 Posicionamento Estratégico

O PivotPHP não afirma ser o framework PHP mais rápido. Em vez disso, oferece:

1. Excelência Especializada: ReactPHP lidera cenários async
2. Performance Competitiva: Core dentro de 12,5% de frameworks estabelecidos
3. Experiência Superior do Desenvolvedor: Padrões Express.js em PHP
4. Otimização de Memória: Variante ORM para deploys com restrição de recursos
5. Abordagem de Ecossistema: Ferramenta certa para o trabalho certo

Escolha PivotPHP v1.2.0 quando você precisa de performance competitiva com simplicidade educacional, experiência de desenvolvimento estilo Express.js, e geração abrangente de documentação OpenAPI com excelente eficiência de memória.