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

Copy
1<?php
2
3/**
4 * PHPの内部定数 PHP_BINARY の値と、ウェブ環境で利用される $_SERVER['PHP_SELF'] の値を表示します。
5 *
6 * PHP_BINARY は、現在このスクリプトを実行しているPHPバイナリ（実行ファイル）の絶対パスを示します。
7 * 主にコマンドラインインターフェース（CLI）環境でのスクリプト実行時や、
8 * 別のPHPプロセスを起動する際にそのパスを知りたい場合に有用です。
9 *
10 * $_SERVER['PHP_SELF'] は、ウェブサーバーのドキュメントルートから見た、現在実行中のスクリプトのパスを示します。
11 * 主にウェブアプリケーションで現在のページのURLパスを取得する場合に有用です。
12 * コマンドラインから実行した場合、この値はスクリプトのファイルパスになるか、定義されないことがあります。
13 */
14function displayPhpPathsAndSelf(): void
15{
16    // PHP_BINARY定数を出力
17    // これは、このスクリプトを実行しているPHP実行ファイルへのパスです。
18    // 例: /usr/bin/php や C:\php\php.exe
19    echo "現在のPHPバイナリのパス: " . PHP_BINARY . PHP_EOL;
20
21    // $_SERVER['PHP_SELF'] の値を出力
22    // これは、ウェブサーバーからこのスクリプトにアクセスした際のパスです。
23    // 例: /my_project/public/index.php
24    // コマンドライン (CLI) から実行した場合、この値はスクリプトのファイルパスになるか、または空の場合があります。
25    if (isset($_SERVER['PHP_SELF'])) {
26        echo "ウェブサーバー上でのスクリプトのパス (\$ _SERVER['PHP_SELF']): " . $_SERVER['PHP_SELF'] . PHP_EOL;
27    } else {
28        echo "ウェブサーバー上でのスクリプトのパス (\$ _SERVER['PHP_SELF']): (CLI実行のため定義されていないか、異なる値です)" . PHP_EOL;
29    }
30}
31
32// 関数を実行して、それぞれのパス情報を表示します。
33displayPhpPathsAndSelf();

このサンプルコードは、PHPスクリプトが動作する環境に関する重要なパス情報である、内部定数PHP_BINARYとスーパーグローバル変数$_SERVER['PHP_SELF']の値を表示し、それぞれの役割を説明します。

PHP_BINARYは、現在このスクリプトを実行しているPHPの実行ファイルそのものの絶対パスを示す定数です。引数はなく、文字列（string）としてそのパスを返します。例えば、Linux環境では/usr/bin/php、Windows環境ではC:\php\php.exeのような値が得られます。これは主にコマンドラインインターフェース（CLI）からスクリプトを実行する場合や、PHPスクリプト内で別のPHPプロセスを起動したい場合に、正しいPHPの実行ファイルを指定するために利用されます。

一方、$_SERVER['PHP_SELF']は、ウェブサーバーのドキュメントルートから見た、現在実行中のスクリプトのパスを示すスーパーグローバル変数です。これは、ウェブアプリケーションにおいて、現在のページのURLパスを取得する際によく利用されます。例えば、http://example.com/my_project/index.phpにアクセスした場合、この値は/my_project/index.phpのようになります。$_SERVERはウェブサーバーによって提供される情報であるため、コマンドラインからPHPスクリプトを実行した場合は、この値が定義されないか、スクリプトのファイルパスになるなど、ウェブ環境とは異なる挙動を示すことがあります。そのため、使用する際はisset()関数で値が存在するか確認することが推奨されます。

この二つの値は、同じパス情報のように見えますが、PHP_BINARYはPHP実行ファイルへのパス、$_SERVER['PHP_SELF']はウェブサーバーから見たスクリプトへのパスと、それぞれ異なる目的と文脈で利用される点にご注意ください。

Copy
1<?php
2
3/**
4 * 現在のPHP実行環境の基本的な情報を表示する関数。
5 *
6 * この関数は、PHPスクリプトを実行しているPHPバイナリのパスと、
7 * PHPが整数値を格納するために使用するバイト数を出力します。
8 * システムエンジニアを目指す初心者の方々が、PHPの実行環境やデータ型の
9 * 基礎を理解するのに役立つ情報を提供します。
10 */
11function displayPhpEnvironmentInfo(): void
12{
13    // PHP_BINARY 定数は、現在のPHPスクリプトを実行しているPHPバイナリ（実行ファイル）の
14    // フルパスを示します。これは、CLI (Command Line Interface) 環境でのPHP実行や、
15    // 異なるPHPバージョンを管理する際に役立つことがあります。
16    echo "PHPバイナリのパス: " . PHP_BINARY . PHP_EOL;
17
18    // PHP_INT_SIZE 定数は、PHPが整数を表現するために確保するメモリのバイト数を示します。
19    // これは通常、システムのアーキテクチャ（32ビットまたは64ビット）によって異なります。
20    // 例えば、8バイトは一般的に64ビットシステムを示します。
21    echo "PHP整数型のサイズ (バイト): " . PHP_INT_SIZE . PHP_EOL;
22
23    // PHP_INT_MAX 定数は、PHPが扱える最大の整数値を示します。
24    // PHP_INT_SIZE と密接に関連しており、システムの整数表現能力の限界を示します。
25    echo "PHPが扱える最大の整数値: " . PHP_INT_MAX . PHP_EOL;
26}
27
28// 関数を呼び出して、現在のPHP環境情報を表示します。
29displayPhpEnvironmentInfo();
30
31?>

このPHPサンプルコードは、現在のPHP実行環境に関する基本的な情報を初心者にもわかりやすく表示するものです。displayPhpEnvironmentInfoという関数は、引数を受け取らず、値を返しませんが、実行時にPHPの重要な環境情報をコンソールに出力します。

具体的には、PHP_BINARY定数を使用し、現在スクリプトを実行しているPHPバイナリ（実行ファイル）のフルパスを表示します。これは文字列型であり、CLI（コマンドラインインターフェース）環境でのPHP実行パスの確認や、複数のPHPバージョンを管理する際に役立ちます。

次に、PHP_INT_SIZE定数により、PHPが整数値を格納するために使用するバイト数を示します。この値は整数型で、通常はシステムのアーキテクチャ（32ビットか64ビットか）によって異なり、例えば8バイトであれば64ビットシステムであることを意味します。

さらに、PHP_INT_MAX定数を用いて、PHPが扱える最大の整数値を表示します。これも整数型であり、PHP_INT_SIZEと密接に関連し、PHPが表現できる整数の上限を示します。

これらの情報は、システムエンジニアを目指す初心者の皆様が、PHPの実行環境の仕組みやデータ型の基本的な特性を理解するための貴重な手がかりとなります。