README

Este pequeño paquete ha sido desarrollado para validar fácilmente:

Cédula
RUC de persona natural
RUC de sociedad privada
RUC de sociedad pública

Introducción

Para el desarrollo de este paquete se ha tomado como base el siguiente repositorio validacion-cedula-ruc-ecuador creado por diaspar, el cual ha sido modificado, para que sea mucho más fácil de instalar y usar en cualquier proyecto PHP mediante composer.

Si quieres saber más sobre la lógica utilizada a este paquete puedes visitar el siguiente artículo Cómo validar cédula y RUC en Ecuador, donde se detalla el proceso manual.

Instalación

composer require tavo1987/ec-validador-cedula-ruc

Uso

Primero Asegúrese de requerir al archivo de carga automática de composer así:

require 'vendor/autoload.php';

Luego Instanciar la clase y llamar al método para validar la identificación

Ejemplo:

//Cargar el autoload de composer
require 'vendor/autoload.php';

// Crear nuevo objeto
$validador = new Tavo\ValidadorEc;

// validar CI
if ($validador->validarCedula('0926687856')) {
    echo 'Cédula válida';
} else {
    echo 'Cédula incorrecta: '.$validador->getError();
}

// validar RUC persona natural
if ($validador->validarRucPersonaNatural('0926687856001')) {
    echo 'RUC válido';
} else {
    echo 'RUC incorrecto: '.$validador->getError();
}

// validar RUC sociedad privada
if ($validador->validarRucSociedadPrivada('0992397535001')) {
    echo 'RUC válido';
} else {
    echo 'RUC incorrecto: '.$validador->getError();
}

// validar RUC sociedad pública
if ($validador->validarRucSociedadPublica('1760001550001')) {
    echo 'RUC válido';
} else {
    echo 'RUC incorrecto: '.$validador->getError();
}

Tests

El paquete se encuentra con su respectiva suite de tests (phpunit) los cuales puedes encontrarlos en el siguiente directorio tests

Cómo contribuir

Si encuentras algún error o quieres agregar más funcionalidad, por favor siéntete libre de abrir un issue o enviar un pull request, que lo analizaremos y agregaremos a nuestro repositorio lo mas pronto posible, siempre y cuando cumpla con las siguientes reglas

Todos los Test deben estar en verde, es decir pasar exitosamente
Si escribes una nueva funcionalidad este debe tener su propio test, para probar la misma

Contactos

Edwin Ramírez

Twitter: @edwin_tavo

Bryan Suárez

Twitter: @BryanSC_7

tavo1987 / ec-validador-cedula-ruc

Maintainers

Details