power lite pdo

باور لايت شركة تنمية نفط عمان

PowerLite PDO هي مكتبة PHP قوية وخفيفة الوزن توفر طريقة بسيطة وفعالة للتفاعل مع قواعد البيانات باستخدام كائنات بيانات PHP (PDO). وهو يدعم برامج تشغيل قاعدة بيانات متعددة ويتضمن ميزات مثل إدارة الاتصال السهلة وتنفيذ الاستعلام ومعالجة النتائج وترقيم الصفحات.

جدول المحتويات

• سمات
• متطلبات
• التوثيق
• تثبيت
• إعدادات
• الاستخدام/أمثلة
• تشغيل الاختبارات
• المساهمة
• رخصة

سمات

• الاتصالات الحاوية: تُستخدم الحاويات لتوصيل قاعدة البيانات الخاصة بك والتعامل مع التكوين والتبعيات بسلاسة.
• أساليب Db & QueryBuilder: تنفيذ استعلامات SQL واسترداد النتائج باستخدام أساليب Db أو QueryBuilder بطلاقة.
• معالجة فعالة للنتائج: جلب صف واحد، أو جميع الصفوف، أو قيمة عمود معين باستخدام طرق مخصصة.
• عمليات قاعدة البيانات الشاملة: توفر مجموعة واسعة من الأساليب لتفاعلات قاعدة البيانات المتنوعة.
• دعم ترقيم الصفحات: تعامل مع النتائج المرقّمة بسهولة باستخدام فئة ترقيم الصفحات.
• إدارة الأخطاء: معالجة سهلة الاستخدام لأخطاء واستثناءات قاعدة البيانات.
• وضع التصحيح: يوفر معلومات مفصلة حول الطلبات لأغراض تصحيح الأخطاء.
• البيانات المعدة: دعم البيانات المعدة لمنع هجمات حقن SQL.
• التحكم في المعاملات: إدارة معاملات قاعدة البيانات باستخدام طرق البدء والالتزام والتراجع.
• معايير جودة الكود العالية: يتبع الكود أفضل الممارسات ومعايير الترميز.

متطلبات

PHP ^7.4، PHP 8.x

التوثيق

تتوفر وثائق PowerLite PDO على موقع PowerLite PDO.

بالإضافة إلى التوثيق، PHPDoc متاح أيضًا هنا للحصول على معلومات أكثر تفصيلاً حول الفئات والطرق ومعلماتها.

تثبيت

استنساخ / تنزيل أو تثبيت باستخدام Composer

composer require migliori/power-lite-pdo

إعدادات

افتح src/connection.php في محرر التعليمات البرمجية الخاص بك واستبدل قيم الثابت بإعدادات اتصال قاعدة البيانات الخاصة بك (DB_HOST، DB_NAME، DB_USER، DB_PASS، DB_PORT، DB_CHARSET).

المخاوف الأمنية

لتعزيز الأمان، قم بتخزين الملف خارج جذر مستند خادم الويب الخاص بك (الدليل الذي يتم تقديمه إلى الإنترنت) وقم بتغيير المسار وفقًا لذلك في ملف التكوين ( src/config.php ). وهذا يمنع الملف من الوصول مباشرة عبر عنوان URL.

الاستخدام/أمثلة

حدد السجلات باستخدام فئة Db الرئيسية

1. قم بتضمين ملف التمهيد واحصل على مثيل Db من الحاوية:

    use Migliori  PowerLitePdo  Db ;
   
   // Build the container and connect to the database
   $ container = require_once __DIR__ . ' /vendor/migliori/power-lite-pdo/src/bootstrap.php ' ;
   $ db = $ container -> get (Db::class);

2. استخدم طريقة التحديد من فئة Db لتحديد بعض السجلات:

    $ from = ' users ' ; // The table name
   $ fields = [ ' id ' , ' username ' , ' email ' ]; // The columns you want to select
   $ where = [ ' status ' => ' active ' ]; // The conditions for the WHERE clause
   
   $ db -> select ( $ from , $ fields , $ where );

3. جلب السجلات المحددة واحدًا تلو الآخر:

    while ( $ record = $ db -> fetch ()) {
       echo $ record -> id . ' , ' . $ record -> username . ' , ' . $ record -> email . "n" ;
   }

حدد السجلات باستخدام QueryBuilder بطلاقة

1. قم بتضمين ملف التمهيد واحصل على مثيل QueryBuilder من الحاوية:

    use Migliori  PowerLitePdo  Query  QueryBuilder ;
   
   // Build the container and connect to the database
   $ container = require_once __DIR__ . ' /vendor/migliori/power-lite-pdo/src/bootstrap.php ' ;
   $ queryBuilder = $ container -> get (QueryBuilder::class);

2. استخدم QueryBuilder لتحديد بعض السجلات:

    $ queryBuilder -> select ([ ' id ' , ' username ' , ' email ' ])-> from ( ' users ' )-> where ([ ' status ' => ' active ' ])-> execute ();

3. جلب السجلات المحددة واحدًا تلو الآخر:

    while ( $ record = $ queryBuilder -> fetch ()) {
       echo $ record -> id . ' , ' . $ record -> username . ' , ' . $ record -> email . "n" ;
   }

حدد السجلات مع ترقيم الصفحات

1. قم بتضمين ملف bootstrap واحصل على مثيل Pagination من الحاوية:

    use Migliori  PowerLitePdo  Pagination ;
   
   // Build the container and connect to the database
   $ container = require_once __DIR__ . ' /vendor/migliori/power-lite-pdo/src/bootstrap.php ' ;
   $ pagination = $ container -> get (Pagination::class);

2. حدد بعض السجلات:

    $ from = ' users ' ; // The table name
   $ fields = [ ' id ' , ' username ' , ' email ' ]; // The columns you want to select
   $ where = [ ' status ' => ' active ' ]; // The conditions for the WHERE clause
   
   $ pagination -> select ( $ from , $ fields , $ where );

3. جلب السجلات المحددة واحدًا تلو الآخر:

    while ( $ record = $ pagination -> fetch ()) {
       echo $ record -> id . ' , ' . $ record -> username . ' , ' . $ record -> email . "n" ;
   }

4. عرض ترقيم الصفحات:

    $ url = ' /users ' ; // The URL for the pagination links
   echo $ pagination -> pagine ( $ url );

تشغيل الاختبارات

لإجراء الاختبارات، قم بتشغيل الأمر التالي

php ./vendor/bin/phpunit test 

التبعيات

• الملحن: أداة لإدارة التبعية لـ PHP.
• PHP-DI: حاوية حقن التبعية لـ PHP.
• PDO: ملحق PHP Data Objects للوصول إلى قواعد البيانات.
• برامج تشغيل قاعدة البيانات: برامج التشغيل المحددة لقواعد البيانات التي تريد الاتصال بها (على سبيل المثال، MySQL، وPostgreSQL، وOracle، وFirebird، ...).

تبعيات التطوير

• PHPUnit: إطار اختبار لوحدة اختبار كود PHP.
• PHPStan: أداة تحليل ثابتة تساعد في العثور على الأخطاء في كود PHP.
• PHP CodeSniffer: مجموعة من القواعد للتأكد من أن كود PHP يتبع معايير الترميز.

المساهمة

المساهمات هي دائما موضع ترحيب!

يرجى الاتصال بنا للحصول على أي اقتراحات للتحسين أو إرسال طلبات السحب الخاصة بك

رخصة

رخصة جنو العامة v3.0