【PHP8.x】stringプロパティの使い方

Copy
1<?php
2
3/**
4 * PHPにおける文字列と整数の基本的な変換方法を示すサンプルコード。
5 * システムエンジニアを目指す初心者向けに、string型とint型の相互変換を解説します。
6 */
7function demonstrateStringIntConversion(): void
8{
9    echo "--- 文字列から整数への変換 ---\n";
10
11    // 1. 完全に数値の文字列を整数に変換
12    $stringNumber = "12345";
13    echo "元の文字列: '" . $stringNumber . "' (型: " . gettype($stringNumber) . ")\n";
14
15    // (int) キャストによる変換: 最も一般的で簡潔な方法
16    $intByCast = (int)$stringNumber;
17    echo "  (int) キャストで変換: " . $intByCast . " (型: " . gettype($intByCast) . ")\n";
18
19    // intval() 関数による変換: 特定の基数での変換も可能だが、基本は同じ
20    $intByIntval = intval($stringNumber);
21    echo "  intval() 関数で変換: " . $intByIntval . " (型: " . gettype($intByIntval) . ")\n\n";
22
23    // 2. 小数を含む文字列を整数に変換（小数点以下は切り捨てられる）
24    $stringFloat = "123.789";
25    echo "元の文字列 (小数): '" . $stringFloat . "' (型: " . gettype($stringFloat) . ")\n";
26    $intFromFloatString = (int)$stringFloat;
27    echo "  (int) キャストで変換: " . $intFromFloatString . " (型: " . gettype($intFromFloatString) . ")\n\n";
28
29    // 3. 数値以外の文字を含む文字列を整数に変換（先頭の数値部分のみが変換される）
30    $stringMixed = "456abc";
31    echo "元の文字列 (混合): '" . $stringMixed . "' (型: " . gettype($stringMixed) . ")\n";
32    $intFromMixedString = (int)$stringMixed;
33    echo "  (int) キャストで変換: " . $intFromMixedString . " (型: " . gettype($intFromMixedString) . ")\n\n";
34    
35    // 4. 数値で始まらない文字列や空文字列を整数に変換（0 になる）
36    $stringNonNumeric = "hello";
37    echo "元の文字列 (非数値): '" . $stringNonNumeric . "' (型: " . gettype($stringNonNumeric) . ")\n";
38    $intFromNonNumericString = (int)$stringNonNumeric;
39    echo "  (int) キャストで変換: " . $intFromNonNumericString . " (型: " . gettype($intFromNonNumericString) . ")\n";
40
41    $stringEmpty = "";
42    echo "元の文字列 (空): '" . $stringEmpty . "' (型: " . gettype($stringEmpty) . ")\n";
43    $intFromEmptyString = (int)$stringEmpty;
44    echo "  (int) キャストで変換: " . $intFromEmptyString . " (型: " . gettype($intFromEmptyString) . ")\n\n";
45
46
47    echo "--- 整数から文字列への変換 ---\n";
48
49    // 1. 正の整数を文字列に変換
50    $integer = 789;
51    echo "元の整数: " . $integer . " (型: " . gettype($integer) . ")\n";
52
53    // (string) キャストによる変換: 最も一般的で簡潔な方法
54    $stringByCast = (string)$integer;
55    echo "  (string) キャストで変換: '" . $stringByCast . "' (型: " . gettype($stringByCast) . ")\n";
56
57    // strval() 関数による変換
58    $stringByStrval = strval($integer);
59    echo "  strval() 関数で変換: '" . $stringByStrval . "' (型: " . gettype($stringByStrval) . ")\n\n";
60
61    // 2. 負の整数を文字列に変換
62    $negativeInteger = -100;
63    echo "元の整数 (負の数): " . $negativeInteger . " (型: " . gettype($negativeInteger) . ")\n";
64    $stringFromNegativeInt = (string)$negativeInteger;
65    echo "  (string) キャストで変換: '" . $stringFromNegativeInt . "' (型: " . gettype($stringFromNegativeInt) . ")\n";
66}
67
68// 関数を実行して、変換の動作を確認
69demonstrateStringIntConversion();

このサンプルコードは、PHPにおける文字列（string）型と整数（int）型の基本的な相互変換方法を、システムエンジニアを目指す初心者の方に向けて解説します。

文字列から整数への変換では、主に(int)キャストまたはintval()関数を使用します。例えば"12345"のような完全に数値の文字列は、(int)"12345"やintval("12345")と記述することで整数12345に変換されます。"123.789"のように小数を含む文字列を整数に変換する場合、(int)キャストでは小数点以下が切り捨てられ123となります。"456abc"のように先頭に数値がある文字列では、(int)キャストにより先頭の数値部分のみが抽出され456に変換されます。"hello"のような数値で始まらない文字列や、空の文字列""を整数に変換しようとすると、結果は0となります。これらの変換操作は、引数として変換したい文字列を取り、変換後の整数値を戻り値として返します。

