【PHP8.x】Dom\AdjacentPosition::AfterEnd定数の使い方

Copy
1<?php
2
3/**
4 * Dom\AdjacentPosition::AfterEnd 定数を使用して、
5 * 既存のDOM要素の終了タグの直後に新しい要素を挿入する例。
6 *
7 * この定数は、DOM操作において要素をどこに配置するかを指定します。
8 * AfterEnd は、基準となる要素の終了タグのすぐ後を意味します。
9 */
10function demonstrateDomAfterEndPosition(): void
11{
12    // 1. 新しいDOMドキュメントを作成
13    $dom = new DOMDocument('1.0', 'UTF-8');
14    $dom->formatOutput = true; // 出力時に整形を有効にする
15
16    // 2. 基本となるHTML構造を構築
17    $container = $dom->createElement('div');
18    $container->setAttribute('id', 'main-container');
19    $dom->appendChild($container);
20
21    $paragraph = $dom->createElement('p', 'これは元の段落です。');
22    $paragraph->setAttribute('id', 'target-paragraph');
23    $container->appendChild($paragraph);
24
25    echo "--- 挿入前のHTML構造 ---" . PHP_EOL;
26    echo $dom->saveHTML() . PHP_EOL;
27
28    // 3. 挿入の基準となる要素を取得
29    // getElementById() を使用して、特定のIDを持つ要素を検索します。
30    $targetElement = $dom->getElementById('target-paragraph');
31
32    // 4. 新しく挿入する要素を作成
33    $newElement = $dom->createElement('span', 'この要素は段落の後に挿入されました！');
34    $newElement->setAttribute('style', 'color: blue; font-weight: bold;');
35
36    // 5. Dom\AdjacentPosition::AfterEnd を使用して要素を挿入
37    // insertAdjacentElement() メソッドは、指定された位置に新しい要素を挿入します。
38    // Dom\AdjacentPosition::AfterEnd は、対象要素の終了タグの直後を指します。
39    if ($targetElement) {
40        $targetElement->insertAdjacentElement(Dom\AdjacentPosition::AfterEnd, $newElement);
41
42        echo PHP_EOL . "--- 挿入後のHTML構造 (AfterEnd) ---" . PHP_EOL;
43        echo $dom->saveHTML() . PHP_EOL;
44    } else {
45        echo PHP_EOL . "エラー: ターゲットとなる要素が見つかりませんでした。" . PHP_EOL;
46    }
47}
48
49// 関数を実行し、動作を確認
50demonstrateDomAfterEndPosition();
51
52?>

PHP 8におけるDom\AdjacentPosition::AfterEnd定数は、DOM（Document Object Model）操作において、HTMLなどの要素をどこに挿入するかを指定するためのものです。この定数自体は引数を持たず、整数型の値を返します。その役割は、基準となる要素の「終了タグの直後」に新しい要素を配置する位置を示すことです。

サンプルコードでは、まずDOMDocumentクラスを使って新しいHTMLドキュメントを作成し、基本的なdiv要素とp要素を持つ初期状態を構築しています。このp要素（id="target-paragraph"）が、新しい要素を挿入する際の基準となります。

次に、getElementById()メソッドでこの基準となるp要素を取得します。その後、挿入したい新しいspan要素を作成します。このspan要素を、targetElement（基準となるp要素）の特定の場所に挿入するために、insertAdjacentElement()メソッドが使用されます。

insertAdjacentElement()メソッドの第一引数にDom\AdjacentPosition::AfterEndを指定することで、基準となるp要素の終了タグ</p>の直後に、作成したspan要素が挿入されます。その結果、元のp要素の内容はそのままに、その外側、かつ直後に新しいspan要素が追加されたHTML構造が生成されます。このように、この定数を利用することで、既存の要素に隣接して新しいコンテンツを柔軟に配置できるのです。

