Download the PHP package pivotphp/core without Composer

PivotPHP Microframework

🚀 O que é o PivotPHP?

PivotPHP é um microframework moderno, leve e seguro, inspirado no Express.js, especialmente projetado para provas de conceito, prototipagem rápida e estudos. Oferece uma API familiar e produtiva para validar ideias rapidamente, com arquitetura desacoplada e extensibilidade real quando necessário.

• ⚡ Setup Instantâneo: API funcionando em menos de 5 minutos, perfeito para validar ideias rapidamente.
• 🎯 Foco em Produtividade: Sintaxe familiar (Express.js) que acelera o desenvolvimento de protótipos.
• 📚 Documentação Automática: Geração automática de OpenAPI/Swagger - essencial para apresentar provas de conceito.
• 🛡️ Segurança Integrada: Middlewares prontos para CSRF, XSS, JWT - protótipos seguros desde o início.
• 🔧 Extensibilidade Simples: Sistema de plugins e providers para expandir funcionalidades conforme necessário.
• 📊 Performance Adequada: Throughput de 44,092 ops/sec, footprint de 1.61MB - suficiente para demonstrações.
• 🎨 v1.2.0: Simplicity Edition - Arquitetura limpa, zero complexidade desnecessária, foco em simplicidade.

✨ Principais Recursos

• 🏗️ DI Container & Providers
• 🎪 Event System
• 🧩 Sistema de Extensões
• 🔧 Configuração flexível
• 🔐 Autenticação Multi-método
• 🛡️ Segurança Avançada
• 📡 Streaming & SSE
• 📚 OpenAPI/Swagger Automático (v1.2.0+ Middleware)
• 🔄 PSR-7 Híbrido
• ♻️ Object Pooling
• 🚀 JSON Optimization (v1.2.0 Intelligent)
• 🎯 Array Callables (v1.2.0 Native)
• 🔍 Enhanced Error Diagnostics (v1.2.0)
• ⚡ Performance Extrema
• 🧪 Qualidade e Testes
• 🎯 Simplicidade sobre Otimização (v1.2.0)

💡 Casos de Uso Ideais

• 🔬 Provas de Conceito: Validar ideias de API rapidamente com setup mínimo
• 🎯 Prototipagem Rápida: Demonstrar funcionalidades para stakeholders e clientes
• 📚 Estudos e Aprendizado: Compreender arquiteturas de microframework e PSR standards
• 🧪 Testes de Integração: Criar APIs mock para testar integrações frontend/mobile
• 🎨 MVPs Educacionais: Projetos acadêmicos e de portfólio com qualidade profissional
• 🔗 APIs Bridge: Conectar sistemas legacy com interfaces modernas

Ideal para: Desenvolvedores que precisam validar conceitos rapidamente sem a complexidade de frameworks enterprise.

Veja exemplos práticos em documentação técnica completa.

🚀 Início Rápido

Instalação

Exemplo Básico

🛣️ Sintaxes de Roteamento Suportadas (v1.2.0)

O PivotPHP oferece suporte robusto para múltiplas sintaxes de roteamento:

✅ Sintaxes Suportadas

❌ Sintaxes NÃO Suportadas

🎯 Exemplo Completo com Controller

⚡ Validação Automática (v1.2.0)

📖 Documentação completa: Array Callable Guide

🔄 Suporte PSR-7 Híbrido

O PivotPHP oferece compatibilidade híbrida com PSR-7, mantendo a facilidade da API Express.js enquanto implementa completamente as interfaces PSR-7:

Benefícios da Implementação Híbrida:

• ✅ 100% compatível com middleware PSR-15
• ✅ Imutabilidade respeitada nos métodos with*()
• ✅ Lazy loading - objetos PSR-7 criados apenas quando necessário
• ✅ Object pooling - reutilização inteligente para melhor performance
• ✅ API Express.js mantida para produtividade
• ✅ Zero breaking changes - código existente funciona sem alterações

🚀 JSON Optimization (v1.2.0 Intelligent System)

O PivotPHP v1.2.0 mantém o threshold inteligente de 256 bytes no sistema de otimização JSON, eliminando overhead para dados pequenos:

⚡ Sistema Inteligente Automático

🎯 Performance por Tamanho de Dados

🔧 Configuração Avançada (Opcional)

✨ Mantido v1.2.0

• ✅ Threshold Inteligente - Elimina overhead para dados <256 bytes
• ✅ Detecção Automática - Sistema decide quando usar pooling
• ✅ Zero Configuração - Funciona perfeitamente out-of-the-box
• ✅ Performance Garantida - Nunca mais lento que json_encode()
• ✅ Monitoramento Integrado - Estatísticas em tempo real
• ✅ Compatibilidade Total - Drop-in replacement transparente

🔍 Enhanced Error Diagnostics (v1.2.0)

PivotPHP v1.2.0 mantém ContextualException para diagnósticos avançados de erros:

⚡ Sistema de Erro Inteligente

🎯 Categorias de Erro Disponíveis

🔧 Configuração de Ambiente

✨ Recursos v1.2.0

• ✅ Erro IDs Únicos - Rastreamento facilitado para debugging
• ✅ Sugestões Inteligentes - Orientações específicas para resolver problemas
• ✅ Contexto Rico - Informações detalhadas sobre o estado quando o erro ocorreu
• ✅ Categorização Automática - Classificação inteligente do tipo de erro
• ✅ Segurança por Ambiente - Detalhes reduzidos em produção
• ✅ Logging Integrado - Registro automático para análise posterior

📖 Documentação completa:

• Array Callable Guide
• JsonBufferPool Optimization Guide
• Enhanced Error Diagnostics

