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.
💡 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
- GitHub: github.com/pivotphp/pivotphp-core
- Issues: Reporte bugs
- Discussões: Comunidade
- Packagist: packagist.org/packages/pivotphp/core
📄 Licença
PivotPHP é software de código aberto licenciado sob a MIT License.
Desenvolvido no Brasil 🇧🇷 com foco em educação e simplicidade.