PHP Gethostbyname関数の基本的な使用法は何ですか？基本的な操作をすばやく習得する方法は？

gitbox 2025-09-15

PHPでは、 Gethostbynameは非常に実用的な機能であり、ホスト名（ドメイン名）を介して対応するIPアドレスを取得するために使用されます。この関数は、特にドメイン名の解像度を実行する場合、ネットワークプログラミング、DNSクエリなどのシナリオでよく使用されます。

1。関数の概要

gethostbynameの基本的な使用法は、ドメイン名を関数に渡し、ドメイン名のIPアドレスを返すことです。ドメイン名を解決できない場合、または問題がある場合、関数は元のドメイン名文字列を返します。

文法：

 <span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-title function_ invoke__">gethostbyname</span></span><span> ( </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$hostname</span></span><span> )
</span></span>

$ hostName ：通常はwww.example.comなどの完全なドメイン名です。

返品値：

この関数は、対応するホスト名のIPアドレスを表す文字列を返します。解析が失敗した場合、着信ホスト名が返されます。

2。例を使用してください

いくつかの簡単な例を使用して、 gethostbynameの実際のアプリケーションを理解しましょう。

例1：基本的な使用法

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$hostname</span></span><span> = </span><span><span class="hljs-string">"www.example.com"</span></span><span>;
</span><span><span class="hljs-variable">$ip</span></span><span> = </span><span><span class="hljs-title function_ invoke__">gethostbyname</span></span><span>(</span><span><span class="hljs-variable">$hostname</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"The IP address of <span class="hljs-subst">$hostname</span></span></span><span> is: </span><span><span class="hljs-subst">$ip</span></span><span>";
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

出力：

 <span><span><span class="hljs-attribute">The</span></span><span> IP address of www.example.com is: </span><span><span class="hljs-number">93.184.216.34</span></span><span>
</span></span>

この例では、 www.example.comで渡され、 gethostbynameはドメイン名93.184.216.34に対応するIPアドレスを返します。

例2：解析障害の状況

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$hostname</span></span><span> = </span><span><span class="hljs-string">"nonexistentdomain.xyz"</span></span><span>;
</span><span><span class="hljs-variable">$ip</span></span><span> = </span><span><span class="hljs-title function_ invoke__">gethostbyname</span></span><span>(</span><span><span class="hljs-variable">$hostname</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"The IP address of <span class="hljs-subst">$hostname</span></span></span><span> is: </span><span><span class="hljs-subst">$ip</span></span><span>";
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

出力：

 <span><span>The IP address of nonexistentdomain.xyz </span><span><span class="hljs-keyword">is</span></span><span>: nonexistentdomain.xyz
</span></span>

ドメイン名を解決できない場合、 gethostbynameは着信ホスト名を直接返します。この場合、 nonexistentdomain.xyzを解決できないため、出力はまだ元のドメイン名です。

3。注意すべきこと

IPv4アドレス： gethostbynameはIPv4アドレスのみを返します。 IPv6アドレスを取得する必要がある場合は、 getaddrinfoなどの他の方法を使用する必要があります。
キャッシュメカニズム： gethostbynameは、システムのDNSキャッシュに依存する場合があります。したがって、複数の要求が同じドメイン名を解決する場合、毎回ライブクエリの代わりにキャッシュされた結果が返される場合があります。
パフォーマンスの考慮事項：短期間でドメイン名を頻繁に解決する必要がある場合は、DNSクエリの数を減らしてパフォーマンスを改善するためにキャッシュメカニズムを使用する必要があるかどうかを検討してください。
エラー処理： gethostbynameは場合によってはエラーメッセージを返すことができますが（たとえば、元のホスト名を返します）、エラーコードやより多くのエラーメッセージは提供されません。より詳細なエラー処理が必要な場合は、 gethostbyaddrやcheckdnsrrなどの他の機能を組み合わせることができます。

4.一般的なアプリケーションシナリオ

DNSクエリツール： gethostbynameを使用して、シンプルなDNSクエリツールを作成できます。
ネットワークのデバッグ：ネットワーク接続をデバッグしたり、ドメイン名を解決したりする場合、 gethostbynameはドメイン名が正常に解決されるかどうかを判断するのに役立ちます。
自動展開：一部の自動化スクリプトでは、 gethostbynameはターゲットサーバーがオンラインであることを確認するのに役立ちます。

5。関連する関数

ドメイン名の解像度の要件が高い場合は、次のPHP関数と併せて使用できます。

gethostbyaddr（） ：IPアドレスに基づいてホスト名を逆にクエリします。
checkdnsrr（） ：ドメイン名のDNSレコードが存在するかどうかを確認します。
DNS_GET_RECORD（） ：ドメイン名のすべてのDNSレコードを取得して、より多くの情報を取得します。

6。概要

Gethostbynameは、ホスト名を介してIPアドレスを取得するためのシンプルだが非常に効果的なツールです。いくつかの単純なドメイン名解像度のタスクに最適で、使いやすいです。その基本的な使用法と制限を理解することにより、開発者はネットワーク関連のプログラミングの問題をより効率的に解決できます。