Update driver requirements for PHP version and libraries

https://jira.mongodb.org/browse/PHPC-1442


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350029 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Jeremy Mikola 2020-06-10 20:44:20 +00:00
parent 998a03eb17
commit 57f5cde3ce

View file

@ -7,32 +7,41 @@
<article xml:id="mongodb.requirements">
&reftitle.required;
<para>
The driver requires PHP 5.5 or higher.
As of version 1.8.0, the driver requires PHP 7.0 or higher. Previous versions
of the driver allow compatibility with older PHP versions.
</para>
<para>
The driver requires <link xlink:href="&url.mongodb.libbson;">libbson</link>
and <link xlink:href="&url.mongodb.libmongoc;">libmongoc</link>, and will use
bundled versions of both libraries by default.
bundled versions of both libraries by default. System libraries may also be
used, as discussed in the
<link linkend="mongodb.installation.manual">manual installation</link>
documentation.
</para>
<para>
The driver requires <link xlink:href="&url.openssl;">OpenSSL</link> and will
rely on PHP to find its headers (i.e. <literal>PHP_SETUP_OPENSSL</literal>).
If the build process fails to find OpenSSL, check that the OpenSSL
development package (e.g. <literal>libssl-dev</literal>) and
The driver, via libmongoc, optionally depends on a TLS library (e.g. OpenSSL)
and will use it if available. If the build process fails to find a TLS
library, users should check that the appropriate development package (e.g.
<literal>libssl-dev</literal>) and
<link xlink:href="&url.mongodb.wiki.pkg-config;">pkg-config</link> are both
installed.
installed. The process for detecting and configuring TLS libraries is
discussed in more detail in the
<link linkend="mongodb.installation.manual">manual installation</link>
documentation.
</para>
<para>
Due to potential problems representing 64-bit integers on 32-bit platforms,
users are advised to use 64-bit environments. When using a 32-bit platform,
be aware that any 64-bit integer read from the database will be returned as a
<classname>MongoDB\BSON\Int64</classname> instance instead of a PHP integer
type.
</para>
<para>
<link xlink:href="&url.cyrus;">Cyrus SASL</link> is an optional dependency
and will be used if available.
<link xlink:href="&url.cyrus;">Cyrus SASL</link> is an optional dependency to
support Kerberos authentication and will be used if available.
</para>
<note>
<simpara>
Due to potential problems representing 64-bit integers on 32-bit platforms,
users are advised to use 64-bit environments. When using a 32-bit platform,
be aware that any 64-bit integer read from the database will be returned as
a <classname>MongoDB\BSON\Int64</classname> instance instead of a PHP
integer type.
</simpara>
</note>
</article>
&reference.mongodb.configure;