Awesome
Validador de Cédula y RUC de Ecuador
<p align="center"><img src="http://res.cloudinary.com/edwin/image/upload/v1496095463/cedulaLogo_lmct8r.png"/></p> <p align="center"> <a href="https://app.codeship.com/projects/222775"><img src="https://app.codeship.com/projects/67213cf0-26f5-0135-0866-026545364f16/status?branch=master"></a> <a href="https://packagist.org/packages/tavo1987/ec-validador-cedula-ruc"><img src="https://img.shields.io/badge/Packagist-v1.0.0-orange.svg?style=flat-square"></a> <a href="https://styleci.io/repos/92779185"><img src="https://styleci.io/repos/92779185/shield"></a> <a href="https://packagist.org/packages/tavo1987/ec-validador-cedula-ruc"><img src="https://img.shields.io/github/license/mashape/apistatus.svg?style=flat-square"></a> <a href="https://packagist.org/packages/tavo1987/ec-validador-cedula-ruc"><img src="https://poser.pugx.org/tavo1987/ec-validador-cedula-ruc/downloads" alt="Total Downloads"></a> <a href="https://packagist.org/packages/tavo1987/ec-validador-cedula-ruc"><img src="https://poser.pugx.org/tavo1987/ec-validador-cedula-ruc/v/stable" alt="Total Downloads"></a> </p>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