power lite pdo

PowerLite PDO

PowerLite PDO 是一個輕量級、功能強大的 PHP 函式庫，它提供了一種使用 PHP 資料物件 (PDO) 與資料庫互動的簡單而有效的方法。它支援多個資料庫驅動程序，並包括輕鬆連接管理、查詢執行、結果處理和分頁等功能。

目錄

• 特徵
• 要求
• 文件
• 安裝
• 配置
• 用法/範例
• 運行測試
• 貢獻
• 執照

特徵

• 容器化連接：容器用於連接資料庫並無縫處理配置和依賴項。
• Db 和 QueryBuilder 方法：使用 Db 方法或流暢的 QueryBuilder 執行 SQL 查詢並檢索結果。
• 高效率的結果處理：使用專用方法取得單行、所有行或特定列的值。
• 全面的資料庫操作：提供多種資料庫互動方法。
• 分頁支援：使用 Pagination 類別輕鬆處理分頁結果。
• 錯誤管理：使用者友善地處理資料庫錯誤和異常。
• 調試模式：提供有關調試目的請求的詳細資訊。
• 準備語句：支援準備語句以防止 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）。

安全問題

為了增強安全性，請將檔案儲存在 Web 伺服器的文件根目錄（提供給 Internet 的目錄）之外，並在設定檔 ( 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 類別中的 select 方法選擇一些記錄：

    $ 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. 包含引導檔案並從容器中取得 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 

依賴關係

• Composer： PHP 的依賴管理工具。
• PHP-DI： PHP 的依賴注入容器。
• PDO：用於存取資料庫的 PHP 資料物件擴充。
• 資料庫驅動程式：您要連接的資料庫的特定驅動程式（例如，MySQL、PostgreSQL、Oracle、Firebird...）。

開發依賴

• PHPUnit：用於單元測試 PHP 程式碼的測試框架。
• PHPStan：一個靜態分析工具，有助於找出 PHP 程式碼中的錯誤。
• PHP CodeSniffer：一組確保 PHP 程式碼遵循程式設計標準的規則。

貢獻

隨時歡迎您的貢獻！

請聯絡我們以取得任何改進建議或發送您的拉取請求

執照

GNU 通用公共授權 v3.0