power lite pdo

PowerLite ПДО

PowerLite PDO — это легкая и мощная библиотека PHP, которая обеспечивает простой и эффективный способ взаимодействия с базами данных с использованием объектов данных PHP (PDO). Он поддерживает несколько драйверов баз данных и включает в себя такие функции, как простое управление соединениями, выполнение запросов, обработку результатов и разбиение на страницы.

Оглавление

• Функции
• Требования
• Документация
• Установка
• Конфигурация
• Использование/Примеры
• Запуск тестов
• Содействие
• Лицензия

Функции

• Контейнерные соединения. Контейнеры используются для подключения вашей базы данных и беспрепятственной обработки конфигурации и зависимостей.
• Методы Db и QueryBuilder: выполнение SQL-запросов и получение результатов с помощью методов Db или свободного QueryBuilder.
• Эффективная обработка результатов: извлекайте одну строку, все строки или значение определенного столбца с помощью специальных методов.
• Комплексные операции с базами данных: предоставляет широкий спектр методов для разнообразного взаимодействия с базой данных.
• Поддержка разбивки на страницы: легко обрабатывайте результаты с разбивкой на страницы с помощью класса 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).

Проблемы безопасности

Для повышения безопасности сохраните файл за пределами корня документа вашего веб-сервера (каталога, который обслуживается в Интернете) и соответствующим образом измените путь в файле конфигурации ( 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. Используйте метод select из класса 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. Включите файл начальной загрузки и получите экземпляр 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