Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【PHP8.x】PHP_EXTRA_VERSION定数の使い方

PHP_EXTRA_VERSION定数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

PHP_EXTRA_VERSION定数は、PHPのバージョン情報の一部として、追加のリリースタイプ情報を表す定数です。この定数は、PHPの主要なバージョン番号(例: 8.0.0)を示すPHP_VERSION定数では表現されない、より詳細なリリースに関する状態を文字列で保持します。具体的には、PHPが開発版である場合は「-DEV」、リリース候補版である場合は「-RC1」や「-RC2」といった形式の値が設定されます。一方、正式にリリースされた安定版のPHPにおいては、PHP_EXTRA_VERSION定数の値は通常、空文字列("")となります。

システムエンジニアを目指す方にとって、この定数は、現在利用しているPHP環境が、開発中のベータ版やリリース候補版なのか、あるいは安定した本番環境向けの正式リリース版なのかをプログラムから判別する際に役立ちます。例えば、開発版でのみ利用可能な特定の機能をテストする場合や、本番環境では実行したくないデバッグ用の処理を条件分岐で制御する際に活用できます。これにより、異なる環境での動作を柔軟に制御し、ソフトウェア開発の信頼性と効率性を向上させることが可能です。

構文(syntax)

1echo PHP_EXTRA_VERSION;

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

PHP_EXTRA_VERSION は、PHP の追加バージョン情報を示す文字列を返します。これは、PHP が標準リリース以外に追加のパッチや機能でビルドされた場合にのみ設定されます。

サンプルコード

PHPバージョン詳細を取得する

1<?php
2
3/**
4 * PHPのバージョン詳細情報を表示する関数。
5 * システムエンジニアを目指す初心者向けに、PHPのバージョン関連定数や関数の使い方を示します。
6 */
7function displayPhpVersionDetails(): void
8{
9    // PHP_VERSION 定数は、PHPの主要なバージョン番号 (例: "8.2.10") を提供します。
10    echo "PHP_VERSION (定数): " . PHP_VERSION . PHP_EOL;
11
12    // PHP_EXTRA_VERSION 定数は、追加のバージョン情報 (例: "-dev", "-RC") を提供します。
13    // 正式リリース版では通常空文字列です。
14    echo "PHP_EXTRA_VERSION (定数): " . PHP_EXTRA_VERSION . PHP_EOL;
15
16    // phpversion() 関数は、現在実行されているPHPのバージョン文字列全体を返します。
17    // PHP_VERSION と PHP_EXTRA_VERSION の組み合わせに近い値となることが多いです。
18    echo "phpversion() (関数): " . phpversion() . PHP_EOL;
19
20    // PHP_VERSION と PHP_EXTRA_VERSION を組み合わせることで、より詳細なバージョン文字列を構成できます。
21    echo "PHP_VERSION と PHP_EXTRA_VERSION の結合: " . PHP_VERSION . PHP_EXTRA_VERSION . PHP_EOL;
22}
23
24// 関数を実行して結果を表示します。
25displayPhpVersionDetails();

このサンプルコードは、PHPのバージョン情報を取得し表示する方法を、システムエンジニアを目指す初心者向けに解説しています。PHPには、実行中のバージョン情報を知るための定数と関数が用意されています。

まず、「PHP_VERSION」定数は、PHPの主要なバージョン番号を文字列で提供します。例えば「8.2.10」といった形式の値です。次に、リファレンス情報にもある「PHP_EXTRA_VERSION」定数は、追加のバージョン情報を提供します。これは、開発版(-dev)やリリース候補版(-RC)のような、PHPのリリース状態に関する補足情報を示す文字列であり、正式リリース版では通常、空文字列となります。この定数は引数を取らず、戻り値として文字列を返します。

さらに、「phpversion()」関数は、現在実行されているPHPのバージョン文字列全体を返します。この関数も引数を取らず、戻り値として文字列を返します。「PHP_VERSION」と「PHP_EXTRA_VERSION」を組み合わせた値と近いものになることが多いです。サンプルコードでは、これらの定数や関数を使って取得したバージョン情報をそれぞれ出力し、また「PHP_VERSION」と「PHP_EXTRA_VERSION」を結合してより詳細なバージョン文字列を構成する例も示しています。これにより、PHPのバージョンに関するさまざまな情報を確認できます。

