(PHP 8 >= 8.4.0)
mb_ucfirst — Converte para maiúscula o primeiro caractere de uma string
Realizad uma operação ucfirst() segura para strings multi-byte,
e retorna uma string com o primeiro caractere do parâmetro
string convertido para letra de título.
stringencodingRetorna a string resultante.
Nota:
Em contraste com as funções padrão de conversão de maiúsculas e minúsculas, como strtolower() e strtoupper(), a conversão é executada com base nas propriedades dos caracteres Unicode. Assim, o comportamento desta função não é afetado pelas configurações de localidade e pode converter quaisquer caracteres que tenham propriedade 'alphabetic' (alfabética), como trema (ä) por exemplo.
Para obter mais informações sobre as propriedades Unicode, consulte » http://www.unicode.org/reports/tr21/.
polyfill:
<?php
if(PHP_VERSION_ID < 80400) {
function mb_ucfirst(string $str, string $encoding = null): string
{
if ($encoding === null) {
$encoding = mb_internal_encoding();
}
return mb_strtoupper(mb_substr($str, 0, 1, $encoding), $encoding) . mb_substr($str, 1, null, $encoding);
}
}
?>
if you wonder why i bother with mb_internal_encoding: prior to php7, $encoding was not nullable. if your polyfill don't need php5.6 support, you can drop it.