Funciones de comprobación de datos

Funciones de comprobación para la comprobación de formularios

En la lección de Comprobación de datos provenientes de un formulario aprovecharemos dos de las funciones comentadas en esta página:

• Comprobación de números con is_numeric()

  Para comprobar si el dato que se ha recibido es un número (o se puede interpretar como número) se debe utilizar la función is_numeric($valor). Esta función lógica devuelve true si el argumento se puede interpretar como número y false si no lo es.

  El motivo por el que se debe utilizar la función is_numeric($valor), es que lo que se recibe a través de un formulario se guarda siempre como cadena (aunque sea un número). La función is_numeric($valor) es la única que comprueba si el argumento se puede interpretar como número (aunque el argumento sea de tipo cadena), las funciones is_int($valor) o is_float($valor) hacen solamente comprobaciones sobre el tipo de los datos y devolverían siempre false.

• Comprobación de números enteros positivos con ctype_digit()

  Para comprobar si el dato que se ha recibido es un número entero positivo (sin decimales) se puede utilizar la función ctype_digit($valor). Esta función lógica devuelve true si todos los caracteres del argumento son dígitos (0, 1, ..., 9) y false si no lo son.

Funciones is_

Las funciones is_ son un conjunto de funciones booleanas que devuelven true si el argumento es de un tipo de datos determinado y false si no lo son.

Si un dato es demasiado grande para el tipo de variable, las funciones devolverán false. Por ejemplo, si se usa como argumento un entero mayor que PHP_INT_MAX (2147483647 en Windows), la función is_int() devolverá false.

Estas funciones son en general de poca utilidad con datos provinientes de un formulario, ya que estas funciones lo que comprueban es el tipo de los datos y la información que llega de un formulario es siempre del tipo cadena. Las dos excepciones serían:

• la función is_numeric(), que evalúa si el argumento se puede interpretar como número (aunque el tipo sea cadena). Por tanto esta función se puede utilizar para comprobar si un dato recibido de un formulario es un número o no.
• la función isset(), que evalúa si el argumento está o no definido, independientemente de su tipo.

El ejemplo siguiente muestra el uso de la función is_numeric().

<?php
$dato = recoge("dato");

if ($dato == "") {
    print "  <p>No ha escrito nada.</p>\n";
    print "\n";
} elseif (!is_numeric($dato)) {
    print "  <p>NO ha escrito un número: <strong>$dato</strong>.</p>\n";
    print "\n";
} else {
    print "  <p>Ha escrito un número: <strong>$dato</strong>.</p>\n";
    print "\n";
}
?>

El siguiente formulario permite comprobar el resultado de las funciones is_ aplicadas a un dato recibido de un formulario. Como los datos que se reciben de un formulario son de tipo cadena, casi todas las funciones devuelven el resultado false, y resultan inútiles en este contexto.

Funciones ctype_

Las funciones ctype_ son un conjunto de funciones booleanas que devuelven si todos los caracteres de una cadena son de una categoría determinada, de acuerdo con el juego de caracteres local. Estas funciones son las mismas que las que proporciona la biblioteca estándar de C ctype.h.

Estas funciones se pueden aplicar a los datos recibidos de un formulario ya que estas funciones trabajan con cadenas. El problema es que normalmente en una cadena se encuentran caracteres de distintas categorías (letras, números, espacios, puntuación, etc.) y en ese caso estas funciones devuelven el resultado false. Quizás la más útil es:

• la función ctype_digit(), que evalúa si todos los caracteres son dígitos, por lo que permite identificar los números enteros positivos (sin punto decimal ni signo negativo)

El ejemplo siguiente muestra el uso de la función ctype_digit().

<?php
$dato = recoge("dato");

if ($dato == "") {
    print "  <p>No ha escrito nada.</p>\n";
    print "\n";
} elseif (!ctype_digit($dato)) {
    print "  <p>NO ha escrito un entero positivo: <strong>$dato</strong>.</p>\n";
    print "\n";
} else {
    print "  <p>Ha escrito un entero positivo: <strong>$dato</strong>.</p>\n";
    print "\n";
}
?>

El siguiente formulario permite comprobar el resultado de las funciones ctype_ aplicadas a un dato recibido de un formulario.

Funciones filter_

Las funciones filter se crearon como extensión PECL, pero se incluyeron en PHP 5.2 (2006).

La función filter más simple es la función filter_var($valor [, $filtro [, $opciones]]), que devuelve los datos filtrados o false si el filtro falla.

Los filtros predefinidos de validación son los siguientes:

En el caso de las funciones anteriores (funciones is_ y funciones ctype_) estas se pueden utilizar directamente en las condiciones de los bloques if ... elseif ... else ... puesto que devuelven un valor lógico. En el caso de la función filter_var() esta únicamente devuelve un valor lógico cuando el valor no pasa el filtro. Cuando el valor sí que pasa el filtro, la función devuelve el propio valor.

Por ello resulta aconsejable hacer una comparación de tipo con el valor false para detectar que el valor no ha pasado el filtro, como muestra el siguiente ejemplo.

<?php
$dato = recoge("dato");

if ($dato == "") {
    print "  <p>No ha escrito nada.</p>\n";
    print "\n";
} elseif (filter_var($dato, FILTER_VALIDATE_INT) === false) {
    print "  <p>NO ha escrito un número entero: <strong>$dato</strong>.</p>\n";
    print "\n";
} else {
    print "  <p>Ha escrito un número entero: <strong>$dato</strong>.</p>\n";
    print "\n";
}
?>

El caso del filtro FILTER_VALIDATE_BOOLEAN es especial porque en este caso cuando el valor pase el filtro sí que será un valor lógico (que puede ser false), por lo que la detección debe ser distinta.

Falta ejemplo

El siguiente formulario permite comprobar el resultado de la función filter_var() con diferentes filtros aplicada a un dato recibido de un formulario.

Nota: FILTER_VALIDATE_REGEXP no está incluido en el ejemplo anterior porque requiere una expresión regular con la que comprobar el argumento enviado.

Funciones xxx_exists()

<?php
print "<pre>"; print_r($_REQUEST); print "</pre>\n";

$numero = $_REQUEST["numero"];

if (function_exists("filter_var")) {
    if (filter_var($numero, FILTER_VALIDATE_INT)) {
        print "<p>Ha escrito el número entero $numero.</p>\n";
    } else {
        print "<p>NO ha escrito un número entero.</p>\n";
    }
} else {
    print "<p>La función <strong>filter_var</strong> "
        . "no está disponible en este servidor.</p>\n";
}
?>

Array (
    [numero] => 2.5
)

Expresiones regulares

Las expresiones regulares se explican en otra lección.