matiasiglesias / cbu-validator
Módulo de Validación de CBU
2.0.1
2026-10-28 00:17 UTC
Requires
- php: ^8.1
- laminas/laminas-stdlib: ^3.0
- laminas/laminas-validator: ^2.0
Requires (Dev)
- phpunit/phpunit: ^10.5 || ^11.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Introducción
Módulo Validador de Clave Bancaria Uniforme utilizada en Argentina.
Más información en Wikipedia
Instalación
Instala el módulo con composer agregando el siguiente require "require" en el archivo composer.json
{
"require": {
"matiasiglesias/cbu-validator": "^2.0"
}
}
La 2.x corre sobre PHP 8.1+ y laminas/laminas-validator 2.x (Laminas MVC 3). La 1.x es la de Zend Framework 2 y PHP 5.6 a 7.
luego, ejecuta
$ php composer.phar update
y habilita el módulo en application.config.php
array( 'modules' => array( 'Application', 'CBUValidator', // ... ), );
Uso
Agrega el validador
<?php $inputFilter->add($factory->createInput(array( 'name' => 'cbu', 'required' => true, 'filters' => array( array('name' => 'Digits'), //Filtra los guiones ), 'validators' => array( array( 'name' => 'CBUValidator\Validator\CBU', 'options' => array( 'filterNumeric' => true, //Filtra cualquier caracter no numérico del CBU (ej. '-') ), ), ) ))); ?>
Configuracion
Estas son las opciones del validador:
- filterNumeric Boolean. Filtra cualquier caracter no numérico del CBU (ej. '-'). Valor por defecto true.
- allowCvu Boolean. Acepta también CVU (Claves Virtuales Uniformes, código de entidad
000, usadas por billeteras virtuales como Mercado Pago). Las CVU usan el mismo algoritmo de dígitos verificadores que los CBU, pero no son cuentas bancarias: por defecto el validador las rechaza con un mensaje propio, pensando en casos de uso como débitos bancarios donde una cuenta virtual no sirve. Valor por defecto false.
Contacto
- Via email matiasiglesias@matiasiglesias.com.ar.
- Via Twitter@matiashiglesias
Licencia
CBUValidator is licensed under the MIT license.
See the included LICENSE file.
Copyright (c) 2013-2017 Matias Iglesias
http://www.matiasiglesias.com.ar/
All rights reserved.