cancio-labs/cep-value-object

A class that represents a CEP (Brazilian Zipcode)

Maintainers

Details

github.com/canciolabs/cep-value-object

Homepage

Source

Issues

Installs: 10

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

pkg:composer/cancio-labs/cep-value-object

1.0.0 2024-06-19 00:15 UTC

Requires

  • php: >=7.4

Requires (Dev)

GPL-3.0-or-later cf2eb65ff8adcb75abd50923bb13b66672f6f3a6

  • Nilo Soares <nilosoares.woop@gmail.com>
  • Cancio Labs <canciolabs.woop@gmail.com>
  • NSCPS Solutions <nscpssolutions.woop@gmail.com>

Value Objectcepbrasil

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 .