PHPackages                             marcin-orlowski/polish-ids-faker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. marcin-orlowski/polish-ids-faker

ActiveLibrary[Utility & Helpers](/categories/utility)

marcin-orlowski/polish-ids-faker
================================

FakerPHP provider for generating various IDs used in Poland

1.0.0(1mo ago)11MITPHP >=8.1

Since Jul 6Compare

[ Source](https://github.com/MarcinOrlowski/php-polish-ids-faker)[ Packagist](https://packagist.org/packages/marcin-orlowski/polish-ids-faker)[ RSS](/packages/marcin-orlowski-polish-ids-faker/feed)WikiDiscussions Synced 1w ago

READMEChangelogDependencies (4)Versions (3)Used By (0)

```

   █▀▀▄      ▀█   ▀       █        ▀█▀ █▀▀▄          █▀▀▀      █
   █  █ ▄▀▀▄  █  ▀█  ▄▀▀▄ █▀▀▄      █  █  █ ▄▀▀▄     █▀▀  ▄▀▀▄ █ ▄▀ ▄▀▀▄ █▄▀
   █▀▀  █  █  █   █   ▀▄  █  █      █  █  █  ▀▄      █     ▄▄█ █▀▄  █▀▀  █
   █    ▀▄▄▀ ▄█▄ ▄█▄ ▀▄▄▀ █  █     ▄█▄ █▄▄▀ ▀▄▄▀     █    ▀▄▄▀ █  █ ▀▄▄▀ █

```

Faker generators for various Polish IDs
=======================================

[](#faker-generators-for-various-polish-ids)

Data provider for various IDs used in Poland as NIP, PESEL, REGON, and others so you can easily generate fake data for testing and development purposes.

Installation
------------

[](#installation)

```
composer require --dev marcin-orlowski/polish-ids-faker
```

Generators
----------

[](#generators)

This extensions provides following generators:

### nip(): string

[](#nip-string)

Produces a valid NIP number in various formats.

#### Arguments

[](#arguments)

ArgumentTypeDefaultDescription`$grouping``NipGrouping``RANDOM`Specifies format of the generated NIP. See [NipGrouping.php](src/NipGrouping.php) for details.### pesel(): string

[](#pesel-string)

Generates a valid Polish PESEL number.

#### Arguments

[](#arguments-1)

ArgumentTypeDefaultDescription`$gender``PeselGender``RANDOM`Enforces PESEL for person of specific gender. See [PeselGender.php](src/PeselGender.php) for details.`$birthDate``?\DateTimeInterface``null`Optional specific date of birth. If null, a random date is generated.### regon(): string

[](#regon-string)

Generates a valid 14-digit long Polish REGON number.

#### Arguments

[](#arguments-2)

None

### kodPocztowy(): string

[](#kodpocztowy-string)

Generates a valid 6 character long Polish Zip code number.

#### Arguments

[](#arguments-3)

None

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance90

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

49d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8041294?v=4)[Marcin Orlowski](/maintainers/MarcinOrlowski)[@MarcinOrlowski](https://github.com/MarcinOrlowski)

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/marcin-orlowski-polish-ids-faker/health.svg)

```
[![Health](https://phpackages.com/badges/marcin-orlowski-polish-ids-faker/health.svg)](https://phpackages.com/packages/marcin-orlowski-polish-ids-faker)
```

###  Alternatives

[verbb/formie

The most user-friendly forms plugin for Craft.

101400.6k79](/packages/verbb-formie)[solspace/craft-freeform

The most flexible and user-friendly form building plugin!

54686.7k25](/packages/solspace-craft-freeform)[blackfire/player

A powerful web crawler and web scraper with Blackfire support

49517.1k](/packages/blackfire-player)[blair2004/nexopos

The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js.

1.2k2.4k](/packages/blair2004-nexopos)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

265.2k](/packages/aedart-athenaeum)[directorytree/dummy

4310.9k](/packages/directorytree-dummy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)