Bem-vindo ao PivotPHP

🚀 PivotPHP v1.2.0

O microframework PHP evolutivo reimaginado

Simplicidade Educacional • Documentação Automática • Performance Excepcional

🎉 Release v1.2.0 - "Simplicidade sobre Otimização Prematura"

21 de julho de 2025 - Release oficial com documentação OpenAPI/Swagger automática, arquitetura simplificada e foco educacional mantendo excelente performance.

Swagger UI: 3,6M ops/seg
HTTP Pico: 2.122 req/seg
Resposta: 0,36ms (mínima)
Docker: ✅ Validado

💡 Por que PivotPHP?

PivotPHP traz a simplicidade e elegância do Express.js para o ecossistema PHP, com documentação automática OpenAPI/Swagger e arquitetura reimaginada. Ideal para:

  • 🎓 Aprendizado: Padrões modernos em PHP sem complexidade
  • ⚡ Prototipagem: Do conceito ao deploy em minutos
  • 📚 Documentação: Swagger UI automático via PHPDoc
  • 🚀 APIs Modernas: REST, middleware, injeção de dependência
  • 🔬 Proof of Concept: Validação rápida de ideias

🎯 Início Rápido

Instalação

composer create-project pivotphp/skeleton meu-projeto
cd meu-projeto
php -S localhost:8000 -t public

Seu Primeiro Endpoint

<?php
use PivotPHP\Core\Application;

$app = new Application();

/**
 * @api {get} /hello/:name Saudação personalizada
 */
$app->get('/hello/:name', function($req, $res) {
    $name = $req->params['name'];
    $res->json(['message' => "Olá, $name!"]);
});

$app->run();

Swagger automático em /swagger 🎉


🌟 Recursos Principais

📚 Documentação Automática OpenAPI/Swagger

Performance revolucionária: 3,6M+ ops/seg para geração Swagger UI

  • OpenAPI 3.0.0 automático baseado em PHPDoc
  • Swagger UI interativo disponível em /swagger
  • Performance excepcional: 3,5M ops/seg geração + 3,6M render
  • Zero configuração: Apenas documente seus endpoints

⚡ Performance Validada em Docker

Métrica Valor
HTTP Pico 2.122 req/seg
HTTP Médio 1.418 req/seg
OpenAPI Médio 1,78M ops/seg
Resposta Mínima 0,36ms

🛡️ Segurança Integrada

  • ✅ Proteção CSRF automática
  • ✅ Prevenção XSS em templates
  • ✅ Rate Limiting configurável
  • ✅ Validação de entrada robusta
  • ✅ Headers de segurança por padrão

🔧 Zero Configuração

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

$app = new PivotPHP\Core\Application();
$app->get('/', fn($req, $res) => $res->json(['status' => 'ok']));
$app->run();

📦 Compatibilidade PSR

  • PSR-7: Mensagens HTTP padronizadas
  • PSR-15: Middleware universalmente compatível
  • PSR-12: Código limpo e consistente
  • PSR-4: Autoloading moderno

🤝 Comunidade e Suporte


📄 Licença

PivotPHP é software de código aberto licenciado sob a MIT License.

Desenvolvido no Brasil 🇧🇷 com foco em educação e simplicidade.