curl_version

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

curl_version — cURL のバージョンを返す

説明

function curl_version(): array|false

cURL のバージョンについての情報を返します。

パラメータ

この関数にはパラメータはありません。

戻り値

以下の要素からなる連想配列を返します。

キー 値の説明
version_number cURL の 24 ビットのバージョン番号
version cURL バージョン番号を表す文字列
ssl_version_number libcurl が設定しなくなったため、常に 0
ssl_version OpenSSL バージョン番号を表す文字列
libz_version zlib バージョンを表す文字列
host cURL をビルドしたホストについての情報
age libcurl が返すバージョン情報の世代。新しいバージョンの libcurl ほど大きな値
features 定数 CURL_VERSION_*のビットマスク
protocols cURL がサポートするプロトコル名の配列
feature_list 全ての既知のcURL機能の連想配列と、それらがサポートされている(true) もしくはサポートされていない(false) かどうかを示す値
ares c-ares のバージョンを表す文字列。cURL が c-ares なしでビルドされている場合は空文字列
ares_num c-ares のバージョン番号。cURL が c-ares なしでビルドされている場合は 0
libidn libidn2 のバージョンを表す文字列。cURL が libidn2 なしでビルドされている場合は空文字列
iconv_ver_num iconv のバージョン番号。cURL が iconv なしでビルドされている場合は 0
libssh_version SSH ライブラリの名前とバージョンを表す文字列。cURL が SSH のサポートなしでビルドされている場合は空文字列
brotli_ver_num Brotli のバージョン番号。cURL が Brotli なしでビルドされている場合は 0
brotli_version Brotli のバージョンを表す文字列。cURL が Brotli なしでビルドされている場合は空文字列

変更履歴

バージョン 説明
8.4.0 feature_list が追加されました。
8.0.0 オプションの引数 age が削除されました。
7.4.0 オプションの引数 age は推奨されなくなりました。 値を渡すことができますが、無視されます。

例

例1 curl_version() の例

この例では、cURL でどの機能が使えるのかを調べるために curl_version() の返すビットマスク 'features' を使用します。 

<?php
// curl のバージョン配列を取得します
$version = curl_version();

// ビットフィールドを使用して、
// curl の機能を調べます
$bitfields = Array(
            'CURL_VERSION_IPV6', 
            'CURL_VERSION_KERBEROS4', 
            'CURL_VERSION_SSL', 
            'CURL_VERSION_LIBZ'
            );


foreach($bitfields as $feature)
{
    echo $feature . ($version['features'] & constant($feature) ? ' matches' : ' does not match');
    echo PHP_EOL;
}
?>

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug
＋add a note

User Contributed Notes

There are no user contributed notes for this page.