【PHP8.x】php_uname()関数の使い方

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

作成日: 2025年09月11日更新日: 2025年10月02日

基本的な使い方

『php_uname関数は、PHPが実行されているオペレーティングシステム（OS）に関する情報を取得する関数です。この関数を使用することで、プログラムが動作しているサーバー環境の詳細を動的に確認できます。引数にモードを指定することで、取得する情報の種類を選択することが可能です。例えば、引数に 's' を指定するとOS名（例: "Linux" や "Windows NT"）、'n' を指定するとホスト名、'r' を指定するとOSのリリースバージョン、'm' を指定するとマシンのアーキテクチャ（例: "x86_64"）が文字列として返されます。引数を省略するか、'a' を指定した場合は、これらの情報がすべてスペースで区切られた一つの文字列として返却されます。関数は成功時に要求された情報を文字列で返し、情報の取得に失敗した場合は false を返します。システムエンジニアは、この関数を利用してサーバー環境を調査したり、OSによって処理を分岐させたりするようなスクリプトを記述することができます。

構文(syntax)


1<?php
2php_uname();
3php_uname('s');
4?>

引数(parameters)

string $mode = 'a'

string $mode = 'a': 取得するシステム情報の種類を指定する文字列。デフォルトは 'a' で、すべての情報を取得します。

戻り値(return)

string

php_uname関数は、PHPが実行されているオペレーティングシステム名、リリース、カーネル名などを文字列で返します。

サンプルコード

php_uname('n')でホスト名を取得する


1<?php
2
3/**
4 * php_uname関数を使用して、現在のシステムのホスト名を取得し表示するスクリプト。
5 *
6 * php_uname関数は、オペレーティングシステムに関する情報を取得するために使用されます。
7 * 引数 'n' を指定すると、システムのネットワークノード名（通常はホスト名）が返されます。
8 */
9
10// php_uname関数を引数 'n' で呼び出し、システムのホスト名を取得します。
11$hostname = php_uname('n');
12
13// 取得したホスト名を標準出力に表示します。
14echo "現在のシステムのホスト名: " . $hostname . PHP_EOL;
15
16?>

php_uname関数は、PHPスクリプトが実行されているオペレーティングシステム（OS）に関する情報を取得するために使用される関数です。システムエンジニアにとって、稼働環境の情報を確認することは非常に重要であり、この関数はそのような場面で役立ちます。

この関数は、引数として文字列型の$modeを受け取ります。この$modeによって、どのような情報を取得するかが決まります。例えば、サンプルコードで指定されている'n'という引数は、システムのネットワークノード名、つまり通常はホスト名を意味します。この引数を指定すると、php_uname関数はシステムのホスト名を文字列として返します。引数を省略した場合のデフォルト値'a'では、システムに関するより詳細なすべての情報が一つの文字列として返されます。

サンプルコードでは、php_uname('n')を呼び出すことで、現在のシステムが持つホスト名を取得し、その結果を$hostname変数に代入しています。その後、echo文を使用して「現在のシステムのホスト名:」というメッセージとともに、取得したホスト名を標準出力に表示しています。PHP_EOLは、OSに応じた改行コードを挿入し、出力を整形するのに役立ちます。このように、php_uname関数を利用することで、PHPプログラムから手軽にシステム情報を取得し、活用することが可能になります。

php_uname関数は、実行中のシステムのオペレーティングシステムに関する情報を取得します。サンプルコードでは引数'n'でホスト名を取得していますが、引数を省略するか'a'を指定すると、OSの種類、バージョン、ハードウェア情報など、より多くの詳細なシステム情報が返されます。

これらのシステム情報は、アプリケーションのデバッグや管理には役立ちますが、ウェブアプリケーションなどで不特定多数に表示されると、攻撃者にサーバー構成のヒントを与えるセキュリティリスクに繋がる可能性があります。そのため、公開環境で利用する際は、表示する情報の種類を厳選し、必要な情報のみを安全な方法で利用するように注意が必要です。取得される情報は実行されるOSによって異なる場合がある点も認識しておいてください。

php_uname() でシステム情報を取得する


1<?php
2
3/**
4 * php_uname関数の使用例を示すスクリプト。
5 * 実行中のオペレーティングシステムに関する情報を取得します。
6 */
7function displaySystemInformation(): void
8{
9    // 引数なしの場合 (デフォルトの 'a' モード - すべての情報)
10    echo "すべての情報: " . php_uname() . "\n\n";
11
12    // 各種モードでの情報取得
13    echo "OS名 ('s'): " . php_uname('s') . "\n";
14    echo "ホスト名 ('n'): " . php_uname('n') . "\n";
15    echo "リリース名 ('r'): " . php_uname('r') . "\n";
16    echo "バージョン情報 ('v'): " . php_uname('v') . "\n";
17    echo "マシンタイプ ('m'): " . php_uname('m') . "\n";
18}
19
20// 関数を実行してシステム情報を表示
21displaySystemInformation();
22
23?>

PHPのphp_uname関数は、現在スクリプトが動作しているオペレーティングシステム（OS）に関する詳細な情報を取得するために使用される関数です。システムエンジニアにとって、プログラムがどのような環境で動いているかを知ることは非常に重要であり、この関数はそのような環境情報の取得に役立ちます。

この関数は、引数 $mode を受け取りますが、引数なしで呼び出すことも可能です。引数を省略した場合、または 'a' を指定した場合は、OSの名前、ホスト名、リリース名、バージョン情報、マシンタイプといった、すべてのシステム情報がまとめて一つの文字列として返されます。例えば、php_uname() と記述すると、「Linux hostname 5.15.0-78-generic #85-Ubuntu SMP Fri Jul 21 08:13:35 UTC 2023 x86_64」のような形式の結果が得られます。

また、引数 $mode に特定の文字を指定することで、必要な情報だけをピンポイントで取得できます。例えば、php_uname('s') はOS名のみを、php_uname('n') はホスト名のみを、php_uname('r') はリリース名のみを、php_uname('v') はOSのバージョン情報のみを、php_uname('m') はマシンタイプのみを文字列として返します。この関数の戻り値は常に文字列型です。これにより、プログラムが動作する環境に応じて処理を適切に制御するといった、柔軟な開発が可能になります。

php_uname関数は、実行中のオペレーティングシステムの情報を取得します。この関数が返す情報は、システムのバージョンやホスト名など、外部に漏洩するとセキュリティ上のリスクとなる重要なデータを含んでいます。そのため、特にウェブサイトなどで情報を直接ユーザーに表示する際は、細心の注意が必要です。本番環境で利用する場合は、利用目的を明確にし、情報が外部に公開されないよう厳重な管理を徹底してください。また、取得される情報の形式や内容は、プログラムが動作するOSによって異なりますので、常に同じ出力が得られるとは限りません。引数$modeを指定することで、OS名、ホスト名、リリースバージョンなど、特定の情報のみを選択的に取得できます。必要な情報だけを取得し、不要な情報の露出は避けましょう。