توفر هذه المكتبة تجريدًا عالي المستوى حول برنامج تشغيل PHP ذي المستوى الأدنى (امتداد mongodb ).
في حين أن الامتداد يوفر واجهة برمجة تطبيقات محدودة لتنفيذ الأوامر والاستعلامات وعمليات الكتابة، فإن هذه المكتبة تنفذ واجهة برمجة تطبيقات كاملة الميزات مماثلة لتلك الخاصة ببرامج تشغيل MongoDB الأخرى. ويحتوي على تجريدات للعميل وقاعدة البيانات وكائنات المجموعة، ويوفر طرقًا لعمليات CRUD والأوامر الشائعة (مثل إدارة الفهرس والمجموعات).
إذا كنت تقوم بتطوير تطبيق باستخدام MongoDB، فيجب عليك التفكير في استخدام هذه المكتبة، أو أي تجريد آخر عالي المستوى، بدلاً من الامتداد وحده.
يمكن العثور على معلومات إضافية حول بنية هذه المكتبة وامتداد mongodb في نظرة عامة على الهندسة المعمارية.
الطريقة المفضلة لتثبيت هذه المكتبة هي باستخدام Composer عن طريق تشغيل ما يلي من جذر المشروع الخاص بك:
$ composer require mongodb/mongodb
يمكن العثور على تعليمات التثبيت الإضافية في وثائق المكتبة.
نظرًا لأن هذه المكتبة عبارة عن تجريد عالي المستوى لبرنامج التشغيل، فإنها تتطلب أيضًا تثبيت ملحق mongodb :
$ pecl install mongodb
$ echo "extension=mongodb.so" >> `php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||"`
يمكن العثور على تعليمات التثبيت الإضافية للامتداد في وثائق PHP.net الخاصة به.
يتم إنشاء الإصدارات تلقائيًا ويتم توقيع علامة الإصدار الناتجة باستخدام مفتاح GPG الخاص بفريق PHP. للتحقق من توقيع العلامة، قم بتنزيل المفتاح واستيراده باستخدام gpg :
gpg --import php-driver.asc ثم، في نسخة محلية، تحقق من توقيع علامة معينة (على سبيل المثال 1.19.0 ):
git show --show-signature 1.19.0ملحوظة
لا يدعم Composer التحقق من التوقيعات كجزء من عملية التثبيت الخاصة به.
يجب الإبلاغ عن المشكلات المتعلقة بالمكتبة في مشروع PHPLIB في JIRA الخاص بـ MongoDB. يجب الإبلاغ عن المشكلات المتعلقة بالامتداد في مشروع PHPC.
للأسئلة العامة وطلبات الدعم، يرجى استخدام إحدى قنوات الدعم الفني في MongoDB.
إذا حددت ثغرة أمنية في برنامج التشغيل أو أي مشروع آخر في MongoDB، فيرجى الإبلاغ عنها وفقًا للتعليمات الواردة في إنشاء تقرير عن الثغرات الأمنية.
يتم تتبع التطوير في مشروع PHPLIB في JIRA الخاص بـ MongoDB. يمكن العثور على وثائق المساهمة في هذا المشروع في CONTRIBUTING.md.