sousa7tz/br-data-tools

A clean PHP library to sanitize, validate, format and mask Brazilian CPF and CNPJ documents.

Maintainers

Package info

github.com/sousa7tz/br-data-tools

pkg:composer/sousa7tz/br-data-tools

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.0.0 2026-04-24 12:39 UTC

Requires

  • php: >=8.0

Requires (Dev)

MIT 96e11cfb76b62f43c410bb20fd7f164761f0a574

This package is auto-updated.

Last update: 2026-04-24 12:47:03 UTC

README

br-data-tools is a lightweight PHP 8+ library for Brazilian document handling. It provides sanitization, validation, formatting and masking for CPF and CNPJ values.

Installation

composer require sousa7tz/br-data-tools

Usage

Sanitizer

<?php

use BrDataTools\Support\Sanitizer;

echo Sanitizer::numbers('CPF: 123.456.789-00');
// 12345678900

CPF

<?php

use BrDataTools\Document\CPF;

$cpf = '529.982.247-25';

CPF::sanitize($cpf); // 52998224725
CPF::isValid($cpf);  // true
CPF::format($cpf);   // 529.982.247-25

CNPJ

<?php

use BrDataTools\Document\CNPJ;

$cnpj = '04.252.011/0001-10';

CNPJ::sanitize($cnpj); // 04252011000110
CNPJ::isValid($cnpj);  // true
CNPJ::format($cnpj);   // 04.252.011/0001-10

Mask

<?php

use BrDataTools\Support\Mask;

echo Mask::apply('12345678900', '###.###.###-##');
// 123.456.789-00

Running tests

vendor/bin/phpunit tests