Guía y comprobaciones
La función de PHP 8
str_starts_with responde si el prefijo está al principio de la cadena. Distingue mayúsculas y minúsculas y devuelve un booleano; no devuelve una posición.
$ruta = 'informe-2026.csv';
var_export(str_starts_with($ruta, 'informe-')); // true
echo PHP_EOL;
var_export(str_starts_with($ruta, 'Informe-')); // false
echo PHP_EOL;
Un prefijo vacío coincide con cualquier cadena, incluso con otra cadena vacía. Si tu aplicación exige que el usuario escriba un prefijo, valida esa condición antes de llamar a la función. El resultado de una función de texto no establece por sí solo una regla del negocio.
Compatibilidad sin el error de posición cero
En código que no dispone de str_starts_with, se puede comparar la posición con cero de forma estricta. Una posición cero es válida, pero se evalúa como falsa si escribes una condición imprecisa.
$texto = 'log: inicio';
var_export(strpos($texto, 'log:') === 0); // true
echo PHP_EOL;
No cambies la comparación por == false: así mezclarías el primer carácter con la ausencia de coincidencia. Tampoco confundas prefijo y fragmento interior: reporte-log: contiene log:, pero no empieza por él.
Qué no demuestra un prefijo
Aceptar sólo nombres que empiezan por foto- no basta para proteger una ruta de archivos. Hay que controlar el directorio, los separadores, los permisos y los tipos aceptados. Del mismo modo, que una URL empiece por el texto https://ejemplo no demuestra que pertenezca al host esperado: una URL debe analizarse como URL y comparar sus componentes.
Para textos de personas, decide además si quieres comparación sensible a mayúsculas, normalización Unicode o una búsqueda lingüística. Esta función realiza una comprobación literal de prefijo; no resuelve equivalencias de acentos ni reglas de idioma.
Preguntas frecuentes
¿Qué devuelve con un prefijo vacío?
Devuelve true. Si el prefijo vacío no es válido para tu caso, recházalo antes de comparar.
¿Sirve para validar un dominio?
No basta. Analiza la URL y compara el host y el esquema permitidos; no uses sólo un prefijo textual.
Continúa con una guía relacionada
Documentación oficial
Fuentes consultadas
Fuentes y referencias
Consulta referencias útiles para ampliar o contrastar esta guía.
Siguiente lectura
Guias relacionadas para continuar
Si quieres seguir con el mismo tema, aqui tienes paginas cercanas que amplian la tecnica, comparan variantes o te llevan a la siguiente rutina.