socket_addrinfo_lookup

与えられたホスト名に関する getaddrinfo の内容を配列で取得する

説明

arrayfalse socket_addrinfo_lookup(string $host, stringnull $service = null, array $hints = [])

host に接続できる別のやり方を探します。 この関数が返す配列は socket_addrinfo_bind を使ってバインドできる AddressInfo クラスのインスタンスが含まれています。

パラメータ

host

探す対象のホスト名

service

接続するサービス。service が数値形式の文字列の場合、 ポート番号に翻訳されます。 それ以外の場合、ネットワークサービス名に翻訳されます。 これは、オペレーティングシステムによってポート番号にマップされます。

hints

アドレスを選択する条件を与えるヒント。 getaddrinfo によって定義されるヒントを指定できます。

戻り値

socket_addrinfo_* 関数で使える AddressInfo クラスのインスタンスの配列を返します。 失敗した場合、false を返します。

変更履歴

バージョン 説明
8.0.0 成功した場合に、この関数は AddressInfo クラスのインスタンスの配列を返すようになりました。 これより前のバージョンでは、リソースの配列を返していました。
8.0.0 service は、nullable になりました。

参考

  • socket_addrinfo_bind
  • socket_addrinfo_connect
  • socket_addrinfo_explain