Gethostbynamel機能とは何ですか？ PHPでどのように使用されていますか？

gitbox 2025-07-18

PHPでは、 Gethostbynamel関数は非常に有用なネットワーク関数であり、開発者はホスト名（ドメイン名）を介してホストに対応するIPアドレスのリストを取得できます。この関数は、特にホスト名に基づいてIPアドレスを解決する必要がある場合、またはDNSクエリを実行するときに、ネットワークプログラミングでよく使用されます。

関数の基本的な定義

Gethostbynamel関数の関数は、ホスト名（www.example.comなど）に基づいて、ホストのすべてのIPアドレスを含む配列を返すことです。 Gethostbynamelは、IPv4アドレスではなくIPv4アドレスのみを返すことに注意する価値があります。

関数プロトタイプ

<span><span><span class="hljs-keyword">array</span></span><span> </span><span><span class="hljs-title function_ invoke__">gethostbynamel</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アドレスを含む配列を返します。解析が失敗した場合、 falseが返されます。

使用の例

Gethostbynamel関数を使用してドメイン名を解析し、ドメイン名に関連付けられたすべてのIPアドレスを出力する方法を示す簡単な例を示します。

 <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_addresses</span></span><span> = </span><span><span class="hljs-title function_ invoke__">gethostbynamel</span></span><span>(</span><span><span class="hljs-variable">$hostname</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$ip_addresses</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"IP アドレスリスト：\n"</span></span><span>;
    </span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$ip_addresses</span></span><span> </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$ip</span></span><span>) {
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$ip</span></span><span> . </span><span><span class="hljs-string">"\n"</span></span><span>;
    }
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"ホスト名を解決できません <span class="hljs-subst">$hostname</span></span></span><span>\n";
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

上記のコードでは、最初にホスト名$ hostnameを指定し、次にgethostbyname関数を呼び出して、ホスト名に対応するすべてのIPアドレスを取得します。返品値が偽でない場合、IPアドレスアレイを通過し、各IPアドレスを出力します。

シナリオを使用します

DNSクエリ： Gethostbynamelは、ホスト名でIPアドレスを照会する必要がある場合に非常に実用的なツールです。たとえば、リモートサーバーへのアクセスを必要とするプログラムを開発する場合、最初にターゲットサーバーのIPアドレスを取得する必要がある場合があります。
ネットワーク診断ツール：ネットワーク診断ツールを開発する場合、 Gethostbynamelは、ドメイン名がIPアドレスに正しく解決されているかどうかを確認するか、他のネットワーク関連のデバッグ作業に使用されるかどうかを確認できます。
クロスプラットフォーム開発：PHPでgethostbynamel関数を使用すると、ドメイン名のIPアドレスが異なるオペレーティングシステムで正しく取得できるようにすることができ、アプリケーションの互換性を向上させることができます。

エラー処理と制限

指定されたホスト名を解析できない場合、または解析プロセスが正しくない場合、 gethostbynamelはfalseを返します。
この関数は、IPv4アドレスの取得のみをサポートすることに注意する必要があります。 IPv6アドレスを取得する必要がある場合は、代わりにgetaddrinfo関数を使用できます。
Gethostbynamelの機能は、基礎となるオペレーティングシステムのDNSサービスに依存しているため、解像度の結果は、ネットワーク環境またはDNS構成の影響を受ける可能性があります。

まとめ

Gethostbynamelは、開発者にホスト名に基づいてIPアドレスを取得する機能を開発者に提供するシンプルで強力なPHP機能です。ネットワークプログラミングでは、特にDNSクエリ、ネットワーク診断、またはホストの解決が必要な場合、アプリケーションシナリオは非常に広くなっています。 IPv6アドレスを取得するなど、より複雑な状況に対処する必要がある場合、開発者はgetaddrinfoなどの他の機能の使用を検討することをお勧めします。

gethostbynamel