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

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * strtolower()関数の使用例を示すためのサンプル関数
7 *
8 * この関数は、受け取った文字列を小文字に変換し、
9 * 変換前と変換後の両方を画面に出力します。
10 *
11 * @param string $string 変換対象の文字列
12 * @return void
13 */
14function showLowerCaseConversion(string $string): void
15{
16    // strtolower()関数を使い、文字列内のアルファベットをすべて小文字に変換します。
17    // 数字や記号は変更されません。
18    $lowerCaseString = strtolower($string);
19
20    // 結果を比較しやすくするために、変換前と変換後の文字列を出力します。
21    // PHP_EOL は、環境に応じた改行コードを出力するための定義済み定数です。
22    echo '変換前の文字列: ' . $string . PHP_EOL;
23    echo '変換後の文字列: ' . $lowerCaseString . PHP_EOL;
24}
25
26// 大文字、小文字、数字、記号が混在したサンプル文字列を定義します。
27$sampleText = 'Hello World! This is PHP 8 Sample Code.';
28
29// 定義した関数を呼び出し、サンプル文字列を小文字に変換して表示します。
30showLowerCaseConversion($sampleText);
31
32?>

PHPのstrtolower関数は、文字列に含まれるすべてのアルファベットを小文字に変換するために使用されます。

この関数は、string $stringとして変換したい文字列を引数に取ります。指定された文字列内の大文字のアルファベットのみを小文字に変換し、新しい文字列を戻り値として返します。数字や記号は変換の対象外となり、元のまま保持されます。

サンプルコードでは、'Hello World! This is PHP 8 Sample Code.'という文字列を例に、strtolower関数の動作を示しています。この文字列をstrtolower関数に渡すと、すべてのアルファベットが大文字から小文字に変換され、'hello world! this is php 8 sample code.'という結果が生成されます。

実行結果として、変換前の元の文字列と、strtolower関数によって小文字に変換された文字列の両方が画面に表示され、関数の動作が分かりやすく確認できます。出力時に使用されているPHP_EOLは、プログラムが実行されている環境に合わせた改行コードを挿入するためのPHPの定数です。strtolower関数は、文字列の大文字・小文字を簡単に操作できる基本的な機能です。

Copy
1<?php
2
3/**
4 * strtolower() 関数が特殊文字 (特にマルチバイト文字) をどのように扱うかを示すサンプル。
5 *
6 * strtolower() はASCII文字のみを小文字に変換します。
7 * マルチバイト文字 (日本語、全角英数字など) には影響しません。
8 */
9function demonstrateStrtolowerWithSpecialCharacters(): void
10{
11    // 1. 標準的なASCII文字列の変換
12    $asciiString = "HELLO World 123!@#";
13    echo "オリジナル (ASCII):       " . $asciiString . PHP_EOL;
14    echo "strtolower 適用後: " . strtolower($asciiString) . PHP_EOL;
15    echo PHP_EOL;
16
17    // 2. マルチバイト文字 (日本語) を含む文字列の変換
18    // strtolower() はマルチバイト文字には作用しません。
19    $multibyteString = "PHP の特殊文字 (テスト) と MultiByte STRING";
20    echo "オリジナル (マルチバイト): " . $multibyteString . PHP_EOL;
21    echo "strtolower 適用後: " . strtolower($multibyteString) . PHP_EOL;
22    echo PHP_EOL;
23
24    // 3. 全角英数字の変換
25    // 全角英数字もマルチバイト文字として扱われるため、strtolower() では変換されません。
26    $fullwidthChars = "ＡＢＣＤＥＦＧＨＩＪＫＬＭＮＯＰＱＲＳＴＵＶＷＸＹＺ";
27    echo "オリジナル (全角英数字):  " . $fullwidthChars . PHP_EOL;
28    echo "strtolower 適用後: " . strtolower($fullwidthChars) . PHP_EOL;
29    echo PHP_EOL;
30
31    // 注意: マルチバイト文字を小文字に変換したい場合は、mb_strtolower() を使用してください。
32    // echo "mb_strtolower 適用後: " . mb_strtolower($multibyteString, 'UTF-8') . PHP_EOL;
33    // echo "mb_strtolower 適用後 (全角): " . mb_strtolower($fullwidthChars, 'UTF-8') . PHP_EOL;
34}
35
36// 関数の実行
37demonstrateStrtolowerWithSpecialCharacters();
38

PHPのstrtolower関数は、指定された文字列に含まれる英大文字をすべて小文字に変換して返す関数です。この関数はstring $stringという一つの文字列を引数として受け取り、小文字に変換されたstringを戻り値として返します。

このサンプルコードは、strtolower関数が特にマルチバイト文字（日本語や全角英数字など）をどのように扱うかを示しています。最初の例では、「HELLO World」のような標準的なASCII文字を含む文字列を変換しており、期待通り「hello world」とすべて小文字に変換されることがわかります。

しかし、二番目の例で日本語などのマルチバイト文字を含む文字列を変換すると、「PHP の特殊文字 (テスト)」の部分は変わらず、「MultiByte STRING」のようなASCII文字の部分のみが小文字に変換されます。これは、strtolower関数がASCII文字セットに限定されており、マルチバイト文字には作用しないためです。同様に、三番目の例にある「ＡＢＣＤＥＦＧＨＩＪＫＬＭＮＯＰＱＲＳＴＵＶＷＸＹＺ」のような全角英数字も、マルチバイト文字として扱われるため変換されません。

したがって、日本語や全角英数字といったマルチバイト文字を含む文字列を小文字に変換したい場合は、strtolower関数ではなく、mb_strtolower関数を使用する必要があります。mb_strtolower関数は、マルチバイト文字の変換に特化しており、適切なエンコーディングを指定することで正確に小文字変換を行えます。