反対に、整数から文字列への変換は、主に(string)キャストまたはstrval()関数を用いて行われます。例えば整数789は、(string)789やstrval(789)と記述することで文字列"789"に変換されます。負の整数-100も同様に文字列"-100"として変換されます。これらの変換は、引数として整数を取り、その文字列表現を戻り値として提供します。これらの相互変換は、ユーザーからの入力値の処理やデータベース連携など、PHPでのプログラム開発において非常に頻繁に利用される基本的な操作です。

Copy
1<?php
2
3/**
4 * PHPのErrorクラスの扱いと文字列変換の例
5 *
6 * このコードは、PHPのErrorを意図的に発生させ、それを捕捉し、
7 * Errorオブジェクトから得られる文字列情報を取得して変換する基本的な方法を示します。
8 * Errorオブジェクトは、エラーの詳細な情報を文字列として表現できます。
9 */
10try {
11    // 存在しないクラスをインスタンス化しようとすることで、TypeError (Errorの子クラス) を発生させます。
12    // PHP 8では、未定義のクラスをnewしようとするとTypeErrorがスローされます。
13    new NonExistentClass();
14
15} catch (Error $e) {
16    // Errorオブジェクトをキャッチします。
17    echo "--- エラー発生 ---\n\n";
18
19    // 1. Errorオブジェクトを直接文字列に変換して出力する例
20    // Errorオブジェクトは__toString()マジックメソッドを持つため、文字列型として扱われると、
21    // エラーの種類、メッセージ、ファイル、行番号を含む詳細な情報が自動的に文字列として生成されます。
22    $errorDetailsString = (string) $e;
23    echo "Errorオブジェクトを文字列に変換 (__toString()経由):\n";
24    echo $errorDetailsString . "\n\n";
25
26    // 2. 変換されたエラー詳細文字列に対して、さらにPHPの文字列関数を使って変換を行う例
27    // 例えば、取得したエラーの詳細全体を大文字に変換してみます。
28    $upperCaseErrorString = strtoupper($errorDetailsString);
29    echo "変換されたエラー文字列をさらに大文字に変換:\n";
30    echo $upperCaseErrorString . "\n\n";
31
32    // 3. ErrorオブジェクトのgetMessage()メソッドでエラーメッセージ部分のみを取得し、それを変換する例
33    // Errorオブジェクトの`message`プロパティ（string型）からメッセージを取得し、操作します。
34    $originalMessage = $e->getMessage();
35    echo "Errorオブジェクトから取得した元のエラーメッセージ:\n";
36    echo $originalMessage . "\n\n";
37
38    // エラーメッセージの一部を切り出す（変換する）
39    $truncatedMessage = substr($originalMessage, 0, 25) . '...';
40    echo "エラーメッセージの一部を切り出し変換 (最初の25文字):\n";
41    echo $truncatedMessage . "\n";
42}
43
44?>

PHPのErrorクラスは、プログラム実行中に発生した問題（エラー）の詳細情報を持つオブジェクトです。このオブジェクトは、エラーの種類、メッセージ、発生したファイル名や行番号など、多くの情報を含んでいます。

サンプルコードでは、意図的にエラーを発生させ、それをcatchブロックでErrorオブジェクトとして捕捉しています。捕捉したErrorオブジェクトは、内部的に詳細なエラー情報を文字列として保持する能力を持っています。具体的には、Errorオブジェクトを直接(string)でキャストしたり、echo文で出力したりすると、オブジェクトが持つエラー情報全体が自動的に一つの文字列として生成されます。この文字列への変換には、特別な引数を指定する必要はありません。

このようにして得られたエラーの詳細文字列は、PHPの標準的な文字列操作関数（例：strtoupper()で全て大文字にする、substr()で文字列の一部を切り出すなど）を使って、システムエンジニアの必要に応じてさらに加工（変換）することができます。また、ErrorオブジェクトのgetMessage()メソッドを使用すると、エラーメッセージ部分のみを個別に取得し、それを同様に文字列操作で変換することも可能です。

Errorオブジェクトを文字列に変換する際には、特定のメソッドから文字列が「戻り値」として返されるというよりも、オブジェクト自体が文字列としての表現を持つ、と考えると良いでしょう。これにより、エラー発生時の情報収集やログ出力、ユーザーへの通知など、様々な場面で柔軟な対応が可能となります。