quebee

كيبي: منشئ استعلام PHP SQL

            ███████╗ ██╗   ██╗███████╗                               ...vvvv)))))).
            ██╔═══██╗██║   ██║██╔════╝    /~~               ,,,c(((((((((((((((((/
            ██║██╗██║██║   ██║█████╗     /~~c .         .vv)))))))))))))))))))``
            ███████╔╝██║   ██║██╔══╝         G_G__   ,,(((KKKK//////////////'
             ╚═██╔═╝ ╚██████╔╝███████╗     ,Z~__ '@,gW@@AKXX~MW,gmmmz==m_.
               ╚═╝    ╚═════╝ ╚══════╝    iP,dW@!,A@@@@@@@@@@@@@@@A` ,W@@Ac
            ██████╗ ███████╗███████╗       ]b_.__zf !P~@@@@@*P~b.~+=m@@@*~ g@Ws.
            ██╔══██╗██╔════╝██╔════╝          ~`    ,2W2m. '[ ['~~c'M7 _gW@@A`'s
            ██████╦╝█████╗  █████╗              v=XX)====Y-  [ [    c/*@@@*~ g@@i
            ██╔══██╗██╔══╝  ██╔══╝             /v~           !.!.     'c7+sg@@@@@s.
            ██████╦╝███████╗███████╗          //              'c'c       'c7*X7~~~~
            ╚═════╝ ╚══════╝╚══════╝         ]/                 ~=Xm_       '~=(Gm_.

مقدمة

حزمة Qᴜᴇᴇbᴇᴇ (QB) أو Builder هي حزمة خفيفة الوزن لبناء استعلامات MySQL. إنها حزمة PHP التي تبسط بناء استعلامات SQL. يوفر نهجًا موجهًا للكائنات لبناء استعلامات SQL ، مما يسهل إنشاء عبارات SQL وتعديلها وتنفيذها في تطبيقات PHP الخاصة بك.

تثبيت

1. الملحن

يمكن تثبيت Quebee عبر الملحن ، مدير التبعية PHP. إذا لم تكن قد قمت بتثبيت الملحن بعد ، تفضل بزيارة موقع Composer على التعليمات.

قم بتشغيل الأمر التالي لتثبيت كيبي:

composer require hindbiswas/quebee

2. التحميل التلقائي

تأكد من إدراج Autoloader الخاص بالملحن في ملفات PHP لمشروعك. استخدم طريقك بدلاً من path/to/ :

 require_once __DIR__ . DIRECTORY_SEPARATOR . ' path/to ' . ' /vendor/autoload.php ' ;

سمات

توفر كيبي الميزات التالية للعمل مع MySQL:

1. الاستعلامات: فئة Query SELECT INSERT UPDATE DELETE الاستعلامات.
2. الجدول: فئة Table CREATE TABLE مع فئة Col للأعمدة.
3. الأعمدة: يحتوي Col Class على مجموعة من أنواع البيانات مثل INT و VARCHAR و DATETIME وغيرها الكثير لإنشاء الأعمدة وفقًا لمتطلباتك.
4. البيانات: Stmt Class for UNION ، UNION ALL ، CUBE ، SET ، و GROUPING SETS .

ويشمل أيضًا قيود المفاتيح الخارجية والمفتاح الفريد والأساسي والفهرسة وكذلك التجميع. انظر /tests/ الدليل لجميع الطرق الممكنة لاستخدام QueBee ؛

الاستخدام

فيما يلي أمثلة على كيفية استخدام كل منشئ استعلام.

1. حدد الاستعلام

لإنشاء استعلام SELECT ، استخدم طريقة Query::select() :

 use Hindbiswas  QueBee  Query ;

$ aliased_cols = [ ' alias1 ' => ' column1 ' , ' alias2 ' => ' column2 ' , ' column3 ' => ' column3 ' ];
$ query = Query:: select ( $ aliased_cols )-> from ( ' table ' )-> build ();

// Resulting SQL query
// SELECT column1 AS alias1, column2 AS alias2, column3 AS column3 FROM table;

أو،

 use Hindbiswas  QueBee  Query ;

$ query = Query:: select ([ ' column1 ' , ' column2 ' ])
    -> from ( ' table ' )
    -> where ( ' column1 ' , ' value ' )
    -> orderBy ( ' column2 ' , ' desc ' )
    -> limit ( 10 )
    -> build ();

// Resulting SQL query
// SELECT column1, column2 FROM table WHERE column1 = 'value' ORDER BY column2 DESC LIMIT 0, 10; 

شرط الأسماء المستعارة للبيانات الشرطية

SQL	حرفي	رمزي
>	gt	>
>=	gte	>=
<	lt	<
<=	lte	<=
=	eq	== أو =
!=	ne	!= أو <>
<=>	ns	<=>
LIKE	like	??

يمكنك استخدام إما حرفي أو رمزي.

2. أدخل الاستعلامات

لإنشاء استعلام INSERT ، استخدم طريقة Query::insert() (لإدراج صفوف متعددة في وقت واحد ، استخدم Query::insertMultiple() ):

 use Hindbiswas  QueBee  Query ;

$ data = [ ' column1 ' => ' value1 ' , ' column2 ' => ' value2 ' ];

$ query = Query:: insert ( $ data )
    -> into ( ' table ' )
    -> build ();

// Resulting SQL query
// INSERT INTO table (column1, column2) VALUES ('value1', 'value2');

3. تحديث الاستعلامات

لإنشاء استعلام UPDATE ، استخدم طريقة Query::update() :

 use Hindbiswas  QueBee  Query ;

$ data = [ ' column1 ' => ' new_value1 ' , ' column2 ' => ' new_value2 ' ];

$ query = Query:: update ( ' table ' )
    -> set ( $ data )
    -> where ( ' column1 ' , ' value1 ' )
    -> build ();

// Resulting SQL query
// UPDATE table SET column1 = 'new_value1', column2 = 'new_value2' WHERE column1 = 'value1';

4. حذف الاستفسارات

لإنشاء استعلام DELETE ، استخدم طريقة Query::delete() :

 $ query = Query:: delete ( ' table ' )-> where ( ' column1 ' , 1 , ' gt ' )-> build () // Here `gt` is alias for `>`

// Resulting SQL query
// DELETE FROM table WHERE column1 > '1';

5. إنشاء استفسارات الجدول

لإنشاء استعلام CREATE TABLE ، استخدم Table::create() الطريقة:

بدون أي مفاتيح أجنبية

 use Hindbiswas  QueBee  Col ;
use Hindbiswas  QueBee  Table ;
use Hindbiswas  QueBee  Table  Values  DefaultVal ;

$ usersTable = Table:: create ( ' users ' )-> columns ([
    ' id ' => Col:: integer ( 11 )-> unsigned ()-> pk ()-> ai (),
    ' username ' => Col:: varchar ()-> unique (),
    ' email ' => Col:: varchar ()-> unique (),
    ' password ' => Col:: varchar (),
    ' is_superadmin ' => Col:: integer ( 2 )-> default ( ' 0 ' ),
    ' create_time ' => Col:: dateTime ()-> default (DefaultVal:: CURRENT_TIME ),
    ' update_time ' => Col:: dateTime ()-> setOnUpdate ()-> default (DefaultVal:: CURRENT_TIME ),
]);

$ query = $ usersTable -> build ();

// Resulting SQL query
// CREATE TABLE IF NOT EXISTS users (`id` INT(11) UNSIGNED NULL AUTO_INCREMENT, `username` VARCHAR(255) NOT NULL, `email` VARCHAR(255) NOT NULL, `password` VARCHAR(255) NOT NULL, `is_superadmin` INT(2) NOT NULL DEFAULT '0', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, `update_time` DATETIME on update CURRENT_TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, CONSTRAINT users_PK PRIMARY KEY (id), CONSTRAINT username_UC UNIQUE (`username`), CONSTRAINT email_UC UNIQUE (`email`)) ENGINE = InnoDB; 

مع المفاتيح الأجنبية

 use Hindbiswas  QueBee  Col ;
use Hindbiswas  QueBee  Table ;
use Hindbiswas  QueBee  Table  Values  DefaultVal ;
use Hindbiswas  QueBee  Table  Values  FK ;

// $usersTable = create a table to constrain with

$ table = Table:: create ( ' tokens ' )-> columns ([
    ' id ' => Col:: integer ()-> unsigned ()-> pk ()-> ai (),
    ' selector ' => Col:: varchar (),
    ' hashed_validator ' => Col:: varchar (),
    ' user_id ' => Col:: integer ( 11 )-> unsigned (),
    ' expiry ' => Col:: dateTime (),
])-> foreign ( ' user_id ' )-> onDelete ( FK :: CASCADE )-> reference ( $ usersTable , ' id ' );

// Resulting SQL query
// CREATE TABLE IF NOT EXISTS tokens (`id` INT UNSIGNED NULL AUTO_INCREMENT, `selector` VARCHAR(255) NOT NULL, `hashed_validator` VARCHAR(255) NOT NULL, `user_id` INT(11) UNSIGNED NOT NULL, `expiry` DATETIME NOT NULL, CONSTRAINT tokens_PK PRIMARY KEY (id), FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE) ENGINE = InnoDB; 

أنواع البيانات المتاحة اعتبارًا من v1.2.0

• خيط
  • نص => Col::text()
  • varchar => Col::varchar(225)
• رقمية
  • bit => Col::bit()
  • int => Col::integer()
  • bigint => Col::bigInt()
  • mediumint => Col::mediumInt()
  • smallint => Col::smallInt()
  • tinyint => Col::tinyInt()
  • عشري => Col::decimal(11, 6)
  • تعويم => Col::float(6, 2)
  • double => Col::double(11, 6)
  • real => Col::real(11, 6)
• وقت
  • التاريخ => Col::date()
  • DateTime => Col::dateTime()

أفضل الممارسات

فيما يلي بعض أفضل الممارسات عند استخدام كيبي :

1. تطهير مدخلات المستخدم: قم دائمًا بتطهير مدخلات المستخدم قبل استخدامها في الاستعلامات.

2. معالجة الخطأ: التعامل مع الاستثناءات بشكل مناسب ، خاصة عند بناء الاستعلامات. يمكن لـ Quebee إلقاء استثناءات للمكالمات غير صالحة للمدخلات أو الأسلوب.

3. تجريد قاعدة البيانات: فكر في استخدام طبقة تجريد قاعدة البيانات إلى جانب كيبي لمزيد من تفاعلات قاعدة البيانات شاملة.

4. تنظيم الكود: قم بتنظيم الكود الخاص بك بشكل منطقي ، وفصل بناء الاستعلام عن التنفيذ ومعالجة النتائج.

خاتمة

تقوم كيبي بتبسيط بناء استعلام SQL في PHP ، مما يسهل بناء تفاعلات قاعدة بيانات نظيفة وآمنة وفعالة. من خلال واجهة برمجة تطبيقات Fluent الخاصة به ، فإنه يوفر طريقة سهلة الاستخدام لإنشاء استعلامات SQL لأنظمة قاعدة البيانات المختلفة.

لمزيد من خيارات الاستخدام والتخصيص التفصيلية ، راجع مستودع كيبي جيثب.

هذا كل شيء! أنت مستعد للبدء في استخدام Quebee لبناء استعلامات SQL في تطبيقات PHP الخاصة بك.