Главная страница>Исходный код PHP>Другие категории
Скачать

Квеби: 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) или запросов - это легкий пакет для создания запросов MySQL. Это пакет PHP, который упрощает конструкцию запросов SQL. Он обеспечивает объектно-ориентированный подход к созданию запросов SQL, что облегчает создание, изменение и выполнение операторов SQL в ваших приложениях PHP.

Установка

1. Композитор

Квеби может быть установлен через Composer, PHP -диспетчер зависимостей. Если вы еще не установили композитор, посетите веб -сайт Composer для инструкций.

Запустите следующую команду для установки Quebee: 

composer require hindbiswas/quebee

2. Автопогрузка

Убедитесь, что автозагрузчик композитора включен в файлы 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 имеет кучу данных данных, таких как INT , VARCHAR , DATETIME и многое другое для создания столбцов в соответствии с вашими требованиями.
  4. Заявления: класс Stmt для 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

  • Нить
    • Text => 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)
    • Float => Col::float(6, 2)
    • Double => Col::double(11, 6)
    • Real => Col::real(11, 6)
  • Время
    • Date => Col::date()
    • Datetime => Col::dateTime()

Лучшие практики

Вот некоторые лучшие практики при использовании Quebee :

  1. Дезинфицировать входы пользователей: всегда дезинфицируйте входы пользователей, прежде чем использовать их в запросах.

  2. Обработка ошибок: обрабатывайте исключения надлежащим образом, особенно при строительстве запросов. Квеби может бросить исключения для неверного ввода или вызовов методов.

  3. Абстракция базы данных: рассмотрите возможность использования уровня абстракции базы данных вместе с Квеби для более обширных взаимодействий с базой данных.

  4. Кодовая организация: Организуйте свой код логически, отделяя построение запросов от выполнения и обработки результатов.

Заключение

Квеби упрощает конструкцию запросов SQL в PHP, облегчая строительство чистого, безопасного и эффективного взаимодействия с базами данных. Благодаря своему свободно API он предоставляет удобный способ создания SQL-запросов для различных систем баз данных.

Для получения более подробных вариантов использования и настройки см. В репозитории Quebee GitHub.

Вот и все! Вы готовы начать использовать Quebee для создания запросов SQL в ваших приложениях PHP.

Расширять
Дополнительная информация
Связанные приложения
Рекомендуем вам
Связанные новости Все