xefi / faker-php-locales-es-pe
Faker extension to include es_PE locale
v1.0.1
2026-11-18 10:23 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
Peruvian Spanish (es_PE) locale for Faker PHP.
Installation
composer require --dev xefi/faker-php-locales-es-pe
The service provider is discovered automatically through Composer.
Usage
use Xefi\Faker\Faker; $faker = new Faker('es_PE'); $faker->name(); $faker->fullAddress(); $faker->dni();
The package provides es_PE variants of the address, colors, company, financial, person, phone and text
extensions. Generators without a es_PE variant fall back to the default locale.
Locale-specific generators
| Method | Extension | Description |
|---|---|---|
dni() |
PersonExtension |
8-digit DNI number |
ruc() |
CompanyExtension |
11-digit RUC (prefix 10 or 20) with a valid mod 11 check digit |
department() |
AddressExtension |
Department keyed by its UBIGEO code, e.g. ['15' => 'Lima'] |
postcode() |
AddressExtension |
5-digit postal code starting with a department code |
cci() |
FinancialExtension |
20-digit CCI (Código de Cuenta Interbancario) with valid check digits |
iban() |
FinancialExtension |
IBAN-shaped number built around a CCI (PE; Peru has no IBAN) |
Contributing
- Fork the repository and create a branch from
main. - Add or update an extension under
src/Extensions/and register it inFakerEsPeServiceProvider::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