Propósito

Esta herramienta cumple una doble función. Primeramente el de validar que la información cumpla el criterio del tipo de información que debe contener y por otra modificar dicho valor para que cumpla un cierto estándar.

Por criterios de compatibilidad y facilidad de uso, el nombre de las funciones solo lleva una palabra capitalizada.

Descripción

Aún cuando está pensada para ejecutarse de forma independiente, contiene algunas funcionalidades propias del sistema. Se encuentra organizado en grupos de funciones de acuerdo a la naturaleza de los datos a recibir.
En su mayoría, las funciones reciben como parámetro un arreglo de variables o un solo valor mismo que es modificado y devuelto corregido. Es decir, cumplen el siguiente criterio de funcionamiento: $x = "valor"; $y = functionY($x); Donde al final del proceso, tanto $x como $y tienen el mismo valor.

Funciones auxiliares (a la librería) o de soporte:

isString(x)

Devuelve el valor booleano si se trata de un string o no. Solo acepta un parámetro.

isArray(x)

Devuelve el valor booleano si se trata de un arreglo o no. Solo acepta un parámetro.

Funciones de soporte a SiteUP!:

isId(x)

Verifica se trate de un identificador. Nótese como no se utilizó como isID() por cuestiones de compatibilidad.

isSubstr(x)

Recibe dos parámetros, buscando coincidencia del primero en el segundo. Anteriormente, era la función validOrigin().

isAlltrue(x)

Verifica que todos los parámetros tengan un valor asignado. Anteriormente, era la función allValues().

Funciones de tipo de datos:

isBool(x)

Verifica sea un valor booleano (1 o 0)

isChar(x)

Verifica se trate de un único carácter

isWord(x)

Verifica no contenga espacios intermedios

isCollapsed(x)

Elimina espacios al principio y final, y sustituye grupos de espacios por uno solo.

isInt(x)

Verifica se trate de un entero

isReal(x)

Verifica se trate de un número real o flotante.

isDate(x)

Verifica sea una fecha en formato yyyy-mm-dd

isDatedmy(x)

Verifica sea una fecha en formato dd-mm-yy Igualmente, no se identifica como DateDMY por cuestiones de compatibilidad

isTime(x)

Verifica sea un formato de hora hh:mm:ss

isDtime(x)

Verifica que sea un formato fecha hora como yyyy-mm-dd hh:mm:ss

Funciones relacionadas a internet:

isText(x)

Sustituye los valores de > y < por sus correspondientes &gt; y &lt;, así como agrega una diagonal invertida al uso de \' y "e;. No debe confundirse el uso de esta función con el método dbClrQuotes del objeto DbConnection o con el uso de las funciones escape() y encode().

isDomain(x)

Verifica se trate de un nombre de dominio www.example.com

isWebsite(x)

Verifica sea la dirección raíz de un sitio web http://www.example.com/

isFtpsite(x)

Verifica sea la dirección raíz de un sitio ftp fttp://www.example.com/

isUrl(x)

Verifica sea un uRL válido http://www.example.com/pathto/resource.file

isEmail(x)

Verifica sea una dirección email something@example.com.

isHexcolor(x)

Verifica sea un valor hexadecimal de color

isIp(x)

Verifica sea una dirección IP v4 o v6.

Otras funciones:

isPhone(x)

Verifica se trate de un número telefónico en formato (nn) nnn-nnnn

isRfc(x)

Verifica sea un código RFC

isSocialsecurity(x)

Verifica sea un número de seguridad social.

Uso

Estas funciones son utilizadas en dos partes. En los formularios (js) a fin de validar los parámetros introducidos; así como en los cgis (pl) a fin de verificar la validez de los datos recibidos. Esta doble verificación es necesaria a fin de prevenir datos erróneos por inyección de código o alteración de parámetros por via GET.

En el caso del sistema SiteUP!, los campos en formularios que contienen la clase validate son validados de acuerdo al valor contenido en data-valid, para posteriormente ser modificados o adquiriendo la clase .error en caso de no cumplir el estándar.

Ver ejecución