PHPackages                             buildcake/tools - 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. [Utility & Helpers](/categories/utility)
4. /
5. buildcake/tools

ActiveLibrary[Utility & Helpers](/categories/utility)

buildcake/tools
===============

Biblioteca de utilitários PHP para operações comuns do sistema

v2.0.2(5mo ago)0552MITPHPPHP >=7.4

Since Nov 10Pushed 5mo agoCompare

[ Source](https://github.com/DesenvolvimentoEasingJob/buildcake-tools)[ Packagist](https://packagist.org/packages/buildcake/tools)[ RSS](/packages/buildcake-tools/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (6)Used By (2)

BuildCake Utils
===============

[](#buildcake-utils)

Biblioteca PHP de utilitários para operações comuns do sistema.

Instalação
----------

[](#instalação)

### Via Composer

[](#via-composer)

```
composer require buildcake/tools
```

### Instalação Manual

[](#instalação-manual)

1. Clone ou baixe este repositório
2. Inclua o autoloader do Composer:

```
require_once 'vendor/autoload.php';
```

Requisitos
----------

[](#requisitos)

- PHP >= 7.4

Uso
---

[](#uso)

### Carregar Variáveis de Ambiente

[](#carregar-variáveis-de-ambiente)

```
use BuildCake\Utils\Utils;

// Carrega variáveis de um arquivo .env
Utils::loadEnv(__DIR__ . '/.env');

// Agora você pode usar getenv() ou $_ENV
$dbHost = getenv('DB_HOST');
```

### Enviar Resposta JSON

[](#enviar-resposta-json)

```
use BuildCake\Utils\Utils;

// Resposta de sucesso
Utils::sendResponse(200, ['user' => ['id' => 1, 'name' => 'João']], 'Usuário encontrado');

// Resposta de erro
Utils::sendResponse(400, [], 'Dados inválidos', ['email' => 'Email é obrigatório']);
```

### Incluir Arquivos

[](#incluir-arquivos)

```
use BuildCake\Utils\Utils;

// Inclui um arquivo (procura recursivamente se não encontrar)
Utils::includeFile('config/database.php');

// Inclui um serviço de um módulo específico
Utils::includeService('User', 'Auth'); // Procura por Auth/services/UserService.php
```

### Substituir Campos em Texto

[](#substituir-campos-em-texto)

```
use BuildCake\Utils\Utils;

$template = "Olá {{nome}}, seu email é {{email}}";
$data = [
    'nome' => 'João',
    'email' => 'joao@example.com'
];

$resultado = Utils::replaceFields($template, $data);
// Resultado: "Olá João, seu email é joao@example.com"
```

### Processar Requisições

[](#processar-requisições)

```
use BuildCake\Utils\Utils;

$request = Utils::getFileRequest();
// Retorna array com informações sobre file, route, id e type
```

Métodos Disponíveis
-------------------

[](#métodos-disponíveis)

### `includeFile(string $filepath): mixed`

[](#includefilestring-filepath-mixed)

Inclui um arquivo procurando recursivamente no sistema de diretórios.

### `includeService(string $filepath, string $module = ""): mixed`

[](#includeservicestring-filepath-string-module---mixed)

Inclui um arquivo de serviço baseado no módulo especificado.

### `loadEnv(string $path): void`

[](#loadenvstring-path-void)

Carrega variáveis de ambiente de um arquivo .env.

### `sendResponse(int $statusCode, array $data, string $message = '', array $errors = []): void`

[](#sendresponseint-statuscode-array-data-string-message---array-errors---void)

Envia uma resposta JSON padronizada e encerra a execução.

### `getFileRequest(): array`

[](#getfilerequest-array)

Processa a requisição e retorna informações sobre o arquivo/rota solicitada.

### `replaceFields(string $text, array|object $fields): string`

[](#replacefieldsstring-text-arrayobject-fields-string)

Substitui campos em um texto usando placeholders no formato `{{campo}}`.

Estrutura do Projeto
--------------------

[](#estrutura-do-projeto)

```
buildcake-tools/
├── src/
│   └── BuildCake/
│       └── Utils/
│           └── Utils.php
├── composer.json
├── README.md
└── .gitignore

```

Licença
-------

[](#licença)

MIT

Contribuindo
------------

[](#contribuindo)

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance72

Regular maintenance activity

Popularity10

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 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

Every ~7 days

Total

5

Last Release

160d ago

Major Versions

v1.0.4 → v2.0.02025-11-24

### Community

Maintainers

![](https://www.gravatar.com/avatar/01b1c793b7fe27f596fa5cc7ef7caa876fe6080cee0cf34aeb6cc888cfe5dd10?d=identicon)[DesenvolvimentoEasingJob](/maintainers/DesenvolvimentoEasingJob)

---

Top Contributors

[![DesenvolvimentoEasingJob](https://avatars.githubusercontent.com/u/71417413?v=4)](https://github.com/DesenvolvimentoEasingJob "DesenvolvimentoEasingJob (10 commits)")

### Embed Badge

![Health badge](/badges/buildcake-tools/health.svg)

```
[![Health](https://phpackages.com/badges/buildcake-tools/health.svg)](https://phpackages.com/packages/buildcake-tools)
```

###  Alternatives

[liyu/dingo-serializer-switch

A middleware to switch dingo serializer

51138.7k2](/packages/liyu-dingo-serializer-switch)[php-forge/foxy

Fast, reliable, and secure Bun/NPM/Yarn/pnpm bridge for Composer

45103.3k4](/packages/php-forge-foxy)[asm/php-utilities

php tools with data container, collection objects, yaml config loader and timer

107.7k](/packages/asm-php-utilities)[relbraun/yii2repeater

Repeater widget for yii2 tabular

114.8k](/packages/relbraun-yii2repeater)[cytopia/check_git

Nagios plugin to verify a git repository.

105.2k](/packages/cytopia-check-git)[jonof/moodle-block_completion_progress

Moodle plugin for student time management.

191.4k](/packages/jonof-moodle-block-completion-progress)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)