Download the PHP package insoutt/ec-validator without Composer
On this page you can find all versions of the php package insoutt/ec-validator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download insoutt/ec-validator
More information about insoutt/ec-validator
Files in insoutt/ec-validator
Package ec-validator
Short Description Validador de Cedula, RUC y mas datos de Ecuador
License MIT
Homepage https://github.com/insoutt/ec-validator
Informations about the package ec-validator
Validar Cedula, RUC y más datos de Ecuador
Con insoutt/ec-validator
podrás realizar validaciones de distintos datos que se suele usar frecuentemente en Ecuador, como por ejemplo:
- Validar RUC
- Validar cédula
- Validar número de teléfono fijo
- Validar número de celular
- Validar placa de carro
- Validar placa de moto
Si crees que falta validar alguna información adicional puedes crear una sugerencia en el Foro de Discuciones para desarrollarla o también puedes crear un Pull Request para ser implementado.
Installación
Para instalar el paquete debes ejecutar el siguiente comando en la terminal de tu proyecto:
Uso
Validar Cédula
Validar RUC
El número de RUC no tiene un algoritmo específico definido por lo que no existe un método exacto para validarlo. Ante esto la validación que se realiza es de estructura validando el código de provincia y el número de establecimiento.
Si conoces algún mejor método puedes publicarlo en el Foro de Discuciones o crear un Pull Request para implementarlo.
En el caso de validaciones de un RUC personal si se podría realizar ya que la comprobación sería la misma que la cédula más el código de establecimiento que por lo general es 001
.
Validar placa de un vehículo
Se puede realizar validaciones especificas por placa de moto, placa de carro o también se puede realizar una validación más general para validar ambos casos.
Validar número de celular
Para validar un número de celular existen 3 escenarios:
EcValidator::VALIDATE_NATIONAL
: Número de celular nacional que empieza con09
, para llamadas/mensajes dentro de EcuadorEcValidator::VALIDATE_INTERNATIONAL
: Número de celular con el código de país593
, para llamadas internacionales.EcValidator::VALIDATE_GENERAL
: Validar ambos casos
Validar teléfono convencional
Para los números de teléfono convencionales existen 4 tipos de validaciones:
EcValidator::VALIDATE_LOCAL
: Número de teléfono local para llamadas que son en la misma ciudad/provincia.EcValidator::VALIDATE_NATIONAL
: Número de teléfono con el código de la provincia para llamadas entre distintas ciudades/provincias.EcValidator::VALIDATE_INTERNATIONAL
: Número de teléfono con el código de país y provincia para llamadas internacionales.EcValidator::VALIDATE_GENERAL
: Validar cualquiera de los 3 casos.
API
A continuación se detalla los parámetros disponibles de cada método:
validateCedula($value)
Método | Argumentos | Descripción | Retorno |
---|---|---|---|
validateCedula |
$value (string) |
Valida un número de cédula ecuatoriana. | true si es válido, false si no es válido. |
validateRuc($value)
Método | Argumentos | Descripción | Retorno |
---|---|---|---|
validateRuc |
$value (string) |
Valida un número de RUC ecuatoriano. | true si es válido, false si no es válido. |
validatePlaca($value, $type = self::VALIDATE_GENERAL)
Método | Argumentos | Descripción | Retorno |
---|---|---|---|
validatePlaca |
$value (string), $type (string) |
Valida una placa de vehículo. Tipos: VALIDATE_PLACA_CAR , VALIDATE_PLACA_MOTO , VALIDATE_GENERAL . |
true si es válido, false si no es válido. |
validateCellphone($value, $type = self::VALIDATE_GENERAL)
Método | Argumentos | Descripción | Retorno |
---|---|---|---|
validateCellphone |
$value (string), $type (string) |
Valida un número de celular. Tipos: VALIDATE_GENERAL , VALIDATE_NATIONAL , VALIDATE_INTERNATIONAL . |
true si es válido, false si no es válido. |
validateTelephone($value, $type = self::VALIDATE_GENERAL)
Método | Argumentos | Descripción | Retorno |
---|---|---|---|
validateTelephone |
$value (string), $type (string) |
Valida un número de teléfono fijo. Tipos: VALIDATE_LOCAL , VALIDATE_NATIONAL , VALIDATE_INTERNATIONAL , VALIDATE_GENERAL . |
true si es válido, false si no es válido. |
getError()
Método | Argumentos | Descripción | Retorno |
---|---|---|---|
getError |
Ninguno | Devuelve el último mensaje de error registrado después de una validación fallida. | Mensaje de error o cadena vacía si no hay errores. |
Testing
Al clonar el repositorio en tu máquina local puedes ejecutar el siguiente comando para ejecutar las pruebas.
TIP: Si deseas conocer mejor el funcionamiento de cada método es recomendable revisar los distintos ejemplos disponibles en tests/EcValidatorTest.php
.
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Créditos
- insoutt
- All Contributors
Contacto
- 𝕏 (Twitter): @insoutt
Support us
License
The MIT License (MIT). Please see License File for more information.