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

<?php

/**
 * このスクリプトは、現在のシステム（サーバー）のホスト名を取得し、表示します。
 * gethostname() 関数は、引数なしで現在のホスト名を返します。
 * 取得に失敗した場合は false を返します。
 */

// gethostname() 関数を使用して、現在のホスト名を取得します。
// 戻り値は文字列 (string) か、取得に失敗した場合は false です。
$hostname = gethostname();

// ホスト名が正常に取得できたかを確認します。
if ($hostname !== false) {
    // 成功した場合、取得したホスト名を表示します。
    // PHP_EOL は、OSに応じた改行コードを出力するための定数です。
    echo "現在のホスト名: " . $hostname . PHP_EOL;
} else {
    // 失敗した場合、エラーメッセージを表示します。
    echo "ホスト名の取得に失敗しました。" . PHP_EOL;
}

?>

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

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

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

<?php

/**
 * このスクリプトは、PHPのgethostname関数を使用して
 * 実行中のサーバーのホスト名を取得し表示します。
 *
 * gethostname() は、成功した場合はホスト名を文字列で返し、
 * 失敗した場合は false を返します。
 */
function displayCurrentHostname(): void
{
    // gethostname関数を呼び出して、現在のホスト名を取得します。
    $hostname = gethostname();

    // 取得結果がfalseでないか確認します。
    if ($hostname !== false) {
        // ホスト名が正常に取得できた場合、それを表示します。
        echo "現在のホスト名: " . $hostname . PHP_EOL;
    } else {
        // ホスト名の取得に失敗した場合のメッセージを表示します。
        echo "ホスト名の取得に失敗しました。" . PHP_EOL;
    }
}

// 定義した関数を実行します。
displayCurrentHostname();

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

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

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

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