Copy
1<?php
2
3/**
4 * データベース操作で影響を受けた行数を取得し、結果を表示する関数です。
5 *
6 * この関数は、キーワードである「affected_rows」に焦点を当て、
7 * データベースの更新操作で何行が影響を受けたかを示す方法を実演します。
8 * また、PHP 8で導入された定数 Dom\AdjacentPosition::AfterEnd の値が
9 * 整数であることも示します（この定数自体はデータベース操作とは直接関係ありません）。
10 */
11function demonstrateAffectedRowsAndDomConstant(): void
12{
13    // データベース接続情報 (ご自身の環境に合わせて変更してください)
14    // 実際には、設定ファイルなどから読み込むことが推奨されます。
15    $dbHost = 'localhost';
16    $dbUser = 'root';
17    $dbPass = ''; // セキュリティのため、空のパスワードは避けるべきです
18    $dbName = 'test_db'; // 適切なデータベース名を指定してください
19
20    // MySQLiを使用してデータベースに接続します
21    $mysqli = new mysqli($dbHost, $dbUser, $dbPass, $dbName);
22
23    // 接続エラーのチェック
24    if ($mysqli->connect_errno) {
25        echo "データベース接続エラー: " . $mysqli->connect_error . PHP_EOL;
26        return; // エラーが発生した場合は処理を終了します
27    }
28
29    echo "データベースに接続しました。" . PHP_EOL;
30
31    // サンプルテーブルとデータの準備
32    // この部分は、初回実行時やテスト目的でテーブルが存在しない場合に実行されます。
33    // 既存のテーブルを操作したくない場合は、これらの行をコメントアウトしてください。
34    $mysqli->query("DROP TABLE IF EXISTS `users`"); // 既存のテーブルがあれば削除
35    $mysqli->query("CREATE TABLE `users` (
36        `id` INT AUTO_INCREMENT PRIMARY KEY,
37        `name` VARCHAR(50) NOT NULL,
38        `status` VARCHAR(20) NOT NULL
39    )");
40    $mysqli->query("INSERT INTO `users` (`name`, `status`) VALUES ('Alice', 'active')");
41    $mysqli->query("INSERT INTO `users` (`name`, `status`) VALUES ('Bob', 'inactive')");
42    $mysqli->query("INSERT INTO `users` (`name`, `status`) VALUES ('Charlie', 'active')");
43    $mysqli->query("INSERT INTO `users` (`name`, `status`) VALUES ('David', 'inactive')");
44    echo "サンプルテーブル 'users' とデータを準備しました。" . PHP_EOL;
45
46    // UPDATEクエリを実行し、複数の行を更新します。
47    // 'inactive' ステータスのユーザーを 'pending' に変更します。
48    $updateQuery = "UPDATE `users` SET `status` = 'pending' WHERE `status` = 'inactive'";
49    $mysqli->query($updateQuery);
50
51    // mysqli_affected_rows() を使用して、直前のクエリで影響を受けた行数を取得します。
52    $affectedRows = $mysqli->affected_rows;
53
54    echo "----------------------------------------" . PHP_EOL;
55    echo "実行したクエリ: \"$updateQuery\"" . PHP_EOL;
56    echo "影響を受けた行数 (affected_rows): " . $affectedRows . PHP_EOL;
57    echo "----------------------------------------" . PHP_EOL;
58
59    // Dom\AdjacentPosition::AfterEnd 定数の値と型を表示します。
60    // この定数はDOM (Document Object Model) 操作における要素の挿入位置を指定するもので、
61    // データベースのaffected_rowsとは直接関係ありません。
62    // しかし、PHP 8で導入された整数の定数であるというリファレンス情報に基づき表示します。
63    echo "Dom\\AdjacentPosition::AfterEnd の値: " . \Dom\AdjacentPosition::AfterEnd . PHP_EOL;
64    echo "Dom\\AdjacentPosition::AfterEnd の型: " . gettype(\Dom\AdjacentPosition::AfterEnd) . PHP_EOL;
65
66    // データベース接続を閉じます
67    $mysqli->close();
68    echo "データベース接続を閉じました。" . PHP_EOL;
69}
70
71// 関数を実行します
72demonstrateAffectedRowsAndDomConstant();
73

このPHPサンプルコードは、データベース操作において「affected_rows」がどのように利用されるかを示しています。まず、MySQLi拡張機能を使ってデータベースに接続し、サンプルとなるユーザーテーブルとデータを準備します。その後、UPDATEクエリを実行して、特定の条件を満たす複数の行を更新します。この更新操作の直後に $mysqli->affected_rows プロパティを参照することで、直前のクエリで実際に変更が加えられた行数を整数値として取得し、その結果を表示しています。このプロパティは、INSERT、UPDATE、DELETEといった変更クエリが何行に影響を与えたかを把握するために役立ちます。

また、本コードではPHP 8で導入された定数 Dom\AdjacentPosition::AfterEnd の値も表示しています。この定数は、HTMLやXML文書の構造を操作するDOM (Document Object Model) 関連の機能で、特定の要素の終了タグの直後という挿入位置を示すものです。この定数は引数を取らず、常に整数を返す特性を持っています。データベース操作とは直接関係ありませんが、PHP 8で利用できる整数の定数の一例として、その値とデータ型が示されています。コードの最後では、開かれたデータベース接続を適切に閉じます。