PHP 8: str_starts_with e str_ends_with — como verificar o início e o fim de uma string

Chega de gambiarras: conhecendo str_starts_with e str_ends_with no PHP 8

Você já escreveu um código como if (strpos($str, 'prefix') === 0) e sentiu que parecia meio estranho? Ou talvez tenha perdido tempo decifrando substr($str, -3) === 'end' para verificar o final de uma string? Se sim — tenho uma ótima notícia para você. A partir do PHP 8.0, a linguagem ganhou duas funções elegantes e intuitivas: str_starts_with() e str_ends_with().

Neste artigo, vamos analisá-las de ponta a ponta. Você aprenderá como elas funcionam, como se diferenciam das abordagens antigas e por que vale a pena usá-las em todo projeto PHP moderno. Também veremos exemplos reais do dia a dia do desenvolvedor — desde verificação de URL até validação de email e trabalho com caminhos de arquivos.

O que são str_starts_with() e str_ends_with()?

São funções nativas do PHP 8 que permitem verificar se uma string começa com uma determinada substring ou termina com ela. Elas retornam um valor booleano (true ou false), o que as torna ideais para uso em condições.

Veja a sintaxe básica:

str_starts_with(string $haystack, string $needle): bool\nstr_ends_with(string $haystack, string $needle): bool

Onde $haystack é a string que você está verificando, e $needle é a substring que você procura no início ou no final.

Exemplo simples

<?php\n$string = "Olá, mundo!";\n\n// Verifica se a string começa com "Olá"\nif (str_starts_with($string, "Olá")) {\n    echo "A string começa com 'Olá'"; // Este código será executado\n}\n\n// Verifica se a string termina com "mundo!"\nif (str_ends_with($string, "mundo!")) {\n    echo "A string termina com 'mundo!'"; // E este também\n}\n?>

Simples, não é? Sem cálculos adicionais, sem === 0 ou strlen(). Apenas a verificação e o resultado.

Por que isso é importante? Problemas das abordagens antigas

Antes do PHP 8, os desenvolvedores precisavam se virar. A forma mais popular de verificar o início de uma string era assim:

if (strpos($string, 'prefix') === 0) { ... }

Qual é o problema? strpos() procura a substring em qualquer lugar da string, não apenas no início. Sim, a verificação === 0 elimina resultados incorretos, mas o código em si não expressa a intenção do desenvolvedor. Você olha para ele e pensa: "Hmm, ele está verificando se começa... ou apenas procurando?" — isso reduz a legibilidade.

E a verificação do final da string era ainda menos intuitiva:

if (substr($string, -3) === 'end') { ... }

Aqui, você precisa saber exatamente o comprimento da substring (-3), o que leva a erros se você informar o número errado. Além disso, se a substring for maior que a própria string — substr() simplesmente retornará uma string vazia, e a condição nunca será atendida.

As novas funções str_starts_with() e str_ends_with() resolvem todos esses problemas:

\n
• Legibilidade: O código fala por si só.
\n
• Confiabilidade: Não é preciso pensar no comprimento da substring ou em strings vazias.
\n
• Desempenho: As funções são otimizadas no núcleo do PHP.
\n

Exemplos reais de uso no desenvolvimento web

Vamos ver onde essas funções podem ser úteis na prática. Selecionei alguns cenários que você certamente já encontrou no seu trabalho.

1. Verificação de prefixos de URL (roteamento, redirecionamentos)

Suponha que você esteja escrevendo um roteador simples e queira processar URLs que começam com /admin:

<?php\n$uri = $_SERVER['REQUEST_URI'];\n\nif (str_starts_with($uri, '/admin')) {\n    echo "Você está no painel de administração";\n    // Carrega o