Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tavo1987/ec-validador-cedula-ruc
Paquete para validar cedula o ruc de Ecuador
https://github.com/tavo1987/ec-validador-cedula-ruc
cedula composer ecuador paquete php ruc validador-de-cpf validator
Last synced: 1 day ago
JSON representation
Paquete para validar cedula o ruc de Ecuador
- Host: GitHub
- URL: https://github.com/tavo1987/ec-validador-cedula-ruc
- Owner: tavo1987
- License: mit
- Created: 2017-05-29T22:14:59.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-07-19T01:53:39.000Z (over 2 years ago)
- Last Synced: 2024-12-15T05:13:32.722Z (about 1 month ago)
- Topics: cedula, composer, ecuador, paquete, php, ruc, validador-de-cpf, validator
- Language: PHP
- Homepage:
- Size: 24.4 KB
- Stars: 16
- Watchers: 6
- Forks: 12
- Open Issues: 5
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
Validador de Cédula y RUC de Ecuador
=============================
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](https://github.com/diaspar/validacion-cedula-ruc-ecuador) creado por [diaspar](https://github.com/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](https://medium.com/@bryansuarez/c%C3%B3mo-validar-c%C3%A9dula-y-ruc-en-ecuador-b62c5666186f), donde se detalla el proceso manual.
Instalación
----
```bash
composer require tavo1987/ec-validador-cedula-ruc
```
Uso
----
- Primero Asegúrese de requerir al archivo de carga automática de composer así:
```php
require 'vendor/autoload.php';
```
- Luego Instanciar la clase y llamar al método para validar la identificación
Ejemplo:
```php
//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](https://twitter.com/edwin_tavo)
Bryan Suárez
- Twitter: [@BryanSC_7](https://twitter.com/BryanSC_7)