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