PHP 8.3 が 2024 年 11 月に正式リリースになります。PHP 8.3 の新しい機能を試してみましょう。

PHP 8.3 の新機能を試してみよう

PHP 8.3 が 2024 年 11 月にリリースになります。PHP 8.3 の新しい機能をいくつかピックアップして試してみます。
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E3%82%AF%E3%83%A9%E3%82%B9%E5%AE%9A%E6%95%B0%E3%81%AE%E5%9E%8B%E6%8C%87%E5%AE%9A">クラス定数の型指定</a></li>
<li><a href="#%E3%82%AF%E3%83%A9%E3%82%B9%E5%AE%9A%E6%95%B0%E3%81%AE%E5%8B%95%E7%9A%84%E5%8F%82%E7%85%A7">クラス定数の動的参照</a></li>
<li><a href="#override-attribute-%E3%81%AB%E3%82%88%E3%82%8B%E3%82%AA%E3%83%BC%E3%83%90%E3%83%BC%E3%83%A9%E3%82%A4%E3%83%89%E6%8C%87%E5%AE%9A">Override attribute によるオーバーライド指定</a></li>
<li><a href="#ini-%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E7%92%B0%E5%A2%83%E5%A4%89%E6%95%B0%E8%A8%AD%E5%AE%9A%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E3%83%87%E3%83%95%E3%82%A9%E3%83%AB%E3%83%88%E5%80%A4%E8%A8%AD%E5%AE%9A">INI ファイル環境変数設定におけるデフォルト値設定</a></li>
<li><a href="#json_validate-%E9%96%A2%E6%95%B0">json_validate() 関数</a></li>
</ol>
<h2 id="クラス定数の型指定">クラス定数の型指定</h2>
クラスで定義する定数に型の指定が行えるようになりました。
Typed class constants 
<a href="https://wiki.php.net/rfc/typed_class_constants" rel="noopener noreferrer" target="_blank">https://wiki.php.net/rfc/typed_class_constants</a>
<pre><code class="hljs language-php">class Person {
 const string NAME = 'rito';
}
</code></pre>
指定した型ではない値を代入するとエラーになります。
<pre><code class="hljs language-php">class Person {
 const string NAME = 777;
}

// Fatal error: Cannot use int as value for class constant Person::NAME of type string in...
</code></pre>
<h2 id="クラス定数の動的参照">クラス定数の動的参照</h2>
Dynamic class constant fetch 
<a href="https://wiki.php.net/rfc/dynamic_class_constant_fetch" rel="noopener noreferrer" target="_blank">https://wiki.php.net/rfc/dynamic_class_constant_fetch</a>
クラスで定義した定数を、変数で動的に参照できるようになりました。
<pre><code class="hljs language-php">class Person {
 const string NAME = 'rito';
}

$personNameConstant = 'NAME';

