UGRPM

ما هو UGRPM

UGRPM هو عبارة عن مكتبة بسيطة بلغة PHP تستخدم البرمجة الكائنية و تتعامل مع قواعد البيانات من نوع Mysql من خلال وجود اتصال عبر كائن PDO يتم تمريره إلى الباني في الصنف UGRPM.
يتم التعامل مع المستخدمين من خلال رقم id خاص بالمستخدم ولا يهم اسم الجدول أو الأعمدة الموجودة في جدول المستخدمين الذي تم إنشاؤه مسبقا.
تم بناء المكتبة من قبل سلام الجهني (https://aljehni.com).

الفكرة الأساسية

لنفترض ان لدينا مشروعا بلغة PHP ويحوي نظام مستخدمين، ونحن بحاجة لنمنح بعض المستخدمين إمكانية عمل أشياء معينة و بالمقابل مستخدمين آخرين لا نعطيهم تلك الصلاحيات.
المقصود هنا بعمل أشياء معينة هو بالضبط (إمكانية تنفيذ طريقة موجودة في صنف أي method in class).
هذه الصلاحية أي تنفيذ طريقة أو تابع موجود في صنف سنسميها وظيفة أو Role و نكتبها بالشكل: ClassNamespace@Method.
إعطاء كل مستخدم صلاحيات متنوعة عملية مرهقة بعض الشيء لذلك تضمنت المكتبة إمكانية إنشاء مجموعات و إضافة مستخدمين لهذه المجموعات و من ثم إعطاء وظائف للمجموعات ...
المستخدم سيكون لديه صلاحياته الخاصة التي أعطيت له و سيكون لديه صلاحيات المجموعات التي ينتمي إليها.
عند تنفيذ طريقة ما يمكننا التأكد أن للمستخدم الذي قام بطلبها صلاحيات تنفيذها أم لا.
UGRPM يعطيك الإمكانية لتنفيذ كل ما ذكر بالأعلى حيث يمكن إنشاء وظائف و مجموعات و إعطاء وظائف لمجموعات أو مستخدمين و إضافة مستخدمين لمجموعات و إزالتهم و عرض وظائف مجموعة أو مستخدم و عرض المجموعات و المستخدمين الذين لهم وظيفة ما و غير ذلك...

التنصيب

1- استخدم composer لإضافة UGRPM إلى مشروعك.
composer require jsalam/ugrpm
2- المسار vendor/jsalam/ugrpm يحوي مسار اسمه sql يحتوي على ملف tables.sql, قم باستيراده إلى قاعدة بياناتك.
3- لاستخدام UGRPM يجب استدعاء بواسطة use UGRPM الصنف و حسب الحاجة الأصناف Role و Group:
use Jsalam\UGRPM\{UGRPM,Group,Role};
4- لإنشاء كائن من نوع UGRPM استخدم
$ugrpm = new UGRPM($connect);
حيث $connect هو كائن PDO للاتصال بقاعدة البيانات لديك.
الآن, على سبيل المثال يمكن إنشاء مجموعة في قاعدةالبيانات بالأمر::
$group = $ugrpm->createGroup(new Group(groupName:"Editors",description:"Editors Group"));
الخ ...

المراجعات

Github رابط: https://github.com/salamj/ugrpm
تواصل معي عبر البريد: salamj[at]gmail.com

حقوق النشر و الملكية

المؤلف: سلام الجهني (aljehni.com)
هذه المكتبة منشورة مجانا برخصة MIT الترخيص.