Función para validar DNI (NIF), CIF, NIE con PHP

En este post, exploraremos una función en PHP diseñada para validar los principales formatos de identificación utilizados en España: DNI (NIF), CIF, y NIE. Estos números son fundamentales para identificar tanto a personas físicas como jurídicas en procedimientos oficiales.

Si prefieres usar JavaScript para hacer esta validación échale un vistazo a esta entrada, Función para validar DNI (NIF), CIF y NIE con JavaScript

Sintaxis

validDniCifNie(dni);

Devuelve un booleano, true si es válido y false si no cumple las condiciones.

💡 Explicación del código

Código PHP

/**
 * Validar DNI (NIF), CIF, NIE
 *
 * @param string $dni Número de identificación
 *
 * @return bool Si es válido (true) o no (false)
 */
function validDniCifNie($dni) {
    $dni = strtoupper($dni); // Convertir a mayúsculas
    $letras = 'TRWAGMYFPDXBNJZSQVHLCKE';

    // Validar formato general
    if (!preg_match('/^[A-Z0-9]{9}$/', $dni)) {
        return false;
    }

    // Validar NIF estándar (8 números + 1 letra)
    if (preg_match('/^[0-9]{8}[A-Z]$/', $dni)) {
        $numero = substr($dni, 0, 8);
        $letra = substr($dni, -1);
        return $letra === $letras[$numero % 23];
    }

    // Validar NIE (X, Y, Z seguido de 7 números y una letra)
    if (preg_match('/^[XYZ][0-9]{7}[A-Z]$/', $dni)) {
        $numero = str_replace(['X', 'Y', 'Z'], ['0', '1', '2'], substr($dni, 0, 1)) . substr($dni, 1, 7);
        $letra = substr($dni, -1);
        return $letra === $letras[$numero % 23];
    }

    // Validar CIF (letra + 7 números + letra/número)
    if (preg_match('/^[ABCDEFGHJNPQRSUVW][0-9]{7}[A-Z0-9]$/', $dni)) {
        $sumaPar = 0;
        $sumaImpar = 0;

        for ($i = 1; $i <= 6; $i += 2) {
            $sumaPar += (int) $dni[$i];
        }

        for ($i = 0; $i <= 6; $i += 2) {
            $doble = (int) $dni[$i] * 2;
            $sumaImpar += $doble > 9 ? $doble - 9 : $doble;
        }

        $sumaTotal = $sumaPar + $sumaImpar;
        $control = (10 - ($sumaTotal % 10)) % 10;

        $controlEsperado = $dni[8];
        if (ctype_alpha($controlEsperado)) {
            return $controlEsperado === chr(64 + $control); // Letra como control
        } else {
            return $controlEsperado == $control; // Número como control
        }
    }

    // Validar NIE especial (T seguido de 8 caracteres)
    if (preg_match('/^T[0-9]{8}$/', $dni)) {
        return true; // Se acepta directamente
    }

    return false; // No cumple ningún formato válido
}

¿Qué hace esta función?

La función validDniCifNie recibe como entrada un número de identificación y valida si este corresponde a un formato válido de DNI, CIF o NIE. Además, comprueba la validez del número de control (letra o dígito, dependiendo del caso) que forma parte de estos documentos.

Si quieres generar números de identificación ficticios, pero correctos te recomiendo esta página Generador de DNI

Estructura básica de los identificadores

1. DNI/NIF (Número de Identificación Fiscal): 8 dígitos y 1 letra de control.
   Ejemplo: 12345678A.

2. NIE (Número de Identidad de Extranjero): Comienza con X, Y o Z, seguido de 7 dígitos y una letra de control.
   Ejemplo: X1234567L.

3. CIF (Código de Identificación Fiscal): Letra inicial (que indica el tipo de entidad), 7 dígitos y un carácter de control (letra o dígito).
   Ejemplo: A1234567H.

4. NIE especial: Inicia con la letra T seguida de 8 dígitos.
   Ejemplo: T12345678.

Funcionamiento del código

1. Conversión a mayúsculas

