curl_version

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

curl_version — Retourne la version courante de cURL

Description

curl_version(): array|false

Retourne des informations sur la version cURL.

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Valeurs de retour

Retourne un tableau associatif contenant les éléments suivants :

Clé Description de la valeur

version_number numéro de version cURL 24 bit

version numéro de version cURL, sous la forme d'une chaîne de caractères

ssl_version_number numéro de version OpenSSL 24 bit

ssl_version numéro de version OpenSSL, sous la forme d'une chaîne de caractères

libz_version numéro de version zlib, sous la forme d'une chaîne de caractères

host Informations sur l'hôte sur lequel cURL a été construit

age

features Un masque de constantes CURL_VERSION_*

protocols Un tableau de noms de protocoles supportés par cURL

feature_list Un tableau associatif de toutes les fonctionnalités cURL connues, et si elles sont supportées (true) ou non (false).

Clé	Description de la valeur
version_number	numéro de version cURL 24 bit
version	numéro de version cURL, sous la forme d'une chaîne de caractères
ssl_version_number	numéro de version OpenSSL 24 bit
ssl_version	numéro de version OpenSSL, sous la forme d'une chaîne de caractères
libz_version	numéro de version zlib, sous la forme d'une chaîne de caractères
host	Informations sur l'hôte sur lequel cURL a été construit
age
features	Un masque de constantes *`CURL_VERSION_`**
protocols	Un tableau de noms de protocoles supportés par cURL
feature_list	Un tableau associatif de toutes les fonctionnalités cURL connues, et si elles sont supportées (`true`) ou non (`false`).

Historique

Version	Description
8.4.0	`features_list` ajouté.
8.0.0	Le paramètre optionnel `age` a été supprimé.
7.4.0	Le paramètre optionnel `age` est obsolète ; si une valeur est fournie, elle est ignorée.

Exemples

Exemple #1 Exemple avec curl_version()

Cet exemple analyse les fonctionnalités disponibles dans la version courante de cURL en utilisant le masque 'features' retourné par la fonction curl_version().

<?php
// Récupère la version de cURL, sous la forme d'un tableau
$version = curl_version();

// Voici les champs qui peuvent être utilisés
// afin de vérifier les fonctionnalités présentes dans 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) ? ' présente' : ' absente');
    echo PHP_EOL;
}
?>