cancio-labs / cep-value-object
A class that represents a CEP (Brazilian Zipcode)
Installs: 10
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
pkg:composer/cancio-labs/cep-value-object
Requires
- php: >=7.4
Requires (Dev)
- phpunit/phpunit: ^9.6
This package is not auto-updated.
Last update: 2025-10-09 05:58:44 UTC
README
This tiny package contains a class that represents a CEP (Brazilian Zipcode).
Requirements
PHP 7.4 or greater is required, nothing else.
Installation
composer require cancio-labs/cep-value-object
How to use it
use CancioLabs\ValueObject\Cep\Cep;
$cep = new Cep('20710-305'); // or '20710305'
echo $cep; // outputs 22710305
echo $cep->getRaw(); // outputs 22710305
echo $cep->getFormatted(); // outputs 22710-305
The CEP class will validate the given string and throw an exception if it's not a valid CEP (ie if doesn't match either the 99999-999 or 99999999 pattern).
Running Tests
- From the project root, run:
vendor/bin/phpunit .