1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148
|
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297028 $ -->
<refentry xml:id="function.curl-version" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>curl_version</refname>
<refpurpose>Gets cURL version information</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>curl_version</methodname>
<methodparam choice="opt"><type>int</type><parameter>age</parameter><initializer>CURLVERSION_NOW</initializer></methodparam>
</methodsynopsis>
<para>
Returns information about the cURL version.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>age</parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns an associative array with the following elements:
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Indice</entry>
<entry>Value description</entry>
</row>
</thead>
<tbody>
<row>
<entry>version_number</entry>
<entry>cURL 24 bit version number</entry>
</row>
<row>
<entry>version</entry>
<entry>cURL version number, as a string</entry>
</row>
<row>
<entry>ssl_version_number</entry>
<entry>OpenSSL 24 bit version number</entry>
</row>
<row>
<entry>ssl_version</entry>
<entry>OpenSSL version number, as a string</entry>
</row>
<row>
<entry>libz_version</entry>
<entry>zlib version number, as a string</entry>
</row>
<row>
<entry>host</entry>
<entry>Information about the host where cURL was built</entry>
</row>
<row>
<entry>age</entry>
<entry></entry>
</row>
<row>
<entry>features</entry>
<entry>A bitmask of the <literal>CURL_VERSION_XXX</literal> constants</entry>
</row>
<row>
<entry>protocols</entry>
<entry>An array of protocols names supported by cURL</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>curl_version</function> example</title>
<para>
This example will check which features that's available
in cURL build by using the 'features' bitmask returned
by <function>curl_version</function>.
</para>
<programlisting role="php">
<![CDATA[
<?php
// Get curl version array
$version = curl_version();
// These are the bitfields that can be used
// to check for features in the curl build
$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;
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
|