gethostname

関数の概要

PHPの gethostname 関数は、現在実行中のサーバーやホストの名前（ホスト名）を取得するための関数です。ネットワーク関連の処理や環境情報の確認時に役立ちます。特に複数サーバーで動作しているシステムのデバッグや管理時に使用されることが多いです。

パラメータの説明

• なし — gethostname は引数を取りません。

戻り値

関数の戻り値は文字列で、現在のホスト名が返されます。取得に失敗した場合は false が返されます。

使用例

基本的な使い方

<?php
$hostname = gethostname();
echo "ホスト名は: " . $hostname;
?>

この例では、現在のホスト名を取得して画面に表示しています。単純にサーバーの名前を知りたい時に使います。

条件分岐での活用例

<?php
if (gethostname() === 'production-server') {
    // 本番環境向けの処理
    echo "本番環境です。";
} else {
    // 開発環境向けの処理
    echo "開発環境またはテスト環境です。";
}
?>

ホスト名によって処理を分けることで、本番環境と開発環境で異なる設定を自動的に切り替えることができます。

ログファイルにホスト名を付加する例

<?php
$hostname = gethostname();
$logMessage = "[" . date('Y-m-d H:i:s') . "] ({$hostname}) 処理を開始しました。";
file_put_contents('app.log', $logMessage . PHP_EOL, FILE_APPEND);
?>

ログの記録時にホスト名を含めることで、複数のサーバーからのログを区別しやすくなります。

関連する関数

• php_uname() — サーバーやOSの詳細情報を取得できます。
• gethostbyname() — ホスト名からIPアドレスを取得します。
• gethostbynamel() — ホスト名から複数のIPアドレスを配列で取得します。

まとめ

PHPの gethostname は現在のホスト名を簡単に取得できる便利な関数です。サーバー名を判別したい際や環境条件に応じた処理の切り替え、ログにホスト名を付加するなど幅広い場面で役立ちます。引数不要で手軽に利用できるため、ネットワーク関連の処理を書く際にはぜひ覚えておきたい関数です。