php[tek] 2018 : Call for Speakers

curl_version

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

curl_versionВозвращает версию cURL

Описание

array curl_version ([ int $age = CURLVERSION_NOW ] )

Возвращает информацию о версии cURL.

Список параметров

age

Возвращаемые значения

Возвращает ассоциативный массив со следующими элементами:

Индекс Описание значения
version_number 24-битный номер версии cURL
version Номер версии cURL, в виде строки
ssl_version_number 24-битный номер версии OpenSSL
ssl_version Номер версии OpenSSL, в виде строки
libz_version Номер версии zlib, в виде строки
host Информация о хосте, где была собрана cURL
age  
features Битовая маска констант CURL_VERSION_XXX
protocols Массив поддерживаемых протоколов cURL

Примеры

Пример #1 Пример использования curl_version()

Этот пример проверит какие возможности поддерживает данная сборка cURL с помощью битовой маски 'features', возвращаемой функцией curl_version().

<?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) ? ' есть' ' нет');
    echo 
PHP_EOL;
}
?>

add a note add a note

User Contributed Notes 1 note

up
-1
nimasdj [AT] yahoo [DOT] com
2 years ago
If you want to check if your curl supports ssl, it is not good idea to go with curl_version()['ssl_version'],
e.g.
<?php
if (stripos(curl_version()['ssl_version'], "openssl") !== false) {
?>
as curl says here http://curl.haxx.se/docs/faq.html#Does_curl_work_build_with_other it may use other ssl library than OpenSSL (which does not have anything to do with that separated openssl extension, curl has its own openssl library) so as described here http://curl.haxx.se/libcurl/c/curl_version_info.html it is better to go with CURL_VERSION_SSL bitmask check rather than curl_version()['ssl_version']. Note that not all of those constants stated on official cURL website are available in php, but only these four constants:

[CURL_VERSION_IPV6] => 1
[CURL_VERSION_KERBEROS4] => 2
[CURL_VERSION_SSL] => 4
[CURL_VERSION_LIBZ] => 8

I tested this on Windows by disabling "openssl" extension in php.ini and noticed curl has nothing to do with that separated openssl extension but it has its own openssl, in other word, disabling openssl extension does not affect on curl_version()['ssl_version']. So if you want to check if curl has support for ssl, you should not rely on existence of that separated openssl extension and above I explained you should not rely on curl_version()['ssl_version'] neither. The only reliable way is CURL_VERSION_SSL bitmask checking:
<?php
if (!curl_version()['features'] & CURL_VERSION_SSL) {
    echo
"SSL is not supported with this cURL installation.";
}
?>
To Top