تم تطوير هذا الامتداد فوق مكتبات libmongoc وlibbson. يوفر الحد الأدنى من واجهة برمجة التطبيقات (API) لوظائف برنامج التشغيل الأساسية: الأوامر والاستعلامات والكتابة وإدارة الاتصال وتسلسل BSON.
قد توفر مكتبات Userland PHP التي تعتمد على هذا الامتداد واجهات برمجة تطبيقات ذات مستوى أعلى، مثل منشئي الاستعلامات وأساليب مساعد الأوامر الفردية وGridFS. يجب على مطوري التطبيقات التفكير في استخدام هذا الامتداد مع مكتبة MongoDB PHP، التي تنفذ نفس واجهات برمجة التطبيقات ذات المستوى الأعلى الموجودة في برامج تشغيل MongoDB للغات الأخرى.
https://www.php.net/mongodb
https://www.mongodb.com/docs/drivers/php-drivers/
لبناء وتثبيت برنامج التشغيل:
$ pecl install mongodb $ echo "extension=mongodb.so" >> `php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||"`
يمكن العثور على تعليمات التثبيت الإضافية في وثائق PHP.net.
تم تصميم هذا الامتداد ليتم استخدامه جنبًا إلى جنب مع مكتبة MongoDB PHP، والتي يتم توزيعها كحزمة mongodb/mongodb
للملحن.
يتم إنشاء الإصدارات تلقائيًا وتوقيعها باستخدام مفتاح GPG الخاص بفريق PHP. ينطبق هذا على علامة git بالإضافة إلى جميع حزم الإصدار المقدمة كجزء من إصدار GitHub. للتحقق من الحزم المتوفرة، قم بتنزيل المفتاح واستيراده باستخدام gpg
:
gpg - استيراد php-driver.asc
يتم توفير حزم PECL كعناصر إصدار على GitHub، وكذلك على صفحة PECL الرئيسية. سيحتوي إصدار GitHub أيضًا على ملف توقيع منفصل لحزمة PECL (يسمى mongodb-XYZtgz.sig
).
للتحقق من سلامة الحزمة التي تم تنزيلها، قم بتشغيل الأمر التالي:
GPG - التحقق من mongodb-XYZtgz.sig mongodb-XYZtgz
ملحوظة
لم يتم إجراء أي تحقق عند استخدام pecl
لتثبيت الحزمة. لضمان سلامة الإصدار عند استخدام pecl
، قم بتنزيل tarball يدويًا من إصدار GitHub، وتحقق من التوقيع، ثم قم بتثبيت الحزمة من tarball التي تم تنزيلها باستخدام pecl install mongodb-XYZtgz
.
تحتوي ثنائيات Windows الموزعة من خلال إصدارات GitHub على توقيع منفصل لملف php_mongodb.dll
المسمى php_mongodb.dll.sig
. للتحقق من سلامة DLL، قم بتشغيل الأمر التالي:
GPG - التحقق من php_mongodb.dll.sig php_mongodb.dll.tgz
ملحوظة
ثنائيات Windows الموزعة مباشرة من خلال PECL لم يتم توقيعها بواسطة MongoDB ولا يمكن التحقق منها. إذا كنت بحاجة إلى التحقق من سلامة الملف الثنائي الذي تم تنزيله، فقم دائمًا بتنزيله من إصدار GitHub.
يجب الإبلاغ عن المشكلات المتعلقة بالامتداد في مشروع PHPC في JIRA الخاص بـ MongoDB. يجب الإبلاغ عن المشكلات المتعلقة بالمكتبة في مشروع PHPLIB.
للأسئلة العامة وطلبات الدعم، يرجى استخدام إحدى قنوات الدعم الفني الخاصة بـ MongoDB.
إذا حددت ثغرة أمنية في برنامج التشغيل أو أي مشروع آخر في MongoDB، فيرجى الإبلاغ عنها وفقًا للتعليمات الواردة في إنشاء تقرير عن الثغرات الأمنية.
يتم تتبع التطوير في مشروع PHPC في JIRA الخاص بـ MongoDB. يمكن العثور على وثائق المساهمة في هذا المشروع في CONTRIBUTING.md.