【PHP8.x】gethostname関数の使い方

Copy
1<?php
2
3/**
4 * このスクリプトは、現在のシステム（サーバー）のホスト名を取得し、表示します。
5 * gethostname() 関数は、引数なしで現在のホスト名を返します。
6 * 取得に失敗した場合は false を返します。
7 */
8
9// gethostname() 関数を使用して、現在のホスト名を取得します。
10// 戻り値は文字列 (string) か、取得に失敗した場合は false です。
11$hostname = gethostname();
12
13// ホスト名が正常に取得できたかを確認します。
14if ($hostname !== false) {
15    // 成功した場合、取得したホスト名を表示します。
16    // PHP_EOL は、OSに応じた改行コードを出力するための定数です。
17    echo "現在のホスト名: " . $hostname . PHP_EOL;
18} else {
19    // 失敗した場合、エラーメッセージを表示します。
20    echo "ホスト名の取得に失敗しました。" . PHP_EOL;
21}
22
23?>

gethostname() 関数は、PHPで現在スクリプトが動作しているシステム（サーバー）のホスト名を取得するために使用されます。この関数は、外部サービスやデータベースへの接続時など、実行環境を特定したい場合に役立ちます。

この関数は引数を一切必要とせず、呼び出すだけで現在のホスト名を返します。ホスト名の取得に成功した場合は、そのホスト名を表す文字列（string）が戻り値として返されます。しかし、何らかの理由でホスト名の取得に失敗した場合には、falseが戻り値となります。

サンプルコードでは、まずgethostname()関数を実行し、その結果を$hostname変数に代入しています。次に、if ($hostname !== false)という条件分岐を使って、ホスト名が正常に取得できたかどうかを確認しています。もしfalseではない、つまり文字列としてホスト名が取得できていれば、「現在のホスト名: 」に続けて取得したホスト名を表示します。ここで使われているPHP_EOLは、WindowsやLinuxなど、実行環境に応じた適切な改行コードを出力するためのPHPの定数です。もしgethostname()がfalseを返した場合は、elseブロックが実行され、「ホスト名の取得に失敗しました。」というエラーメッセージが表示されます。このように、関数の戻り値を確認し、成功時と失敗時で処理を分けることで、堅牢なプログラムを作成することができます。

Copy
1<?php
2
3/**
4 * このスクリプトは、PHPのgethostname関数を使用して
5 * 実行中のサーバーのホスト名を取得し表示します。
6 *
7 * gethostname() は、成功した場合はホスト名を文字列で返し、
8 * 失敗した場合は false を返します。
9 */
10function displayCurrentHostname(): void
11{
12    // gethostname関数を呼び出して、現在のホスト名を取得します。
13    $hostname = gethostname();
14
15    // 取得結果がfalseでないか確認します。
16    if ($hostname !== false) {
17        // ホスト名が正常に取得できた場合、それを表示します。
18        echo "現在のホスト名: " . $hostname . PHP_EOL;
19    } else {
20        // ホスト名の取得に失敗した場合のメッセージを表示します。
21        echo "ホスト名の取得に失敗しました。" . PHP_EOL;
22    }
23}
24
25// 定義した関数を実行します。
26displayCurrentHostname();

gethostname関数は、PHPが実行されているサーバーのホスト名を取得するために使用される関数です。この関数には引数がなく、シンプルに呼び出すだけで動作します。

関数を呼び出すと、通常は実行中のサーバーのホスト名が文字列として返されます。しかし、何らかの理由でホスト名の取得に失敗した場合は、falseが返されることがあります。そのため、プログラムで戻り値がfalseでないかを確認し、状況に応じて適切な処理を行うことが重要です。

提供されたサンプルコードでは、displayCurrentHostnameという関数の中でgethostname()を呼び出し、その結果を$hostname変数に格納しています。そして、if ($hostname !== false)という条件分岐を使って、ホスト名が正常に取得できたかどうかを判断しています。

ホスト名が正常に取得できた場合には、取得したホスト名を「現在のホスト名:」というメッセージとともに表示します。一方、ホスト名の取得に失敗しfalseが返された場合には、「ホスト名の取得に失敗しました。」というエラーメッセージが表示されます。このように、このコードはgethostname関数の基本的な使い方と、戻り値がエラーである可能性を考慮した堅実な処理方法を示しています。