Download the PHP package aeunius/laravel-peru-rules without Composer

On this page you can find all versions of the php package aeunius/laravel-peru-rules. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of aeunius/laravel-peru-rules

Informations about the package laravel-peru-rules

Laravel Peru Rules

Reglas de validación de Laravel para documentos y datos peruanos: RUC, DNI, carné de extranjería, pasaporte, celular, placa vehicular y CCI. Validan el formato y los dígitos de control sin conectarse a ningún servicio externo.

tests Versión en Packagist Descargas

Qué valida

Regla En texto Qué comprueba
new Ruc ruc 11 dígitos, prefijo 10, 15, 16, 17 o 20, y dígito verificador
Ruc::natural() ruc:natural Lo mismo, pero solo con el prefijo 10 (persona natural)
Ruc::juridica() ruc:juridica Lo mismo, pero solo con el prefijo 20 (persona jurídica)
new Dni dni 8 dígitos
new CarneExtranjeria carne_extranjeria Hasta 12 letras o números
new Pasaporte pasaporte Hasta 12 letras o números
DocumentoIdentidad::segun('tipo_doc') documento_identidad:tipo_doc El número según el tipo de documento de otro campo (catálogo 06 de la SUNAT)
new Celular celular 9 dígitos que empiezan con 9; acepta +51 y separadores
new PlacaVehicular placa_vehicular Autos: ABC-123 o A1B-234, con o sin guion. Especiales con prefijo E: E GA-123, eGA-123. Motos: 2171-AY, 5040-6C, C5-4481
new Cci cci 20 dígitos y los dos dígitos de control; acepta espacios y guiones

Se comprueba que el número sea válido, no que exista: un RUC puede tener un dígito verificador correcto y aun así no estar inscrito o no estar activo en la SUNAT.

Requisitos

Instalación

El service provider se registra solo.

Uso

También como reglas en texto:

Los valores se validan tal como llegan: 20-13131295-5 o un RUC con espacios no pasan. Si tu formulario los admite, límpialos antes de validar. Se aceptan textos y enteros; un DNI con ceros a la izquierda (00123456) solo llega completo como texto.

Como cualquier regla de Laravel que no es required, las reglas no se aplican a un campo vacío.

Documento según su tipo

Cuando el formulario pide el tipo y el número de documento, DocumentoIdentidad valida el número con la regla que corresponde al tipo. Los tipos son los del catálogo 06 de la SUNAT, los mismos de la facturación electrónica:

Código Tipo Se valida con
0 Documento tributario de no domiciliado sin RUC Hasta 15 letras o números
1 DNI Dni
4 Carné de extranjería CarneExtranjeria
6 RUC Ruc
7 Pasaporte Pasaporte
A Cédula diplomática de identidad Hasta 15 letras o números

El mensaje de error es el de la regla de cada tipo. Si el tipo falta o no es válido, el número tampoco pasa. En arreglos se usan comodines: DocumentoIdentidad::segun('clientes.*.tipo_doc') valida clientes.2.num_doc con clientes.2.tipo_doc.

El enum también sirve fuera de la validación:

RUC como objeto en tus modelos

ValueObjects\Ruc representa un RUC que ya pasó la validación: no se puede crear con uno inválido. Úsalo como cast de Eloquent:

En la base de datos se guardan los 11 dígitos como texto, y toArray() y toJson() también devuelven los 11 dígitos. El cast es estricto al leer: si la tabla tiene un RUC inválido, lanza una excepción en vez de devolver null.

Fuera de Eloquent:

Si en el mismo archivo usas también la regla Rules\Ruc, importa uno de los dos con alias: use Aeunius\PeruRules\ValueObjects\Ruc as RucValor;.

Celular, placa y CCI: normalizar antes de guardar

Las reglas Celular, PlacaVehicular y Cci aceptan varias formas de escribir el mismo dato. Para guardarlo siempre igual, normalízalo, por ejemplo en prepareForValidation() de un Form Request:

En las placas de motos del tipo C5-4481 el guion es obligatorio: sin él, C54481 se lee como la placa de auto C54-481.

Sin Laravel

Los algoritmos no dependen de Laravel y se pueden usar directamente:

Mensajes

Los mensajes vienen en español e inglés y siguen el idioma activo de la aplicación. Para cambiarlos, publica las traducciones:

y edita lang/vendor/peru-rules/{es,en}/validation.php. En las reglas en texto también tienen prioridad los mensajes de tu aplicación: validation.ruc en lang/es/validation.php o el arreglo de mensajes del validador.

Cómo se valida el RUC

El RUC tiene 11 dígitos: un prefijo de 2, 8 dígitos de identificación y un dígito verificador. Para una persona natural, los 8 del medio son su DNI.

  1. Multiplica los 10 primeros dígitos por los pesos 5 4 3 2 7 6 5 4 3 2.
  2. Suma los productos.
  3. Calcula r = 11 − (suma mod 11). Si r es 10, el dígito es 0; si es 11, es 1.
  4. r tiene que ser igual al último dígito.

Por ejemplo, para el RUC de la SUNAT, 20131312955:

Cómo se valida el CCI

El CCI tiene 20 dígitos: entidad (3), oficina (3), cuenta (12) y dos dígitos de control. El primero verifica entidad + oficina, y el segundo, la cuenta. Cada uno se calcula así:

  1. Multiplica los dígitos, de izquierda a derecha, por 1, 2, 1, 2, ….
  2. Si un producto tiene dos cifras, suma sus cifras (14 cuenta como 1 + 4).
  3. Suma todo. El dígito de control es lo que falta para la siguiente decena: (10 − suma mod 10) mod 10.

Para 002-191-000123456789-57:

No hay una especificación pública del algoritmo. Se comprobó con 11 CCI que empresas publican para recibir pagos, de BCP, BBVA, Interbank, Banco de la Nación, Caja Arequipa y Caja Piura: coinciden los 22 dígitos de control. Solo se valida el formato: el paquete no sabe si la cuenta existe ni si el código de entidad está asignado.

Comparación con otros paquetes

Paquete Qué cubre Diferencia
consulta/laravel RUC y DNI Consulta un servicio externo; este paquete funciona sin conexión
esolutions/peru Dígito verificador del RUC, formato del DNI Este paquete agrega reglas de Laravel en objeto y en texto, con mensajes traducidos

En JavaScript

@aeunius/peru-rules da el mismo resultado en el navegador o en Node, porque se prueba con los casos de este paquete (tests/fixtures/). Sirve para validar el formulario antes de enviarlo, e incluye reglas para Vue (Vuetify, Quasar y VeeValidate):

Si cambias una regla, cambia primero los casos en tests/fixtures/ y publica un tag: el paquete de JavaScript fija sus casos a un tag de este repositorio.

Desarrollo

Todo corre en Docker con la imagen oficial composer:2, así que no hace falta tener PHP instalado:

El CI prueba con Laravel 12 y 13, con PHP 8.2 a 8.5, y también con las versiones mínimas de las dependencias.

Los cambios de cada versión están en el CHANGELOG.

Licencia

MIT. Ver LICENSE.md.

All versions of laravel-peru-rules with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
illuminate/contracts Version ^12.0|^13.0
illuminate/support Version ^12.0|^13.0
illuminate/validation Version ^12.0|^13.0
spatie/laravel-package-tools Version ^1.16.2
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package aeunius/laravel-peru-rules contains the following files

Loading the files please wait ...