lacus / cnpj-gen
Utility function to generate valid CNPJ (Brazilian employer ID)
Requires
- php: >=8.1
Requires (Dev)
- phpunit/phpunit: ^10.5
- spatie/phpunit-watcher: ~1.24
This package is auto-updated.
Last update: 2025-09-23 05:03:28 UTC
README
Utility function/class to generate valid CNPJ (Brazilian employer ID).
PHP Support
Passing ✔ | Passing ✔ | Passing ✔ |
Installation
# using Composer
$ composer require lacus/cnpj-gen
Import
<?php // Using class-based resource use Lacus\CnpjGen\CnpjGenerator; // Or using function-based one use function Lacus\CnpjGen\cnpj_gen;
Usage
Object-Oriented Usage
$generator = new CnpjGenerator(); $cnpj = $generator->generate(); // returns '65453043000178' // With options $cnpj = $generator->generate( format: true ); // returns '65.453.043/0001-78' $cnpj = $generator->generate( prefix: '45623767' ); // returns '45623767000296' $cnpj = $generator->generate( prefix: '456237670002', format: true ); // returns '45.623.767/0002-96'
The options can be provided to the constructor or the generate()
method. If passed to the constructor, the options will be attached to the CnpjGenerator
instance. When passed to the generate()
method, it only applies the options to that specific call.
$generator = new CnpjGenerator(format: true); $cnpj1 = $generator->generate(); // '65.453.043/0001-78' (uses instance options) $cnpj2 = $generator->generate(format: false); // '65453043000178' (overrides instance options) $cnpj3 = $generator->generate(); // '12.345.678/0001-95' (uses instance options again)
Imperative programming
The helper function cnpj_gen()
is just a functional abstraction. Internally it creates an instance of CnpjGenerator
and calls the generate()
method right away.
$cnpj = cnpj_gen(); // returns '65453043000178' $cnpj = cnpj_gen(format: true); // returns '65.453.043/0001-78' $cnpj = cnpj_gen(prefix: '45623767'); // returns '45623767000296' $cnpj = cnpj_gen(prefix: '456237670002', format: true); // returns '45.623.767/0002-96'
Generator Options
Parameter | Type | Default | Description |
---|---|---|---|
format |
?bool |
false |
Whether to format the output with dots, slash, and dash |
prefix |
?string |
'' |
If you have CNPJ initials and want to complete it with valid digits. The string provided must contain between 0 and 12 digits. The branch ID (characters 8 to 11) cannot be "0000". |
Contribution & Support
We welcome contributions! Please see our Contributing Guidelines for details. But if you find this project helpful, please consider:
- ⭐ Starring the repository
- 🤝 Contributing to the codebase
- 💡 Suggesting new features
- 🐛 Reporting bugs
License
This project is licensed under the MIT License - see the LICENSE file for details.
Changelog
See CHANGELOG for a list of changes and version history.
Made with ❤️ by Lacus Solutions