Choosing the Right MongoDB PHP Driver: Version Guide & Upgrade Steps

Hello! The 360DBA team presents a MongoDB practice guide covering driver usage notes, real‑world issues, and solutions. The previous article covered program connections; this one focuses on driver considerations and online cases.

Version Selection

MongoDB driver (for PHP) : For PHP versions below 5.5 (excluding 5.5) use driver 1.4.5. For PHP 5.5 and above, choose driver 1.5.5 or the latest stable version. Do not arbitrarily select versions; avoid development builds.

MongoDB server version :

If the server version is 2.6, select driver 1.4.5, 1.5.5, or the latest stable version; avoid low‑quality or unstable releases.

If the server version is 2.4, select driver 1.4.5.

Using unstable driver versions can affect business stability.

Driver case 1 : A service using driver 1.4.0 rc1 frequently reported “No MongoDB service”. Upgrading to driver 1.4.5 resolved the issue.

Driver case 2 : An unstable driver caused “candidate server found” errors, leading to prolonged failures when the primary MongoDB node went down. Upgrading to driver 1.4.5 restored high‑availability support.

Driver Upgrade

Download and compile: <code>wget http://pecl.php.net/get/mongo-1.4.5.tgz tar -zxvf mongo-1.4.5.tgz cd mongo-1.4.5 phpize ./configure make && make install</code>

Exception handling: After compilation, if a no-debug-non-zts-20060613 error appears, move /usr/local/php/lib/php/extensions/no-debug-non-zts-20060613/mongo.so to /usr/local/php/extensions/ and back up the original mongo.so .

Verify version: Edit /usr/local/php/lib/php.ini to ensure the line extension=mongo.so is present. Run php -i | grep -iA2 mongo and confirm the output shows Version => 1.4.5 .

Driver Installation

Deploy the MongoDB PHP driver on front‑end machines via the HULK platform for batch installation, or follow the above upgrade steps for manual source compilation.

Hope this information helps; more MongoDB series articles will follow.