███████╗ ██╗ ██╗███████╗ ...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)またはクエリビルダーパッケージは、MySQLクエリを構築するための軽量パッケージです。これは、SQLクエリの構築を簡素化するPHPパッケージです。 SQLクエリを構築するためのオブジェクト指向のアプローチを提供し、PHPアプリケーションでSQLステートメントを簡単に作成、変更、および実行できます。
Quebeeは、PHP依存関係マネージャーであるComposerを介してインストールできます。 Composerをまだインストールしていない場合は、指示についてComposerのWebサイトにアクセスしてください。
次のコマンドを実行して、Quebeeをインストールします。
composer require hindbiswas/quebeeComposerのAutoloaderがプロジェクトのPHPファイルに含まれていることを確認してください。 path/to/ :
require_once __DIR__ . DIRECTORY_SEPARATOR . ' path/to ' . ' /vendor/autoload.php ' ;Quebeeは、MySQLを使用するための次の機能を提供します。
QueryのSELECT 、 INSERT 、 UPDATE 、 DELETEクエリクラス。Tableクラスは、列用のColクラスとともにCREATE TABLE 。Colクラスには、要件に応じて列を作成するために、 INT 、 VARCHAR 、 DATETIMEなどの多くのデータ型があります。UNION 、 UNION ALL 、 CUBE 、 SET 、およびGROUPING SETSためのStmtクラスがステートメントを設定します。また、外部キーの制約、ユニーク、プライマリキー、インデックス、およびグループ化も含まれます。 QueBee使用するすべての可能な方法については、 /tests/ディレクトリを参照してください。
以下は、各クエリビルダーの使用方法の例です。
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 | ?? |
リテラルまたはシンボリックのいずれかを使用できます。
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');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';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';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()Col::varchar(225)Col::bit()Col::integer()Col::bigInt()Col::mediumInt()Col::smallInt()Col::tinyInt()Col::decimal(11, 6)Col::float(6, 2)Col::double(11, 6)Col::real(11, 6)Col::date()Col::dateTime() Quebeeを使用する際のベストプラクティスは次のとおりです。
サニタイズユーザー入力:クエリで使用する前に、ユーザー入力を常に消毒します。
エラー処理:特にクエリを構築する場合は、例外を適切に処理します。 Quebeeは、無効な入力またはメソッド呼び出しの例外をスローできます。
データベースの抽象化:より広範なデータベースインタラクションのために、Quebeeと一緒にデータベース抽象化レイヤーを使用することを検討してください。
コード組織:コードを論理的に整理し、クエリビルディングを実行と結果処理から分離します。
Quebeeは、PHPのSQLクエリ構造を簡素化し、クリーンで安全なデータベースインタラクションを簡単に構築できます。 Fluent APIを使用して、さまざまなデータベースシステムのSQLクエリを作成するためのユーザーフレンドリーな方法を提供します。
より詳細な使用法とカスタマイズオプションについては、Quebee Githubリポジトリを参照してください。
それでおしまい! PHPアプリケーションにSQLクエリを構築するためにQuebeeの使用を開始する準備ができました。