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

Copy
1<?php
2
3// DOMDocument をロードする際にエラーが発生した場合、DOMException がスローされることがあります。
4// その DOMException オブジェクトの line プロパティは、エラーが発生した行番号を示します。
5
6try {
7    $dom = new DOMDocument();
8    $dom->loadXML('<invalid-xml>'); // 無効な XML をロードしてエラーを発生させる
9} catch (DOMException $e) {
10    // DOMException が発生した場合、エラーが発生した行番号を取得します。
11    $lineNumber = $e->line;
12
13    // エラーが発生した行番号を出力します。
14    echo "XML のパース中にエラーが発生しました。エラーが発生した行: " . $lineNumber . PHP_EOL;
15}
16
17?>

PHPのDOMExceptionクラスのlineプロパティは、XMLドキュメントのパース中にエラーが発生した場合に、エラーが発生した行番号を示す整数値を返します。このプロパティは、例外オブジェクトが持つ情報の一つとして提供され、エラーの原因を特定するのに役立ちます。

サンプルコードでは、まずDOMDocumentオブジェクトを作成し、loadXMLメソッドを使用して無効なXMLデータを読み込もうとしています。これにより、DOMExceptionがスローされる可能性が生じます。

try-catchブロックを使用することで、DOMExceptionが発生した場合にそれを捕捉し、例外オブジェクト $e から line プロパティにアクセスしてエラーが発生した行番号を取得できます。取得した行番号は、$e->lineのように記述することで参照できます。

最後に、取得した行番号をecho文で出力しています。PHP_EOLは改行コードを表し、出力結果を見やすくするために使用しています。このように、lineプロパティを利用することで、XMLのパースエラーが発生した箇所を特定し、デバッグ作業を効率的に行うことができます。lineプロパティには引数はなく、整数型の行番号が戻り値として返されます。

Copy
1<?php
2
3// DOMException オブジェクトの line プロパティのサンプル
4
5try {
6    $dom = new DOMDocument();
7    $dom->loadXML('<invalid><tag>'); // 無効なXMLをロードしてエラーを発生させる
8} catch (DOMException $e) {
9    // DOMException が発生した場合、line プロパティを取得して出力する
10    echo "エラーが発生した行番号: " . $e->line . PHP_EOL;
11}
12
13// PHP_EOL は改行コードを挿入します。echo で改行するには、PHP_EOL または "\n" を使用します。
14echo "この行は改行されます。" . PHP_EOL;
15echo "この行も改行されます。\n";
16
17?>

このサンプルコードは、PHPのDOMExceptionクラスのlineプロパティの使い方を示しています。DOMExceptionは、XMLドキュメントの処理中にエラーが発生した場合にスローされる例外です。lineプロパティは、そのエラーが発生したXMLドキュメント内の行番号を整数値で返します。

サンプルでは、まずDOMDocumentオブジェクトを作成し、無効なXMLをロードしようとすることで、意図的にDOMExceptionを発生させています。try-catchブロックを使用し、DOMExceptionがキャッチされた場合に、その例外オブジェクトのlineプロパティの値を取得し、echo文で出力しています。

$e->lineでエラーが発生した行番号を取得できます。lineプロパティは引数を取りません。

また、サンプルコードには、echo文で改行を行う方法も含まれています。PHPで改行を行うには、PHP_EOL定数または\nエスケープシーケンスを使用します。PHP_EOLは、プラットフォームに依存しない改行コードを提供し、\nはUnix系の改行コードです。サンプルでは、それぞれの方法で文字列の最後に追加することで、出力結果が改行されることを示しています。初心者の方がつまづきやすいポイントなので、ぜひ覚えておきましょう。