echo Person::{$personNameConstant};
// => rito
</code></pre>
PHP 8.2 までは <code>constant()</code> 関数を使わないと同様のことはできませんでした。
<pre><code class="hljs language-php">echo constant("Person::$personNameConstant");
// => rito
</code></pre>
8.3 でも <code>constant()</code> 関数は引き続き使えます。
<h2 id="override-attribute-によるオーバーライド指定">Override attribute によるオーバーライド指定</h2>
Marking overridden methods (#[Override]) 
<a href="https://wiki.php.net/rfc/marking_overriden_methods" rel="noopener noreferrer" target="_blank">https://wiki.php.net/rfc/marking_overriden_methods</a>
PHP は、実装されたメソッドのシグネチャが指定されたインターフェイスまたは親クラスからオーバーライドされたメソッドと互換性があることを検証しますが、メソッドが実際にインターフェイスのメソッドを実装することを目的としているのか、親メソッドをオーバーライドすることを目的としているかどうかの「意図」を確認することができません。
例として、以下の基底クラスと派生クラスがあったとします。派生クラス側で、基底クラスのメソッドをオーバーライドしています。
<pre><code class="hljs language-php">class Book {
 protected function setName(string $name): void { /* some processing... */}
}

class PhpReference extends Book {
 // setName() をオーバーライドしている
 public function setName(string $name): void { /* some processing... */}
}
</code></pre>
このとき、基底クラス側のメソッド名が変更されたらどうなるでしょう。
<pre><code class="hljs language-php">class Book {
 // protected function setName(): void { /* some processing... */}
 // ↓ メソッド名を変更した
 protected function setTitle(string $name): void { /* some processing... */}
}

class PhpReference extends Book {
 // setName() をオーバーライドしていたはずが、基底クラス側のメソッド名が変わったために派生クラス独自のメソッドとなってしまった
 public function setName(string $name): void { /* some processing... */}
}
</code></pre>
基底クラス側のメソッド変更によって、派生クラス側のオーバーライドが独自メソッドになってしまいます。つまり、PhpReference クラスは setTitle() 関数も、setName() 関数も動作することになります。
PHP はこういった「意図」の検出ができません。
PHP 8.3 では、Override アトリビュート（#[\Override]） をつけることによって、そのメソッドがオーバーライドであることを示せるようになりました。
これによって、基底クラス側のメソッド名変更があった時にエラーにすることができます。
<pre><code class="hljs language-php">class Book {
 protected function setName(): void { /* some processing... */}
}

class PhpReference extends Book {
 #[\Override]
 public function setName(): void { /* some processing... */}
}
</code></pre>
基底クラス側でメソッドの変更が行われた場合はエラーが発生します。　
<pre><code class="hljs language-php">class Book {
 // protected function setName(): void { /* some processing... */}
 // ↓ メソッド名を変更した
 protected function setTitle(): void { /* some processing... */}
}

class PhpReference extends Book {
 #[\Override]
 public function setName(): void { /* some processing... */}
 // => Fatal error: PhpReference::setName() has #[\Override] attribute, but no matching parent method exists in...
}
</code></pre>
<h2 id="ini-ファイル環境変数設定におけるデフォルト値設定">INI ファイル環境変数設定におけるデフォルト値設定</h2>
php.ini での環境変数設定でデフォルト値が設定可能になりました。
INI ファイル内では環境変数が参照できるため、これと併用することでデフォルト値の運用が可能になります。
まずは PHP 8.2 までの挙動を見てみます。
<pre><code class="hljs language-ini">post_max_size = ${POST_MAX_SIZE}
</code></pre>
<pre><code class="hljs language-php">/*
 * 〜 PHP 8,2
 */ 

// php.ini
// post_max_size = 8M
echo ini_get('post_max_size');
// => 8M

// 環境変数 POST_MAX_SIZE が設定されている
echo ini_get('post_max_size');
// => 10M

// 環境変数 POST_MAX_SIZE が設定されていない
echo ini_get('post_max_size');
// => ''
</code></pre>
PHP 8,2 までは、値が指定されていない場合は未設定となり、値を参照すると空文字が返ります。
PHP 8.3 では、デフォルト値を指定しておけば、環境変数の設定が無い場合もデフォルト値を適用してくれます。
<pre><code class="hljs language-ini">post_max_size = "${POST_MAX_SIZE:-6M}"
</code></pre>
<pre><code class="hljs language-php">/*
 * PHP 8,3 〜　
 */ 

// 環境変数 POST_MAX_SIZE が設定されている
echo ini_get('post_max_size');
// => 10M

// 環境変数 POST_MAX_SIZE が設定されていない
echo ini_get('post_max_size');
// => 6M
</code></pre>
<h2 id="json_validate-関数">json_validate() 関数</h2>
json_validate() 関数が追加されました。
json_validate 
<a href="https://wiki.php.net/rfc/json_validate" rel="noopener noreferrer" target="_blank">https://wiki.php.net/rfc/json_validate</a>
この関数は、文字列が有効な json 文字列であるかどうかを検証します。
これまでは、<a href="https://www.php.net/manual/ja/function.json-decode.php" rel="noopener noreferrer" target="_blank">json_decode() 関数</a> の結果によってハンドリングすることが多かったはずです。
<pre><code class="hljs language-php">$json = '';

try {
 json_decode(json: $json, flags: JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
 /* some processing... */
}
</code></pre>
ただしこの場合、文字列の解析で ZVAL(object, arrayなど) を生成するため、メモリを消費する上、メモリ保存処理分のオーバーヘッドも発生します。
対して PHP 8.3 で追加された json_validate() 関数はこれらの処理を行わないため、リソース節約・速度向上に貢献します。
また、json_validate() 関数で使用する Parser は json_decode() 関数と共通のため、json_validate() が通れば json_decode() も成功する。ということが担保されます。
<pre><code class="hljs language-php">json_validate( string $json, int $Depth = 512, int $flags = 0 ) : bool
</code></pre>
<pre><code class="hljs language-php">$json = '';
json_validate($json);
// => false

$json = '{"a":"aaa","b":"bbb"}';
json_validate($json);
// => true
</code></pre>
<h2 id="まとめ">まとめ</h2>
PHP 8.3では、クラス定数の型指定やオーバーライド指定、そして json_validate() 関数など、うれしいアップデートがありました。
今回取り上げたものは一部です。新機能は他にもあるのでチェックしてみてください。
<a href="https://wiki.php.net/rfc#php_83" rel="noopener noreferrer" target="_blank">https://wiki.php.net/rfc#php_83</a>

Author