$dni = strtoupper($dni); // Convertir a mayúsculas

Antes de realizar cualquier validación, el código convierte el identificador a mayúsculas para uniformizar el tratamiento de los datos.

2. Validar formato general

if (!preg_match('/^[A-Z0-9]{9}$/', $dni)) {
    return false;
}

Se verifica que el identificador tenga exactamente 9 caracteres alfanuméricos.

3. Validación del NIF estándar

El código utiliza el módulo 23 para calcular la letra de control del NIF. Esta se compara con la letra proporcionada en el identificador.

if (preg_match('/^[0-9]{8}[A-Z]$/', $dni)) {
    $numero = substr($dni, 0, 8);
    $letra = substr($dni, -1);
    return $letra === $letras[$numero % 23];
}

4. Validación del NIE

Para los NIE que comienzan con X, Y o Z, se transforman estas letras en números (X = 0, Y = 1, Z = 2) y luego se calcula la letra de control.

if (preg_match('/^[XYZ][0-9]{7}[A-Z]$/', $dni)) {
    $numero = str_replace(['X', 'Y', 'Z'], ['0', '1', '2'], substr($dni, 0, 1)) . substr($dni, 1, 7);
    $letra = substr($dni, -1);
    return $letra === $letras[$numero % 23];
}

5. Validación del CIF

Para el CIF, se realizan cálculos separados sobre los dígitos en posiciones pares e impares. El carácter de control puede ser una letra o un número, y se valida en consecuencia.

if (preg_match('/^[ABCDEFGHJNPQRSUVW][0-9]{7}[A-Z0-9]$/', $dni)) {
    $sumaPar = 0;
    $sumaImpar = 0;

    for ($i = 1; $i <= 6; $i += 2) {
        $sumaPar += (int) $dni[$i];
    }

    for ($i = 0; $i <= 6; $i += 2) {
        $doble = (int) $dni[$i] * 2;
        $sumaImpar += $doble > 9 ? $doble - 9 : $doble;
    }

    $sumaTotal = $sumaPar + $sumaImpar;
    $control = (10 - ($sumaTotal % 10)) % 10;

    $controlEsperado = $dni[8];
    if (ctype_alpha($controlEsperado)) {
        return $controlEsperado === chr(64 + $control); // Letra como control
    } else {
        return $controlEsperado == $control; // Número como control
    }
}

6. Validación del NIE especial

Los NIE especiales que comienzan con T se consideran válidos sin validación adicional.

if (preg_match('/^T[0-9]{8}$/', $dni)) {
    return true; // Se acepta directamente
}

Para hacer la validación usando JavaScript pásate por esta entrada Función para validar DNI (NIF), CIF y NIE con JavaScript

---

❓ FAQ

¿Cómo validar un DNI o NIF en PHP?

Para validar un DNI/NIF se comprueba que tenga 8 dígitos seguidos de una letra de control. La letra se calcula con el módulo 23 y debe coincidir con la proporcionada en el número.

¿Cuál es la diferencia entre DNI, NIF, CIF y NIE?

El DNI o NIF identifica a ciudadanos españoles, el NIE identifica a extranjeros, y el CIF corresponde a empresas y entidades jurídicas.

¿Qué expresiones regulares se usan para validar identificadores españoles?

DNI/NIF: ^[0-9]{8}[A-Z]$, NIE: ^[XYZ][0-9]{7}[A-Z]$, CIF: ^[ABCDEFGHJNPQRSUVW][0-9]{7}[A-Z0-9]$, y NIE especial: ^T[0-9]{8}$.

¿Se puede validar un CIF con PHP?

Sí. El algoritmo suma los dígitos pares e impares, calcula el dígito de control y lo compara con el último carácter del CIF, que puede ser una letra o un número.

¿El NIE funciona igual que el NIF?

En el NIE, la letra inicial (X, Y, Z) se convierte en un número (0, 1 o 2) antes de calcular la letra de control con el mismo algoritmo que el NIF.

¿Qué devuelve la función validDniCifNie en PHP?

Devuelve true si el número es válido y false si no cumple con ningún formato aceptado.