📖 Documentação OpenAPI/Swagger Automática (v1.2.0+)

O PivotPHP v1.2.0+ inclui middleware automático para geração de documentação OpenAPI/Swagger:

🎯 Recursos do Middleware de Documentação

• ✅ Geração automática de OpenAPI 3.0.0 de todas as rotas
• ✅ Interface Swagger UI integrada (zero configuração)
• ✅ Parsing de PHPDoc para metadados das rotas
• ✅ Endpoints automáticos /docs e /swagger
• ✅ Configuração flexível de paths e URLs
• ✅ Zero dependências externas
• ✅ Compatibilidade total com todas as rotas

📝 Exemplo Completo

Veja o exemplo funcional em examples/api_documentation_example.php:

📚 Documentação Completa

Acesse o Índice da Documentação para navegar por todos os guias técnicos, exemplos, referências de API, middlewares, autenticação, performance e mais.

Principais links:

• Guia de Implementação Básica
• Guia com Middlewares Prontos
• Guia de Middleware Customizado
• Referência Técnica
• Performance e Benchmarks

🧩 Extensões Oficiais

O PivotPHP possui um ecossistema rico de extensões que adicionam funcionalidades poderosas ao framework:

🗄️ Cycle ORM Extension

Integração completa com Cycle ORM para gerenciamento de banco de dados:

• Migrações automáticas
• Repositórios com query builder
• Relacionamentos (HasOne, HasMany, BelongsTo, ManyToMany)
• Suporte a transações
• Múltiplas conexões de banco

⚡ ReactPHP Extension

Runtime assíncrono para aplicações de longa duração:

• Servidor HTTP contínuo sem reinicializações
• Suporte a WebSocket (em breve)
• Operações I/O assíncronas
• Arquitetura orientada a eventos
• Timers e tarefas periódicas

🌐 Extensões da Comunidade

A comunidade PivotPHP está crescendo! Estamos animados para ver as extensões que serão criadas.

Extensões Planejadas:

• Gerador de documentação OpenAPI/Swagger
• Sistema de filas para jobs em background
• Cache avançado com múltiplos drivers
• Abstração para envio de emails
• Servidor WebSocket
• Suporte GraphQL

🔧 Criando Sua Própria Extensão

Diretrizes para Extensões:

1. Seguir convenção de nome: pivotphp-{nome}
2. Fornecer ServiceProvider estendendo ServiceProvider
3. Incluir testes de integração
4. Documentar no /docs/extensions/
5. Publicar no Packagist com tag pivotphp-extension

🔄 Compatibilidade PSR-7

O PivotPHP oferece suporte duplo para PSR-7, permitindo uso com projetos modernos (v2.x) e compatibilidade com ReactPHP (v1.x).

Verificar versão atual

Alternar entre versões

Após alternar versões

Veja a documentação completa sobre PSR-7 para mais detalhes.

🏗️ Arquitetura v1.2.0 (Simplicity Edition)

O PivotPHP v1.2.0 simplifica a arquitetura seguindo o princípio "Simplicidade sobre Otimização Prematura", priorizando facilidade de uso para provas de conceito:

🎯 Recursos v1.2.0

🚀 Array Callables Nativos

🧠 JsonBufferPool Inteligente

🔍 Enhanced Error Diagnostics

🏗️ Arquitetura v1.2.0 (Simplified Foundation)

O PivotPHP v1.2.0 simplifica a arquitetura v1.1.x, eliminando complexidade desnecessária:

🎯 Estrutura de Middlewares Organizada

✅ Melhorias da v1.2.0 (Foco em Simplicidade)

• 🎯 Orientado a Protótipos - Arquitetura simplificada para desenvolvimento rápido
• 📚 Documentação Didática - Exemplos práticos e guias de aprendizado
• 🔧 Setup Mínimo - Configuração zero para começar imediatamente
• 💡 Conceitos Claros - Estrutura lógica e intuitiva para estudos
• 🛡️ Qualidade Educacional - PHPStan Level 9, 100% testes passando para aprendizado

🔄 Migração para v1.2.0

Veja o Overview Estrutural para detalhes completos.

⚠️ Importante: Manutenção do Projeto

PivotPHP Core é mantido por apenas uma pessoa e pode não receber atualizações constantemente. Este projeto é ideal para:

• 🔬 Provas de conceito e protótipos
• 📚 Estudos e aprendizado de arquitetura
• 🧪 Testes e validação de ideias
• 🎓 Projetos educacionais e acadêmicos

Não recomendado para:

• 🏢 Aplicações enterprise críticas
• 📈 Sistemas de produção que exigem suporte 24/7
• 🔄 Projetos que precisam de atualizações frequentes

Se você precisa de um framework com equipe dedicada e suporte empresarial, considere alternativas como Laravel, Symfony ou Slim 4.

🤝 Comunidade

Junte-se à nossa comunidade crescente de desenvolvedores:

• Discord: Entre no nosso servidor - Obtenha ajuda, compartilhe ideias e conecte-se com outros desenvolvedores
• GitHub Discussions: Inicie uma discussão - Compartilhe feedback e ideias
• Twitter: @PivotPHP - Siga para atualizações e anúncios

🤝 Como Contribuir

Quer ajudar a evoluir o PivotPHP? Veja o docs/contributing/ para saber como abrir issues, enviar PRs ou criar extensões.

Contribuições são especialmente bem-vindas! Por ser mantido por uma pessoa, o projeto se beneficia muito da colaboração da comunidade.

📄 Licença

Este projeto está licenciado sob a Licença MIT. Veja o arquivo LICENSE para detalhes.

Desenvolvido com ❤️ para a comunidade PHP