Implementação prática

Validar CPF em PHP: função simples para formulários e APIs

PHP continua muito presente em sistemas administrativos, sites institucionais, CRMs e integrações. Por isso, a busca por validação de CPF nessa linguagem segue relevante.

validar cpf phpfunção cpf phpcpf laravelcpf backend

Veja como validar CPF em PHP com limpeza da entrada, bloqueio de sequência repetida e cálculo dos dois dígitos verificadores. Esta página faz parte do cluster semântico de Gerador de CPF e conecta intenção informacional, linguagem de produto e contexto técnico.

Bloco semântico

Onde a função se encaixa

A validação pode rodar em controllers, requests, serviços de domínio ou helpers, dependendo da arquitetura da aplicação. O importante é manter a regra central testável e desacoplada do framework.

Em aplicações mais maduras, vale encapsular a lógica em um value object ou serviço próprio.

Bloco semântico

Etapas mínimas

Assim como em outras linguagens, o fluxo é limpar a entrada, checar tamanho, bloquear sequências repetidas e recalcular os dois verificadores.

O erro comum é tentar validar apenas com padrão visual, sem executar a conta do CPF.

Bloco semântico

Uso em APIs e formulários

Quando a API recebe o documento sem pontuação, basta normalizar a entrada e devolver mensagens consistentes. Em formulários HTML, a mesma lógica pode coexistir com máscara e feedback visual.

O mais importante é não tratar o front-end como única linha de defesa.

Exemplo de código

Exemplo de validador em PHP

O trecho abaixo cobre validação estrutural. Se houver uso em produção, mantenha a regra alinhada entre front-end, back-end e testes.

<?php
function validarCPF(string $valor): bool
{
    $cpf = preg_replace('/\D/', '', $valor);

    if (strlen($cpf) !== 11 || preg_match('/^(\d)\1{10}$/', $cpf)) {
        return false;
    }

    $calcularDigito = function (string $base, int $pesoInicial): string {
        $soma = 0;

        for ($i = 0; $i < strlen($base); $i++) {
            $soma += (int) $base[$i] * ($pesoInicial - $i);
        }

        $resto = $soma % 11;
        return $resto < 2 ? '0' : (string) (11 - $resto);
    };

    $base = substr($cpf, 0, 9);
    $dv1 = $calcularDigito($base, 10);
    $dv2 = $calcularDigito($base . $dv1, 11);

    return $cpf === $base . $dv1 . $dv2;
}

Teste a mesma lógica em uma interface pronta no navegador.

Comparar com o validador online

Cluster semântico

Páginas irmãs dentro do cluster

Essas páginas compartilham contexto semântico próximo e ajudam a reforçar a arquitetura topical do domínio.

Validar CPF em JavaScript

Aprenda a validar CPF em JavaScript com uma função simples, incluindo limpeza da entrada, bloqueio de sequência repetida e cálculo dos verificadores.

javascript cpfvalidar cpf jsfunção cpfregex cpf

Validar CPF em Python

Aprenda a validar CPF em Python com uma função clara para uso em scripts, pipelines de dados, back-end e automação.

validar cpf pythonpython cpfetl cpfscript validar cpf

Gerador de CPF em massa

Gere vários CPFs válidos de uma vez para seeders, testes automatizados, homologação e importação de dados fictícios.

cpf em massalista de cpfgerar vários cpfsdados para seed

CPF falso para teste

Entenda o que as pessoas chamam de CPF falso para teste, por que o termo correto é CPF fictício válido e em quais cenários isso faz sentido.

cpf falsocpf fictíciocpf para testedado fake

CPF com pontuação

Saiba quando faz sentido usar CPF com pontuação, como a máscara melhora a leitura e em quais fluxos o dado deve ser armazenado sem formatação.

cpf formatadocpf com máscara000.000.000-00pontuação do cpf

Cluster semântico

Voltar para os hubs principais

Além das variantes programáticas, estes hubs concentram as páginas mais centrais do projeto.

Validar CPF

Saiba como conferir se um número passa no dígito verificador, como tratar sequências repetidas e por que nem todo CPF válido é um CPF real.

validaçãodígito verificadorCPF inválido

Como funciona o CPF

Entenda a estrutura de 11 dígitos, a máscara de formatação, a função dos verificadores e a relação com cadastros e sistemas.

estruturamáscaranúmero de cadastro

Algoritmo do CPF

Veja a conta do módulo 11, os pesos usados na soma e como transformar a lógica em regra de negócio para software.

módulo 11pesoscheck digits

CPF para teste

Use CPFs gerados apenas em QA, homologação, mockups e desenvolvimento. Compare exemplos formatados e sem máscara.

QAhomologaçãodados fictícios

Perguntas frequentes

Concentre as dúvidas mais comuns sobre geração, validação, formatação, segurança e uso responsável de CPF fictício.

FAQdúvidasboas práticas