【PHP8.x】mb_lcfirst関数の使い方

mb_lcfirst関数は、指定された文字列の最初の文字を小文字に変換する関数です。PHPには通常のlcfirst関数も存在しますが、これは主にASCII文字のようなシングルバイト文字を扱うことを想定しています。そのため、日本語や中国語といったマルチバイト文字を含む文字列に対してlcfirstを使用すると、意図しない結果になったり、文字化けが発生したりする可能性があります。

mb_lcfirst関数は、このようなマルチバイト文字セットに適切に対応するために提供されており、国際化されたWebアプリケーションなどで多言語の文字列を処理する際に非常に役立ちます。例えば、ユーザーが入力した「こんにちは」のような日本語の文字列の最初の文字を小文字に変換したい場合に、この関数を使うことで「こんには」のように正しく処理できます。

この関数は、変換したい文字列を最初の引数に取ります。さらに、オプションとして文字エンコーディングを指定することが可能です。エンコーディングを指定しない場合は、PHPが内部的に設定しているデフォルトのマルチバイトエンコーディングが自動的に使用されます。変換された文字列が戻り値として返されます。この関数は文字列全体の文字ケースを変更するものではなく、あくまでも最初の文字のみを対象とすることにご注意ください。これにより、文字列の形式を整えたり、特定のルールに基づいて文字列の表示を変更したりする際に、特にマルチバイト文字の扱いが求められる場面で重要な役割を果たします。

<?php
$originalString = "Hello World";
$convertedString = mb_lcfirst($originalString);

string $string, ?string $encoding = null

• string $string: 変換する文字列
• ?string $encoding = null: 文字エンコーディングを指定する文字列。指定しない場合は内部エンコーディングが使用されます。

string

文字列の最初の文字を小文字にした新しい文字列を返します。