Search by

matiasiglesias / cbu-validator

matiasiglesias

Módulo de Validación de CBU

Package info

github.com/matiasiglesias/cbu-validator

pkg:composer/matiasiglesias/cbu-validator

Statistics

Installs: 779

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

2.0.1 2026-10-28 00:17 UTC

This package is auto-updated.

Last update: 2026-10-28 00:18:16 UTC


README

Latest Stable Version Latest Unstable Version Total Downloads License composer.lock available Dependency Status SensioLabsInsight PHP_Eye PHP_Eye

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

  1. Via email matiasiglesias@matiasiglesias.com.ar.
  2. 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.