PHP_EXTRA_VERSIONはPHPの追加バージョン情報を示す定数ですが、特に注意すべきは、正式リリース版のPHPではほとんどの場合、値が空文字列である点です。開発版やリリース候補版などの特別なビルドでのみ、「-dev」や「-RC」といった具体的な情報が含まれます。そのため、常にこの定数に値が入っていることを前提としたプログラムは、期待通りに動作しない可能性がありますのでご注意ください。

PHPのバージョン全体を確認したい場合は、PHP_VERSION定数とPHP_EXTRA_VERSION定数を組み合わせることもできますが、より簡潔に完全なバージョン文字列を取得できるphpversion()関数の利用が推奨されます。これらのバージョン情報は、PHPの実行環境によって異なる処理を分岐させたり、特定の機能が利用可能かを確認したりする際に重要な判断材料となります。

PHPバージョンと追加情報表示

1<?php
2
3/**
4 * PHPのバージョン情報と、ビルドに関する追加情報を表示します。
5 * システムエンジニアを目指す初心者向けに、PHPの組み込み関数と定数の使い方を示します。
6 */
7function displayPhpVersionDetails(): void
8{
9    // phpversion() 関数は、PHPの完全なバージョン文字列を返します。
10    // これは通常、PHP_VERSIONとPHP_EXTRA_VERSIONの情報を組み合わせたものです。
11    echo "PHP Version (from phpversion() function): " . phpversion() . PHP_EOL;
12
13    // PHP_VERSION 定数は、PHPの主要なバージョン番号を返します。
14    // 例: "8.3.6"
15    echo "PHP Version (from PHP_VERSION constant): " . PHP_VERSION . PHP_EOL;
16
17    // PHP_EXTRA_VERSION 定数は、PHPのビルドに関する追加情報を返します。
18    // これは開発版やカスタムビルドの場合に、より詳細な情報が含まれることがあります。
19    // 公式リリース版などでは空文字列の場合もあります。
20    echo "PHP Extra Version (from PHP_EXTRA_VERSION constant): " . PHP_EXTRA_VERSION . PHP_EOL;
21}
22
23// 上記の関数を呼び出し、PHPのバージョン情報を表示します。
24displayPhpVersionDetails();
25
26?>

このコードは、PHPのバージョン情報と、そのビルドに関する追加情報を表示する方法を示しています。echoを使って画面に出力しています。

phpversion()関数は、現在動作しているPHPの完全なバージョン文字列を返します。この関数に引数はなく、結果は文字列として得られます。

PHP_VERSION定数は、PHPの主要なバージョン番号(例: "8.3.6")を直接示します。これも引数はなく、文字列型の値を持つ定数です。

今回のテーマであるPHP_EXTRA_VERSION定数は、PHPのビルドに関する追加情報を提供します。この定数も引数を持たず、戻り値は文字列(string)です。開発版やカスタムビルドの場合に詳細情報が含まれることがありますが、公式リリース版などでは空文字列になることもあります。

これらの関数や定数を活用することで、現在実行中のPHP環境の具体的なバージョン情報を正確に把握することができます。

PHP_EXTRA_VERSION定数は、PHPのビルドに関する追加情報を提供しますが、公式リリース版のPHPでは多くの場合、情報が含まれず空文字列となる点に注意してください。常に何らかの値が表示されるわけではありません。PHPの完全なバージョン文字列を手軽に確認したい場合は、PHP_VERSIONとPHP_EXTRA_VERSIONの情報を組み合わせた結果を返すphpversion()関数を利用するのが最も確実です。これらの定数や関数は、ご自身のアプリケーションが特定のPHPバージョンやビルド環境に依存するかどうかを確認する際や、デバッグ時に環境情報を把握する上で重要な役割を果たします。

関連コンテンツ

関連プログラミング言語