xefi / faker-php-locales-en-nz
Faker extension to include en_NZ locale
v1.0.1
2026-11-18 10:21 UTC
Requires
- php: ^8.3
- psr/container: ^2.0
- xefi/faker-php: ^1.5.3
Requires (Dev)
- phpunit/phpunit: ^11
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
New Zealand English (en_NZ) locale for Faker PHP.
Installation
composer require --dev xefi/faker-php-locales-en-nz
The service provider is discovered automatically through Composer.
Usage
use Xefi\Faker\Faker; $faker = new Faker('en_NZ');
Generators without a en_NZ variant fall back to the default locale.
Locale-specific generators
$faker->region(); // 'Canterbury' $faker->postcode(); // '8011' $faker->irdNumber(); // IRD number, valid modulus 11 check digit $faker->nzbn(); // New Zealand Business Number, valid GS1 check digit $faker->companyNumber(); // Companies Office number
New Zealand does not use IBAN: iban() returns an IBAN-shaped NZ string built from a bank, branch, account and suffix.
Contributing
- Fork the repository and create a branch from
main. - Add an extension under
src/Extensions/and register it inFakerEnNzServiceProvider::boot(). - Add a test under
tests/Unit/. - Run the suite with
vendor/bin/phpunit(ordocker compose run php vendor/bin/phpunit). - Open a pull request against
main.
License
MIT