Remove weird windows stuff, slight markup changes to make things more understandable and other small tweaks

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@328514 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Hannes Magnusson 2012-11-27 23:46:11 +00:00
parent c59dadcc33
commit 98a9ca1d9e

View file

@ -6,49 +6,106 @@
<para>
The MongoDB PHP driver should work on nearly any system: Windows, Mac OS X,
Unix, and Linux; little- and big-endian machines; 32- and 64-bit machines; PHP
5.1, 5.2, and 5.3.
5.2, 5.3 and 5.4.
</para>
<para>
&pecl.moved; This page gives more specific information on installing on different systems and troubleshooting issues users have run into.
&pecl.moved;
</para>
<itemizedlist>
<listitem>
<para>
<link xlink:href="#mongo.installation.nix">Installing on *NIX</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="#mongo.installation.manual">Manual Installation</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="#mongo.installation.osx">OS X</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="#mongo.installation.gentoo">Gentoo</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="#mongo.installation.fedora">Fedora</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="#mongo.installation.windows">Installing on Windows</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="#mongo.installation.thirdparty">Third-Party Installation Instructions</link>
</para>
</listitem>
</itemizedlist>
<simplelist>
<member>
<xref linkend="mongo.installation.manual" />
</member>
<member>
<xref linkend="mongo.installation.nix" />
</member>
<member>
<xref linkend="mongo.installation.windows" />
</member>
<member>
<xref linkend="mongo.installation.osx" />
</member>
<member>
<xref linkend="mongo.installation.gentoo" />
</member>
<member>
<xref linkend="mongo.installation.fedora" />
</member>
<member>
<xref linkend="mongo.installation.thirdparty" />
</member>
</simplelist>
<section xml:id="mongo.installation.manual">
<title>Manual Installation</title>
<para>For driver developers and people interested in the latest bugfixes, you
can compile the driver from the latest source code on
<link xlink:href="&url.mongodb.github;">Github</link>.
Go to Github and click the "download" button. Then run:
<programlisting>
<![CDATA[
$ tar zxvf mongodb-mongodb-php-driver-<commit_id>.tar.gz
$ cd mongodb-mongodb-php-driver-<commit_id>
$ phpize
$ ./configure
$ make all
$ sudo make install
]]>
</programlisting>
</para>
<para>
Make the following changes to php.ini:
</para>
<itemizedlist>
<listitem>
<para>
Make sure the <emphasis>extension_dir</emphasis> variable is pointing to
the directory containing <emphasis>mongo.so</emphasis>. The build will display where
it is installing the PHP driver with output that looks something like:
<programlisting>
<![CDATA[
Installing '/usr/lib/php/extensions/no-debug-non-zts-20060613/mongo.so'
]]>
</programlisting>
Make sure that it is the same as the PHP extension directory by runnning:
<programlisting>
<![CDATA[
$ php -i | grep extension_dir
extension_dir => /usr/lib/php/extensions/no-debug-non-zts-20060613 =>
/usr/lib/php/extensions/no-debug-non-zts-20060613
]]>
</programlisting>
If it's not, change the <emphasis>extension_dir</emphasis> in php.ini or
move <emphasis>mongo.so</emphasis>.
</para>
</listitem>
<listitem>
<para>
To load the extension on PHP startup, add a line:
<programlisting>
<![CDATA[
extension=mongo.so
]]>
</programlisting>
</para>
</listitem>
</itemizedlist>
<section xml:id="mongo.installation.nix">
<title>Installing on *NIX</title>
@ -82,79 +139,32 @@ extension=mongo.so
<para>
If pecl runs out of memory while installing, make sure memory_limit in
php.ini is set to at least 32MB.
php.ini is set to at least 128MB.
</para>
</section>
<section xml:id="mongo.installation.manual">
<title>Manual Installation</title>
<section xml:id="mongo.installation.windows">
<title>Installing on Windows</title>
<para>For driver developers and people interested in the latest bugfixes, you
can compile the driver from the latest source code on
<link xlink:href="&url.mongodb.github;">Github</link>.
Go to Github and click the "download" button. Then run:
<para>
Precompiled binaries for each release are available from
<link xlink:href="&url.mongodb.github.downloads;">Github</link> for a variety
of combinations of versions, thread safety, and VC libraries. Unzip the
archive and put php_mongo.dll in your PHP extension directory ("ext" by
default).
</para>
<para>
Add the following line to your php.ini file:
<programlisting>
<![CDATA[
$ tar zxvf mongodb-mongodb-php-driver-<commit_id>.tar.gz
$ cd mongodb-mongodb-php-driver-<commit_id>
$ phpize
$ ./configure
$ sudo make install
extension=php_mongo.dll
]]>
</programlisting>
</para>
<para>
Make the following changes to php.ini:
</para>
<itemizedlist>
<listitem>
<para>
Make sure the <emphasis>extension_dir</emphasis> variable is pointing to
the location of <emphasis>mongo.so</emphasis>. The build will display where
it is installing the PHP driver with output that looks something like:
<programlisting>
<![CDATA[
Installing '/usr/lib/php/extensions/no-debug-zts-20060613/mongo.so'
]]>
</programlisting>
Make sure that it is the same as the PHP extension directory by runnning:
<programlisting>
<![CDATA[
$ php -i | grep extension_dir
extension_dir => /usr/lib/php/extensions/no-debug-zts-20060613 =>
/usr/lib/php/extensions/no-debug-zts-20060613
]]>
</programlisting>
If it's not, change the <emphasis>extension_dir</emphasis> in php.ini or
move <emphasis>mongo.so</emphasis>.
</para>
</listitem>
<listitem>
<para>
To load the extension on PHP startup, add a line:
<programlisting>
<![CDATA[
extension=mongo.so
]]>
</programlisting>
</para>
</listitem>
</itemizedlist>
</section>
<section xml:id="mongo.installation.osx">
<title>OS X</title>
@ -187,7 +197,7 @@ sudo /Applications/XAMPP/xamppfiles/bin/pecl install mongo
<programlisting>
<![CDATA[
extension=mongo.so
extension=mongo.so
]]>
</programlisting>
@ -216,7 +226,12 @@ $ sudo emerge -va dev-php5/mongo
<programlisting>
<![CDATA[
$ phpize && aclocal && autoconf && ./configure && make && make install
$ phpize
$ aclocal
$ autoconf
$ ./configure
$ make
$ sudo make install
]]>
</programlisting>
@ -241,99 +256,6 @@ $ /usr/sbin/setsebool -P httpd_can_network_connect 1
</section>
</section>
<section xml:id="mongo.installation.windows">
<title>Installing on Windows</title>
<para>
Precompiled binaries for each release are available from
<link xlink:href="&url.mongodb.github.downloads;">Github</link> for a variety
of combinations of versions, thread safety, and VC libraries. Unzip the
archive and put php_mongo.dll in your PHP extension directory ("ext" by
default).
</para>
<para>
The latest (non-release) code is compiled into Windows binaries on every
commit. The zip consists of a .zip with php_mongo.dll and a version.txt.
Please keep the version.txt around so that if you have a question or problem,
you can give the developers the exact version you're using. (The number is
long and nonsensical, but it will make sense to the developers!)
</para>
<para>
To get the latest bug fixes (and possibly bugs), download the binary
corresponding to the PHP you have installed:
</para>
<itemizedlist>
<listitem>
<para>
<link xlink:href="&url.mongodb.vc652;">
PHP 5.2 VC6 Non-Thread-Safe Mongo extension
</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="&url.mongodb.vc6ts52;">
PHP 5.2 VC6 Thread-Safe Mongo extension
</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="&url.mongodb.vc6;">
PHP 5.3 VC6 Non-Thread-Safe Mongo extension
</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="&url.mongodb.vc6ts;">
PHP 5.3 VC6 Thread-Safe Mongo extension
</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="&url.mongodb.vc8;">
PHP 5.3 VC8 Non-Thread-Safe Mongo extension
</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="&url.mongodb.vc8ts;">
PHP 5.3 VC8 Thread-Safe Mongo extension
</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="&url.mongodb.vc9;">
PHP 5.3 VC9 Non-Thread-Safe Mongo extension
</link>
</para>
</listitem>
<listitem>
<para>
<link xlink:href="&url.mongodb.vc9ts;">
PHP 5.3 VC9 Thread-Safe Mongo extension
</link>
</para>
</listitem>
</itemizedlist>
<para>
Add the following line to your php.ini file:
<programlisting>
<![CDATA[
extension=php_mongo.dll
]]>
</programlisting>
</para>
</section>
<section xml:id="mongo.installation.thirdparty">
<title>Third-Party Installation Instructions</title>