Метод upper
Метод upper класса Str преобразует все символы строки в верхний регистр.
В отличие от стандартной PHP-функции strtoupper, этот метод работает с учётом
многобайтовых кодировок, что делает его безопасным для использования
с различными языками, включая кириллицу. Метод возвращает экземпляр
класса Stringable, что позволяет использовать цепочки вызовов.
Синтаксис
<?php
use Illuminate\Support\Str;
Str::upper($string);
?>
Пример
Давайте преобразуем строку в верхний регистр:
<?php
use Illuminate\Support\Str;
$res = Str::upper('hello world');
echo $res;
?>
Результат выполнения кода:
"HELLO WORLD"
Пример
Метод корректно обрабатывает строки на кириллице:
<?php
use Illuminate\Support\Str;
$res = Str::upper('привет мир');
echo $res;
?>
Результат выполнения кода:
"ПРИВЕТ МИР"
Пример
Метод можно использовать в цепочке с другими методами класса Str:
<?php
use Illuminate\Support\Str;
$res = Str::of('Laravel framework')
->upper()
->replace('FRAMEWORK', 'PHP')
->toString();
echo $res;
?>
Результат выполнения кода:
"LARAVEL PHP"
Пример
Метод можно использовать внутри шаблонов Blade для форматирования вывода:
@php
use Illuminate\Support\Str;
@endphp
<h1>@ {{ Str::upper('user profile') }}</h1>
<p>@ {{ Str::upper($username) }}</p>
Если переменная $username содержит значение 'john_doe', то результат:
<h1>USER PROFILE</h1>
<p>JOHN_DOE</p>