yesccx/laravel-db-query

Laravel db query

v1.0.3 2023-06-09 02:09 UTC

This package is auto-updated.

Last update: 2024-10-09 05:23:09 UTC


README

Laravel 中便捷的进行原生 MYSQL 语句查询

For Laravel 5 Latest Stable Version Latest Unstable Version Total Downloads License

目录

安装

运行环境

通过Composer引入依赖包

通过终端进入项目根目录,执行以下命令引入依赖包:

> composer require yesccx/laravel-db-query:1.x

发布配置文件

如果需要额外配置,可选择 发布配置文件

> php artisan vendor:publish --tag=db-query-config

开始使用

DBQuery 查询

简单查询

将连接配置名传递给 connection 方法

连接配置通常来自 database.php 配置文件中的 connections

use Yesccx\DBQuery\DBQuery;

$data = DBQuery::connection('mysql')
    ->statement('select * from users where id = 1')
    ->get();

还可以直接传入连接配置( 目前仅支持 MYSQL 驱动

use Yesccx\DBQuery\DBQuery;

$data = DBQuery::connection([
        'driver' => 'mysql',
        'host' => '127.0.0.1'
        'username' => 'example',
        'password' => 'example',
        // ...
    ])
    ->statement('select * from users where id = 1')
    ->get();

模板查询

在语句中定义占位符后,可以使用链式方法如 whereselectgroup byorder by 等进行查询

use Yesccx\DBQuery\DBQuery;

$data = DBQuery::connection('mysql')
    ->statement('select * from users where @WHERE@')
    ->where('id', 1)
    ->get();


$data = DBQuery::connection('mysql')
    ->statement('select @COLUMNS@ from users where (@WHERE@) and deleted_at is null')
    ->select('id', 'name')
    ->where('id', 1)
    ->get();

目前支持的占位符:

查询缓存

默认情况下关闭查询缓存,可以通过配置 db-query.cache.enabled 进行开启,开启后传递给 cache 方法一个有效时间(单位秒)对查询结果进行缓存

通常情况下可以直接配置 env 中的 YDQ_CACHE_ENABLED 进行开启

use Yesccx\DBQuery\DBQuery;

$data = DBQuery::connection('mysql')
    ->statement('select * from users where @WHERE@')
    ->where('id', 1)
    // 将查询结果缓存60秒
    ->cache(60)
    ->get();

如果需要指定缓存驱动、前缀等,可以通过配置 db-query.cache.driver

更多查询方法

查询允许链式的使用 Laravel Illuminate\Database\Query\Builder 类中支持的方法,此外可以通过其它方法获取查询结果,参考 API章节

注意:不能使用 Illuminate\Database\Query\Builder 中的 getfirstfindpaginatecount 等方法

查询服务类

继承 DBQueryService,实现 connection 方法后在类中使用 statement 方法进行查询。这种方式能方便的组织和管理原生的查询语句

<?php

namespace App\Services;

use Yesccx\DBQuery\Supports\DBQueryService;

class PatientQueryService extends DBQueryService
{
    /**
     * Define connection config
     *
     * @return string|array connection name or connection config
     */
    protected function connection(): string|array
    {
        return 'mysql';
    }

    public function getList(): array
    {
        return $this->statement('select * from users where type = 1')
            ->get()
            ->toArray();
    }

    public function getUserInfo(int $id): mixed
    {
        return $this->statement('select * from users where @WHERE@')
            ->where('id', $id)
            ->cache(60)
            ->first();
    }

    public function getUserCount(): int
    {
        return $this->statement('select count(*) as count from users')
            ->cache(60)
            ->value('count', 0);
    }
}

API

Queries

get(): \Illuminate\Support\Collection

获取列表,结果是一个二维数组集合类

find(mixed $default = null): mixed

获取单条数据,结果是一个一维数组,类似 Illuminate\Database\Eloquent\Builder 中的 find 方法

first(mixed $default = null): mixed

find 方法的别名

value(string $column, mixed $default = null): mixed

获取第一行某一列的值

pluck(string $column): \Illuminate\Support\Collection

获取某一列

exists(): bool

判断是否存在数据

ENV

YDQ_CACHE_ENABLED

是否开启查询缓存,默认关闭

YDQ_CACHE_DRIVER

缓存驱动,默认与 cache.default 保持一致

使用建议

  • 建议将定义 查询服务类 统一存放在 app/QueryServices 目录下

License

MIT