PHPackages omegaalfa/utils - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. omegaalfa/utils ActiveLibrary omegaalfa/utils =============== A lightweight, zero-dependency PHP utility package designed to provide essential helper functions for small scripts, microservices, and CLI applications. v1.0.0(today)01↑2900%[3 PRs](https://github.com/omegaalfa/Utils/pulls)MITPHPPHP >=8.4CI passing Since Aug 2Pushed todayCompare [ Source](https://github.com/omegaalfa/Utils)[ Packagist](https://packagist.org/packages/omegaalfa/utils)[ RSS](/packages/omegaalfa-utils/feed)WikiDiscussions main Synced today READMEChangelogDependencies (3)Versions (2)Used By (0) Omegaalfa Utils =============== [](#omegaalfa-utils) **Utilitários PHP pequenos, tipados e sem dependências de runtime.** [![PHP](https://camo.githubusercontent.com/86d76eaf4a339fd1fab477d7501b1b957562d78530c965b472179940ab4fe6c7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d254532253839254135382e342d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net/)[![Tests](https://github.com/omegaalfa/Utils/actions/workflows/ci.yaml/badge.svg)](https://github.com/omegaalfa/Utils/actions/workflows/ci.yaml)[![License](https://camo.githubusercontent.com/4b344c037f4785ff7943e5781f61fd6ddcfeea945585e0b2b4476bce7ef11805/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d3232433535452e737667)](LICENSE)[![Runtime dependencies](https://camo.githubusercontent.com/5047a2da8b01258292af786e5176b385648174bdacb38c64a83a55dcfa9e86de/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f72756e74696d655f646570656e64656e636965732d302d3045413545392e737667)](composer.json) Um ecossistema modular para scripts, aplicações CLI e microsserviços. Visão geral ----------- [](#visão-geral) O Omegaalfa Utils reúne componentes independentes para problemas recorrentes de infraestrutura PHP. O projeto prioriza APIs pequenas, comportamento explícito e baixo custo de adoção. Cada módulo possui responsabilidade e documentação próprias. Você pode usar somente as APIs necessárias; nenhum framework, container ou ciclo de vida global é imposto pelo pacote. Instalação ---------- [](#instalação) Todos os módulos são distribuídos atualmente pelo mesmo pacote Composer: ``` composer require omegaalfa/utils ``` Requisitos: RequisitoVersãoPHP8.4 ou superiorExtensões obrigatórias adicionaisintl e mbstringDependências de runtimeNenhumaAutoloadPSR-4; helpers globais são opt-inMódulos ------- [](#módulos) MóduloResponsabilidadeUse quandoDocumentaçãoEnvLoaderLer configuração de arquivos `.env` confiáveisScripts, CLIs e desenvolvimento local precisam carregar variáveis[Guia do EnvLoader](src/EnvLoader/README.md)StreamEncapsular resources nativos com leitura incrementalVocê precisa manipular arquivos, memória, linhas ou CSV sem carregar tudo[Guia de Stream](src/Stream/README.md)SessionGerenciar a sessão nativa preservando tiposUma aplicação HTTP pequena precisa de uma API previsível sobre `$_SESSION`[Guia de Session](src/Session/README.md)HelpersFunções opcionais de texto, JSON e validaçãoUm script aceita importar explicitamente funções globais[Guia de Helpers](helpers/README.md)DebugDump tipado com atalhos globais opcionaisVocê precisa inspecionar valores durante o desenvolvimento[Guia de Debug](src/Debug/README.md)ClockTempo atual injetável e determinísticoRegras temporais precisam ser testadas sem depender do relógio real[Guia de Clock](src/Clock/README.md)LazyObjectFachada tipada sobre lazy objects nativosConstrução ou hidratação cara deve ocorrer somente no primeiro uso[Guia de LazyObject](src/LazyObject/README.md)ScriptRunnerDescobrir e executar scripts PHP por menu seguroRotinas locais precisam de navegação, isolamento e captura de resultado[Guia de ScriptRunner](src/ScriptRunner/README.md)String UtilsOperações estáticas otimizadas de stringVocê precisa de consultas, slug, truncamento, random ou máscara[Guia de String Utils](src/Str/README.md)LockExclusão mútua entre processos locaisUma operação não pode executar simultaneamente[Guia de Lock](src/Lock/README.md)ProfilerTempo, memória, chamadas e etapasVocê precisa localizar gargalos com dados reais[Guia de Profiler](src/Profiler/README.md)FilesystemArquivos e diretórios com raiz isolada e operações previsíveisVocê precisa controlar caminhos, escrita, cópia, movimentação ou streams[Guia de Filesystem](src/Filesystem/README.md)UUID e ULIDIdentificadores únicos e ordenáveis por tempoVocê precisa gerar IDs sem depender do banco de dados[Guia de UUID e ULID](src/Identifier/README.md)RetryRepetição controlada de operações temporariamente instáveisAPIs, bancos ou filas podem falhar de forma transitória[Guia de Retry](src/Retry/README.md)CLIComandos, argumentos, opções e saída de terminalVocê precisa estruturar ferramentas de linha de comando pequenas[Guia de CLI](src/Cli/README.md)DTOObjetos imutáveis e tipados para transporte de dadosArrays sem contrato precisam virar dados previsíveis entre camadas[Guia de DTO](src/Dto/README.md)Escolha rápida -------------- [](#escolha-rápida) ``` flowchart TD A[Qual problema preciso resolver?] A -->|Configuração .env| B[EnvLoader] A -->|I/O incremental| C[Stream] A -->|Estado HTTP por usuário| D[Session] A -->|Transformação pequena| F[Helpers] A -->|String otimizada| G[Str] A -->|Evitar execução simultânea| H[Lock] A -->|Localizar gargalos| I[Profiler] A -->|Operar arquivos com segurança| J[Filesystem] A -->|Gerar identificadores| K[UUID e ULID] A -->|Repetir falhas temporárias| L[Retry] A -->|Criar comandos| M[CLI] A -->|Transportar dados tipados| N[DTO] A -->|Inspecionar valores| O[Debug] A -->|Controlar o tempo em testes| P[Clock] A -->|Adiar construção de objetos| Q[LazyObject] A -->|Executar scripts por menu| R[ScriptRunner] ``` Loading Important Os módulos permanecem no mesmo pacote Composer; instale omegaalfa/utils e importe somente as APIs desejadas. Os requisitos de ambiente são compartilhados enquanto os módulos estiverem no mesmo pacote. Helpers globais não são registrados automaticamente. Princípios do ecossistema ------------------------- [](#princípios-do-ecossistema) - zero dependências em produção; - tipos estritos e PHP moderno; - namespaces PSR-4 sob `Omegaalfa\Utils`; - falhas explícitas por exceptions; - processamento incremental quando aplicável; - ausência de integração obrigatória com frameworks; - testes automatizados e PHPStan no nível máximo. Desenvolvimento --------------- [](#desenvolvimento) ``` composer install composer check composer test:coverage composer audit ``` `composer check` executa análise estática e testes. Mudanças de comportamento devem incluir testes e atualização do README do módulo afetado. Contribuição ------------ [](#contribuição) Antes de propor um novo módulo, confirme que ele: 1. resolve uma responsabilidade pequena e bem definida; 2. não duplica uma solução nativa simples sem ganho claro; 3. não introduz dependência de runtime sem justificativa; 4. possui contratos tipados, testes e documentação independente; 5. não mistura responsabilidades de outro módulo. Abra uma issue para discutir alterações amplas. Pull requests devem passar por `composer check` e `composer audit`. Licença ------- [](#licença) Distribuído sob a [licença MIT](LICENSE). ### Health Score 42 — FairBetter than 88% of packages Maintenance100 Actively maintained with recent releases Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity50 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 0d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/16062691?v=4)[omegaalfa](/maintainers/omegaalfa)[@omegaalfa](https://github.com/omegaalfa) --- Top Contributors [![omegaalfa](https://avatars.githubusercontent.com/u/16062691?v=4)](https://github.com/omegaalfa "omegaalfa (1 commits)") --- Tags configurationenvironmentenvutilitiesenv-loader ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/omegaalfa-utils/health.svg) ``` [![Health](https://phpackages.com/badges/omegaalfa-utils/health.svg)](https://phpackages.com/packages/omegaalfa-utils) ``` ### Alternatives [vlucas/phpdotenv Loads environment variables from `.env` to `getenv()`, `$\_ENV` and `$\_SERVER` automagically. 13.5k654.3M6.6k](/packages/vlucas-phpdotenv)[symfony/dotenv Registers environment variables from a .env file 3.8k249.2M3.0k](/packages/symfony-dotenv) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)