Skip to content

# PivotPHP Core v1.1.2 - Framework Overview

Choose a tag to compare

View all tags
@code-cfernandes code-cfernandes released this 11 Jul 16:59
· 67 commits to main since this release
v1.1.2
dba91c2
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Versão: 1.1.2 (Consolidation Edition)
Data de Release: 2025-07-11
Status: Stable Release

📋 Visão Geral

PivotPHP Core v1.1.2 é uma versão de consolidação técnica que elimina duplicações críticas de código, reorganiza a estrutura de arquivos e otimiza a arquitetura do framework. Esta versão prepara o framework para uso em produção através de melhorias significativas na organização e manutenibilidade do código.

🎯 Objetivos da Versão

  • Eliminação de duplicações: Remoção de 100% das duplicações críticas identificadas
  • Reorganização arquitetural: Estrutura de middlewares organizada por responsabilidade
  • Manutenção de compatibilidade: 100% backward compatibility através de aliases
  • Modernização de CI/CD: Atualização para GitHub Actions v4
  • Melhoria de qualidade: PHPStan Level 9, PSR-12, cobertura de testes

📊 Métricas da Versão

Performance Benchmarks

  • Request Creation: 28,693 ops/sec
  • Response Creation: 131,351 ops/sec
  • PSR-7 Compatibility: 13,376 ops/sec
  • Hybrid Operations: 13,579 ops/sec
  • Object Pooling: 24,161 ops/sec
  • Route Processing: 31,699 ops/sec
  • Performance Média: 40,476 ops/sec

Qualidade de Código

  • PHPStan: Level 9, 0 erros (119 arquivos)
  • PSR-12: 100% compliance, 0 erros
  • Testes: 429/430 passando (99.8% success rate)
  • Coverage: 33.23% (3,261/9,812 statements)
  • Arquivos PHP: 119 arquivos (-3 vs v1.1.1)
  • Linhas de Código: 29,556 linhas (-1,071 vs v1.1.1)

Redução Técnica

  • Duplicações Eliminadas: 5 → 0 (100% redução)
  • Namespaces Organizados: 3 fragmentados → 1 unificado
  • Aliases de Compatibilidade: 12 aliases criados
  • Arquivos Consolidados: 3 arquivos removidos

🏗️ Arquitetura Consolidada

Nova Estrutura de Middlewares

src/Middleware/
├── Http/
│   ├── CorsMiddleware.php
│   └── ErrorMiddleware.php
├── Security/
│   ├── AuthMiddleware.php
│   ├── CsrfMiddleware.php
│   ├── SecurityHeadersMiddleware.php
│   └── XssMiddleware.php
└── Performance/
    ├── CacheMiddleware.php
    └── RateLimitMiddleware.php

Componentes Consolidados

  • DynamicPoolManager: src/Http/Pool/DynamicPoolManager.php
  • PerformanceMonitor: src/Performance/PerformanceMonitor.php
  • Arr Utilities: src/Utils/Arr.php (Support/Arr removido)

Aliases de Compatibilidade

// Middlewares HTTP
PivotPHP\Core\Http\Psr15\Middleware\CorsMiddleware
→ PivotPHP\Core\Middleware\Http\CorsMiddleware

// Middlewares de Segurança  
PivotPHP\Core\Http\Psr15\Middleware\CsrfMiddleware
→ PivotPHP\Core\Middleware\Security\CsrfMiddleware

// Performance e Pool
PivotPHP\Core\Monitoring\PerformanceMonitor
→ PivotPHP\Core\Performance\PerformanceMonitor

// Utilitários
PivotPHP\Core\Support\Arr
→ PivotPHP\Core\Utils\Arr

🔧 Melhorias Técnicas

GitHub Actions Modernizado

  • actions/upload-artifact: v3 → v4
  • actions/cache: v3 → v4
  • codecov/codecov-action: v3 → v4
  • Coverage calculation: Parser XML funcional
  • Error handling: Graceful fallbacks

Correções de Código

  • DynamicPoolManager: Constructor com configuração
  • Arr::flatten: Implementação depth-aware com dot notation
  • PSR-12 compliance: Separação de functions.php e aliases.php
  • Type safety: Strict typing em todos os componentes

Validação Automática

  • Quality Gates: 8 critérios críticos implementados
  • Pre-commit hooks: Validação automática
  • CI/CD pipeline: Integração contínua funcional
  • Coverage reporting: Métricas precisas

💾 Configuração e Uso

Autoload Atualizado

{
  "autoload": {
    "psr-4": {
      "PivotPHP\\Core\\": "src/"
    },
    "files": [
      "src/functions.php",
      "src/aliases.php"
    ]
  }
}

Migração Simples

// Código v1.1.1 (continua funcionando)
use PivotPHP\Core\Http\Psr15\Middleware\CorsMiddleware;

// Código v1.1.2 (recomendado)
use PivotPHP\Core\Middleware\Http\CorsMiddleware;

🔄 Compatibilidade

Backward Compatibility

  • 100% compatível com código v1.1.1
  • Aliases automáticos para todas as classes movidas
  • APIs públicas inalteradas
  • Comportamento idêntico

Depreciação Planejada

  • Aliases temporários serão removidos na v1.2.0
  • Migração automática disponível via script
  • Documentação de migração incluída

🚀 Recursos Mantidos

Core Features

  • Express.js-inspired API: Request/Response híbrido
  • PSR Standards: PSR-7, PSR-15, PSR-12 compliance
  • Object Pooling: High-performance object reuse
  • JSON Optimization: v1.1.1 buffer pooling mantido
  • Middleware Pipeline: PSR-15 compliant
  • Security Features: CSRF, XSS, CORS, Rate Limiting

Development Tools

  • OpenAPI/Swagger: Documentação automática
  • Benchmarking: Suite de performance
  • Quality Gates: Validação automática
  • Testing: 430+ testes unitários e integração

Ecosystem Integration

  • PivotPHP Cycle ORM v1.1.0
  • PivotPHP ReactPHP v0.2.0

🎯 Conclusão

PivotPHP Core v1.1.2 representa um marco importante na evolução do framework, estabelecendo uma base sólida para crescimento futuro através de:

  • Arquitetura limpa e organizada
  • Qualidade de código excepcional
  • Performance mantida e otimizada
  • Compatibilidade total preservada
  • DevOps modernizado

Esta versão está pronta para produção e serve como fundação robusta para o ecossistema PivotPHP.

Documentação Completa: docs/
Migration Guide: MIGRATION_GUIDE_v1.1.2.md
Changelog: CHANGELOG_v1.1.2.md

What's Changed

  • Feature/v1.1.2 consolidation by @CAFernandes in #11

Full Changelog: v1.1.1...v1.1.2

Contributors

code-cfernandes
Assets 2
Loading