README

Em construção constante - nunca estara pronto

Testes Unitários

Para executar todos os testes unitários:

Como Executar os Testes Agora Para executar todos os testes de sessão seguros: vendor/bin/phpunit --testdox --testsuite="Session Tests" Para executar apenas o teste problemático: vendor/bin/phpunit --testdox tests/SessionNativeRedisTtlTest.php Para executar todos os testes (incluindo o problemático separadamente):

vendor/bin/phpunit --testdox --testsuite="Session Tests"
vendor/bin/phpunit --testdox tests/SessionNativeRedisTtlTest.php

# Executar todos os testes (exceto queues)
vendor/bin/phpunit --configuration phpunit.xml --filter '/^((?!QueueRunTest).)*$/'

# Executar testes específicos
vendor/bin/phpunit tests/HelperTest.php
vendor/bin/phpunit tests/LoadArgsTest.php
vendor/bin/phpunit tests/AbstractRouterTest.php

# Executar com Docker
docker exec -it <container_name> vendor/bin/phpunit --configuration phpunit.xml

Análise de Qualidade de Código

O projeto inclui análise estática de código com PHPStan integrada aos testes unitários:

# Executar PHPStan diretamente
vendor/bin/phpstan analyse

# PHPStan está integrado aos testes unitários
vendor/bin/phpunit tests/PhpStanTest.php

Estrutura do Projeto

• src/ - Código fonte principal
• tests/ - Testes unitários
• phpstan.neon - Configuração do PHPStan
• phpunit.xml - Configuração do PHPUnit

Funcionalidades Principais

• Helper: Funções utilitárias gerais
• LoadArgs: Parser de argumentos de linha de comando
• AbstractRouter: Sistema de roteamento com injeção de dependências
• Redis: Cliente Redis com retry logic
• Connection: Factories para PostgreSQL e SQLite
• Crypto: Criptografia e hash
• Date: Manipulação de datas
• Log: Sistema de logging
• Minify: Minificação de HTML, CSS e JS
• RateLimiter: Controle de taxa de requisições
• Validate: Validações diversas
• Template: Sistema de templates
• LoadCSVToArray: Carregamento de arquivos CSV
• PgLoadCSV: Carregamento de CSV para PostgreSQL

Qualidade de Código

O projeto mantém alta qualidade de código através de:

• ✅ 497 testes unitários passando
• ✅ Análise estática com PHPStan (sem erros)
• ✅ Cobertura de código abrangente
• ✅ Padrões de código consistentes
• ✅ Documentação inline

Docker

Para executar em ambiente Docker:

# Executar testes
docker exec -it <container_name> vendor/bin/phpunit --configuration phpunit.xml

# Executar PHPStan
docker exec -it <container_name> vendor/bin/phpstan analyse

Para manter o repo.

Pegue o hash do commit git checkout maintenance/1.101 git pull git cherry-pick

Se der conflito, resolva, então: git add . git cherry-pick --continue git push

1. Lance uma nova tag 1.101.x com o helper git tag 1.101.N git push --tags

✅ Pronto: o helper está disponível tanto na 1.102.x quanto na 1.101.x, e cada projeto escolhe a linha pelo constraint no Composer.