PHPackages                             pealmeida/php-helpers - 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 &amp; Helpers](/categories/utility)
4. /
5. pealmeida/php-helpers

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

pealmeida/php-helpers
=====================

Biblioteca que contem helpers para projetos PHP

v2.0.0(9mo ago)01.6k↓44.4%MITPHPPHP ^8.0

Since Mar 13Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/diego-pealmeida/php-helpers)[ Packagist](https://packagist.org/packages/pealmeida/php-helpers)[ Docs](https://github.com/diego-pealmeida/php-helpers)[ RSS](/packages/pealmeida-php-helpers/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)DependenciesVersions (8)Used By (0)

```
# 📦 PHP Helpers - pealmeida/php-helpers

Uma coleção de funções auxiliares úteis para projetos PHP. Esta biblioteca traz uma série de utilitários prontos para uso, como formatação de CPF/CNPJ, validações, manipulação de datas, strings e muito mais.

---

## 🧩 Instalação

Você pode instalar esta biblioteca via Composer:

```bash
composer require pealmeida/php-helpers
```

🚀 Como Usar
Após instalar com Composer, as funções já estarão disponíveis globalmente:

```php
$value = formatCpfCnpj("12345678900");
echo $value; // 123.456.789-00
```

## 🛠️ Funções Disponíveis

### 🔢 Strings e Formatações

- addSpacesString(string $text, int $every): string
    Adiciona espaços a cada X caracteres na string. 🔢 Strings e Formatações

- onlyNumber(string $value): ?string
    Remove todos os caracteres não numéricos de uma string.

- formatCpf(string $value): string
    Formata um CPF com máscara.

- formatCnpj(string $value): string
    Formata um CNPJ com máscara.

- formatCpfCnpj(string $value): string
    Detecta e formata CPF ou CNPJ automaticamente.

- formatPhone(string $value): string
    Formata um telefone brasileiro com DDD.

- formatPostalCode(string $value): string
    Formata um CEP (código postal brasileiro) com máscara.

- removeAccent(string $string): string
    Remove acentos de uma string.

- formatToFilename(string $string): string
    Converte string para nome de arquivo válido.

- formatStringToFloat(string $value): float
    Converte string com vírgula para float ("1.234,56" → 1234.56).

- formatFloatToMoney(float $value, string $locale, string $currency, int $precision): string
    Formata número float como valor monetário.

- formatDigitableLine(string $line): string
    Adiciona espaços e máscara em linha digitável de boleto.

- formatJsonString(string $json): string
    Retorna JSON formatado com indentação.

### 📅 Datas

- convertDate(string $date, string $from, string $to): string
    Converte datas entre formatos personalizados.

- dateDiff(string $start, string $end, string $unit = 'days'): int
    Calcula a diferença entre duas datas.

- incrementMonth(string $date, int $months): string
    Soma meses em uma data (Y-m-d).

- incrementBussinessDay(string $date, int $days): string
    Soma dias úteis em uma data.

- decrementBussinessDay(string $date, int $days): string
    Subtrai dias úteis de uma data.

- isLeapYear(int $year): bool
    Verifica se o ano é bissexto.

- monthNameBr(int $month): string
    Retorna o nome do mês em português.

### 🔐 Segurança e Tokens

- token64(int $bytes = 32): string
    Gera um token aleatório base64 seguro.

- passwordForce(string $password): int
    Mede a força de uma senha (retorna um score).

- generatePassword(int $length = 10): string
    Gera uma senha aleatória.

### 🆔 Geradores

- generateCodeNumeric(int $length): string
    Gera um código numérico com N dígitos.

- generateId(): string
    Gera um ID único com base em timestamp + random.

### 🧪 Utilidades Gerais

- isJson(string $string): bool
    Verifica se uma string é um JSON válido.

- detectCsvDelimiter(string $csv): string
    Detecta automaticamente o delimitador de um CSV.

- sumString(string $value): int
    Soma todos os dígitos numéricos de uma string.

### 🖼️ Imagem / Geolocalização

- imageCoordinates(string $imagePath): ?array
    Extrai coordenadas geográficas de uma imagem JPEG (EXIF).

- getCoordinates(string $value): array
    Converte formato de coordenadas EXIF para latitude e longitude decimal.

## 🧪 Exemplos de Uso

```php
echo formatPhone('11987654321');         // (11) 98765-4321
echo formatCpf('12345678900');           // 123.456.789-00
echo formatFloatToMoney(1234.56, 'pt_BR', 'BRL', 2);        // R$ 1.234,56
echo convertDate('25/07/2025', 'd/m/Y', 'Y-m-d'); // 2025-07-25
echo passwordForce('MinhaSenha123!');    // força da senha
```
```

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance56

Moderate activity, may be stable

Popularity20

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75% 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 ~100 days

Recently: every ~117 days

Total

6

Last Release

297d ago

Major Versions

v1.1.0 → 2.0.x-dev2025-07-25

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/47616335?v=4)[PeAlmeida](/maintainers/PeAlmeida)[@pealmeida](https://github.com/pealmeida)

---

Top Contributors

[![diego-pealmeida](https://avatars.githubusercontent.com/u/52131635?v=4)](https://github.com/diego-pealmeida "diego-pealmeida (3 commits)")[![diegoalmeida-soluct](https://avatars.githubusercontent.com/u/220493736?v=4)](https://github.com/diegoalmeida-soluct "diegoalmeida-soluct (1 commits)")

---

Tags

phplaravelhelperhelperslaravel-helpersphp-helpers

### Embed Badge

![Health badge](/badges/pealmeida-php-helpers/health.svg)

```
[![Health](https://phpackages.com/badges/pealmeida-php-helpers/health.svg)](https://phpackages.com/packages/pealmeida-php-helpers)
```

###  Alternatives

[laravelista/ekko

Framework agnostic PHP package for marking navigation items active.

278673.4k4](/packages/laravelista-ekko)[bayfrontmedia/php-array-helpers

Helper class to provide useful array functions.

1413.4k23](/packages/bayfrontmedia-php-array-helpers)

PHPackages © 2026

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