PHP للمطور - معمو — الصفحة ٦١٣

14 : البروتوكول LDAP التابع ()ldap_get_values 613 array ldap_get_value (int link_identifier, int result_entry_identifier, string attribute) يستخدم هذا التابع لقراءة جميع قيم السمة في الإدخال من النتائج. يحدد الإدخال باستخدام الوسيط result_entry_identifier. ويخزن عدد قيم الإدخال في أحد أدلة المصفوفة الناتجة ويدعى count. ويتم الوصول إلى القيم الفردية بواسطة دليل صحيح (integer) في المصفوفة، ويكون الدليل الأول بالقيمة .. يتطلب هذا الاستدعاء الوسيط result_entry_identifier كما يجب أن يتبع هذا الوسيط بأحد استدعاءات البحث في LDAP، وباستدعاء آخر للحصول على إدخال فردي. يجب أن يكون تطبيقك متين السبك حتى يتمكن من البحث عن سمات معينة مثل sumame أو mail)، أو سيكون عليك استخدام التابع ()ldap_get_attributes لمعرفة السمات الموجودة في إدخال LDAP بأن يكون لأكثر من إدخال السمة نفسها، وبذلك يستطيع مثلاً تخزين من عناوين البريد الإلكتروني لإدخال دليل شخص وحيد، وبأن تكون جميعها تابعة معطى. يسمح عدد للسمة mail . التابع ()ldap_list int ldap_list (int link_identifier, string base_dn, string filter [, array attributes [, int attrsonly [, int sizelimit [, int timelimit [, int deref]]]]]) عندما نقوم ببحث ما نحتاج إلى تعيين قاعدة الشجرة التي سيبدأ عندها البحث، وكذلك إلى مجال تغطية البحث. يشير مجال التغطية إلى جزء الشجرة الذي سيتم تغطيته أثناء البحث. يقوم التابع ()ldap_list بالبحث على الدليل تبعاً لمرشح محدد وفي مجال تغطية معين، أي LDAP SCOPE_ONELEVEL. وبالتالي، يجب أن يعيد البحث فقط المعلومات التي تقع في المستوى الذي يلي مباشرة القاعدة DN المعطاة في الاستدعاء ما يكافئ كتابة Is في قشرة UNIX، والحصول بالتالي على قائمة الملفات والمجلدات في دليل العمل الحالي. يأخذ هذا الاستدعاء وسيطاً رابعاً اختيارياً، والذي تمثله مصفوفة بالسمات المطلوبة فقط. أما الوسائط الجديدة: attrsonly و timelimit و size limit و deref فتقوم بالوظيفة نفسها التي تؤديها في التابعين ( )lda_search و ldap_read. يعيد هذا التابع معرف نتائج عند نجاحه، أو false عند وقوع أي خطأ.
ص ٦١٣

النص مستخرج آليًّا من صور الكتاب، وقد يقع فيه خطأ.