【PHP8.x】DOMCdataSection::__construct()メソッドの使い方

Copy
1<?php
2
3class MyCDataSection extends DOMCdataSection {
4    /**
5     * MyCDataSection constructor.
6     *
7     * @param string $data The data for the CDATA section.
8     */
9    public function __construct(string $data = "") {
10        parent::__construct($data);
11    }
12}
13
14// Example usage:
15$doc = new DOMDocument();
16$cdata = new MyCDataSection("This is my CDATA section content.");
17$doc->appendChild($cdata);
18
19echo $doc->saveXML();
20
21?>

PHPのDOMCdataSectionクラスの__constructメソッドは、CDATAセクションノードを新しく作成する際に呼び出されるコンストラクタです。このメソッドは、オブジェクトの初期化処理を担います。

引数として$dataを受け取ります。$dataは文字列型で、CDATAセクションに含めるテキストデータを指定します。もし$dataに何も指定しない場合は、空のCDATAセクションが作成されます。

上記のサンプルコードでは、DOMCdataSectionクラスを継承したMyCDataSectionクラスを定義し、そのコンストラクタ内で親クラス（DOMCdataSection）のコンストラクタをparent::__construct($data)で呼び出しています。これにより、CDATAセクションの基本的な初期化処理が実行されます。

その後、DOMDocumentオブジェクトを作成し、MyCDataSectionオブジェクトを生成して、CDATAセクションに"This is my CDATA section content."というテキストデータを設定しています。最後に、$doc->saveXML()を呼び出すことで、XMLドキュメントを文字列として出力しています。出力結果には、CDATAセクションが<![CDATA[This is my CDATA section content.]]>のようにXML形式で含まれます。

このコンストラクタは戻り値を持ちません。__constructメソッドは、オブジェクトの初期化のみを行い、処理結果を返す必要がないためです。

Copy
1<?php
2
3/**
4 * PHP 8の「コンストラクタプロパティ昇格」の例を示すクラスです。
5 * DOMCdataSection がコンストラクタで文字列データを受け取る仕様を参考にしています。
6 */
7class MyDataSection
8{
9    // コンストラクタの引数にアクセス修飾子 `public` を付けることで、
10    // プロパティの宣言と、引数からプロパティへの値の代入を同時に行います。
11    // これが「コンストラクタプロパティ昇格 (Constructor Property Promotion)」です。
12    public function __construct(
13        public string $data
14    ) {
15        // プロパティ昇格を使用しているため、コンストラクタの中身は空で構いません。
16        // 従来必要だった `$this->data = $data;` という記述が不要になります。
17    }
18}
19
20// 'Hello from PHP 8!' という文字列データを持つインスタンスを生成します。
21$section = new MyDataSection('Hello from PHP 8!');
22
23// 昇格によって自動的に作成された public プロパティ `data` にアクセスし、値を出力します。
24echo $section->data; // 出力: Hello from PHP 8!
25

このコードは、PHP 8で導入された「コンストラクタプロパティ昇格」という新機能の具体例を示しています。DOMCdataSectionがコンストラクタで文字列データを受け取るように、MyDataSectionクラスも初期値として文字列データを受け取るように設計されています。

クラス内の__constructメソッドは、インスタンスが作成される際に自動的に実行される特別なメソッド（コンストラクタ）です。ここで注目すべきは、引数public string $dataの宣言方法です。PHP 8の新機能「コンストラクタプロパティ昇格」では、コンストラクタの引数にpublic（またはprotected, private）などのアクセス修飾子を付けることで、クラス内に同名のプロパティを自動的に宣言し、同時にそのプロパティへ引数の値を代入する処理を一度に行います。これにより、従来必要だったプロパティの事前宣言や、コンストラクタ内部での$this->data = $data;といった記述が不要となり、コードがより簡潔になります。

引数$dataは、インスタンスに持たせたい文字列データを受け取る役割を担います。コンストラクタはインスタンスの初期化が主な目的であるため、通常は値を返しません。

サンプルコードでは、new MyDataSection('Hello from PHP 8!')としてインスタンスを生成し、引数で渡した文字列が、昇格によって自動的に作成されたpublicプロパティdataに格納されます。その後、echo $section->data;のように、このdataプロパティに直接アクセスして、格納された値を出力しています。