PHPackages                             juanisorondo/validate.uy - 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. [Validation &amp; Sanitization](/categories/validation)
4. /
5. juanisorondo/validate.uy

ActiveLibrary[Validation &amp; Sanitization](/categories/validation)

juanisorondo/validate.uy
========================

Library for validating data in Uruguayan formats

v3.1.2(1mo ago)0365.6k↓51.7%PHPPHP ^8.1CI passing

Since Mar 17Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/juanisorondo/validate.uy)[ Packagist](https://packagist.org/packages/juanisorondo/validate.uy)[ RSS](/packages/juanisorondo-validateuy/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (1)Dependencies (2)Versions (14)Used By (0)

validate.uy
===========

[](#validateuy)

[![PHP Composer](https://github.com/juanisorondo/validate.uy/actions/workflows/php.yml/badge.svg)](https://github.com/juanisorondo/validate.uy/actions/workflows/php.yml)

Librería PHP para validar documentos uruguayos mediante su formato y dígito verificador.

Actualmente incluye validadores para:

- Cédula de identidad uruguaya (CI).
- Registro Único Tributario (RUT).

> La librería comprueba la estructura y el dígito verificador del documento. No consulta registros oficiales ni confirma que el documento exista o esté vigente.

Requisitos
----------

[](#requisitos)

- PHP 8.1 o superior.
- [Composer](https://getcomposer.org/).

Instalación
-----------

[](#instalación)

Instalá el paquete con Composer:

```
composer require juanisorondo/validate.uy
```

Composer registrará automáticamente las clases mediante PSR-4. Si no usás un framework que cargue el autoloader por vos, incluilo en el punto de entrada de tu aplicación:

```
require_once __DIR__ . '/vendor/autoload.php';
```

Uso
---

[](#uso)

Todos los validadores exponen un método estático `validate()` y devuelven `true`cuando el documento es válido o `false` cuando no lo es.

### Cédula de identidad

[](#cédula-de-identidad)

```
use juanisorondo\ValidadorUruguay\Ci;

Ci::validate('1.212.121-2'); // true
Ci::validate('1212121-2');  // true
Ci::validate('12121212');   // true
Ci::validate('1.212.121-1'); // false
```

Si no se indica un formato, `Ci::validate()` acepta cualquiera de los formatos soportados. Para exigir uno en particular, pasá una de las constantes de `Ci`como segundo argumento:

ConstanteFormato admitidoEjemplo`Ci::DOTS_HYPHEN`Puntos y guion`1.212.121-2``Ci::HYPHEN`Solo guion`1212121-2``Ci::NUMBERS`Solo números`12121212````
use juanisorondo\ValidadorUruguay\Ci;

Ci::validate('1.212.121-2', Ci::DOTS_HYPHEN); // true
Ci::validate('1212121-2', Ci::HYPHEN);        // true
Ci::validate('12121212', Ci::NUMBERS);        // true

// El número es válido, pero no coincide con el formato solicitado.
Ci::validate('1.212.121-2', Ci::NUMBERS);      // false
```

La firma del método es:

```
Ci::validate(string $ci, ?string $format = null): bool
```

### RUT

[](#rut)

El RUT debe contener exactamente 12 dígitos, sin puntos, espacios ni guiones. Es recomendable enviarlo como `string`, especialmente si comienza con cero.

```
use juanisorondo\ValidadorUruguay\Rut;

Rut::validate('210475730011'); // true
Rut::validate('020064100019'); // true
Rut::validate('310475730011'); // false
Rut::validate('21047573001');  // false: no tiene 12 dígitos
```

Desarrollo
----------

[](#desarrollo)

Cloná el repositorio e instalá las dependencias:

```
git clone https://github.com/juanisorondo/validate.uy.git
cd validate.uy
composer install
```

Para ejecutar la suite de tests:

```
vendor/bin/phpunit tests
```

###  Health Score

59

—

FairBetter than 98% of packages

Maintenance93

Actively maintained with recent releases

Popularity34

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 60% 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 ~283 days

Recently: every ~545 days

Total

13

Last Release

35d ago

Major Versions

v1.1.1 → v2.0.02020-04-08

v2.1.0 → v3.0.02024-04-11

PHP version history (2 changes)v1.0.0PHP &gt;=5.6

v3.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/9d6b24a30203ffe182450a393ca15df6c49139a5d31a948126c7833aac2cd431?d=identicon)[juanisorondo](/maintainers/juanisorondo)

---

Top Contributors

[![juanisorondo](https://avatars.githubusercontent.com/u/9666184?v=4)](https://github.com/juanisorondo "juanisorondo (18 commits)")[![lpbonomi](https://avatars.githubusercontent.com/u/38361000?v=4)](https://github.com/lpbonomi "lpbonomi (7 commits)")[![lucasazcue](https://avatars.githubusercontent.com/u/80793281?v=4)](https://github.com/lucasazcue "lucasazcue (2 commits)")[![Andraxxd](https://avatars.githubusercontent.com/u/109233455?v=4)](https://github.com/Andraxxd "Andraxxd (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![JoaquinRuiz7](https://avatars.githubusercontent.com/u/47424155?v=4)](https://github.com/JoaquinRuiz7 "JoaquinRuiz7 (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/juanisorondo-validateuy/health.svg)

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

###  Alternatives

[toplan/laravel-sms

A mobile phone number validation solution based on laravel

83580.2k2](/packages/toplan-laravel-sms)[drupal/coder

Coder is a library to review Drupal code.

3046.8M629](/packages/drupal-coder)[hyperf/validation

hyperf validation

122.2M213](/packages/hyperf-validation)[udokmeci/yii2-phone-validator

Modern Yii2 Phone validator wrapper on top of PhoneNumberUtil library also used by Android devices

36227.5k1](/packages/udokmeci-yii2-phone-validator)[snowcap/vat-validation

EU VAT number validation

10112.3k](/packages/snowcap-vat-validation)

PHPackages © 2026

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