PHPackages                             codaminds/identifiers - 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. codaminds/identifiers

ActiveLibrary

codaminds/identifiers
=====================

Open-source multi-language library for validating national identifiers with a common specification.

v0.2.0(yesterday)10MITPHPPHP ^8.1

Since Aug 16Pushed yesterdayCompare

[ Source](https://github.com/Codaminds/identifiers-php)[ Packagist](https://packagist.org/packages/codaminds/identifiers)[ RSS](/packages/codaminds-identifiers/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

Identifiers (PHP)
=================

[](#identifiers-php)

> PHP implementation of **Codaminds Identifiers** — Specification-driven national document validator.

[![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](LICENSE)[![Latest Version on Packagist](https://camo.githubusercontent.com/840ba2f9e5cc5df0046cacd434b93ba72b796dc8d4dfeada3dea6c7bb5b1407f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f64616d696e64732f6964656e746966696572732e737667)](https://packagist.org/packages/codaminds/identifiers)

---

Notice
------

[](#notice)

> ⚠️ **Read-only Subtree Split:** This repository is a read-only mirror. Please submit issues and pull requests to the main monorepo at [Codaminds/identifiers](https://github.com/Codaminds/identifiers).

---

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

[](#installation)

Requires **PHP 8.2+**.

```
composer require codaminds/identifiers
```

Usage
-----

[](#usage)

```
use Codaminds\Identifiers\Identifier;

// National ID (Cédula)
$isValidId = Identifier::isValid('EC', 'national-id', '0926687856');

// Tax ID (RUC - Natural, Public, or Private)
$isValidRuc = Identifier::isValid('EC', 'tax-id', '0926687856001');

// Detailed validation
$result = Identifier::validate('EC', 'tax-id', '0926687856000');
if (!$result->isValid) {
    echo $result->errorCode;    // 'INVALID_ESTABLISHMENT'
    echo $result->errorMessage; // 'Establishment code must be greater than zero'
}
```

---

Supported Identifiers
---------------------

[](#supported-identifiers)

CountryIdentifierCodeSupport🇪🇨 EcuadorCédula de Identidad`national-id`✅🇪🇨 EcuadorRegistro Único de Contribuyentes (RUC)`tax-id`✅---

### Error Codes Reference

[](#error-codes-reference)

Error CodeDescriptionApplicable Identifiers`INVALID_FORMAT`Value contains non-numeric characters or incorrect pattern`national-id`, `tax-id``INVALID_LENGTH`Length differs from the exact expected digit count`national-id`, `tax-id``INVALID_PROVINCE_CODE`Province code prefix is not between `01`-`24` or `30``national-id`, `tax-id``INVALID_THIRD_DIGIT`Third digit is not within valid ranges for natural, public, or private entities`national-id`, `tax-id``INVALID_ESTABLISHMENT`Establishment branch code is `000` / `0000` (must be > 0)`tax-id``INVALID_CHECKSUM`Verification digit does not match algorithm validation`national-id`, `tax-id`License
-------

[](#license)

MIT © [Codaminds](LICENSE).

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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

Every ~0 days

Total

2

Last Release

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f0141eb5c3e3dea93ea787f301b919a93fb3f763f58dbf0cf4d3e60658fd7822?d=identicon)[codediaz](/maintainers/codediaz)

---

Top Contributors

[![codediaz](https://avatars.githubusercontent.com/u/50778384?v=4)](https://github.com/codediaz "codediaz (4 commits)")

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/codaminds-identifiers/health.svg)

```
[![Health](https://phpackages.com/badges/codaminds-identifiers/health.svg)](https://phpackages.com/packages/codaminds-identifiers)
```

PHPackages © 2026

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