PHPackages                             yesccx/better-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. yesccx/better-laravel

ActiveLibrary[Framework](/categories/framework)

yesccx/better-laravel
=====================

Better Laravel

v1.1.1(1y ago)37.3kMITPHPPHP ^8.1.0

Since Apr 2Pushed 1y ago1 watchersCompare

[ Source](https://github.com/yesccx/better-laravel)[ Packagist](https://packagist.org/packages/yesccx/better-laravel)[ Docs](https://github.com/yesccx/better-laravel)[ RSS](/packages/yesccx-better-laravel/feed)WikiDiscussions 1.x Synced 1mo ago

READMEChangelogDependencies (1)Versions (12)Used By (0)

Better-Laravel
==============

[](#better-laravel)

基于PHP8.1，适用于Laravel框架进行快速开发的工具包

[![For Laravel 5](https://camo.githubusercontent.com/6f68f16ce18e7468ec2bf463ae6b902dc2e186030d484981174dcb8e7981a5f1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d392e2a2d677265656e2e737667)](https://github.com/yesccx/better-laravel)[![Latest Stable Version](https://camo.githubusercontent.com/02fc2b9be5106e5565b8f590e1a87a3eb70a361cb03a4a5681d9303bf2999fd3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7965736363782f6265747465722d6c61726176656c2e737667)](https://packagist.org/packages/yesccx/better-laravel)[![Latest Unstable Version](https://camo.githubusercontent.com/7395994d6ed87b315c0c996d809e7653cfb3ba037460abe536d1c4598ea40348/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f767072652f7965736363782f6265747465722d6c61726176656c2e737667)](https://packagist.org/packages/yesccx/better-laravel)[![Total Downloads](https://camo.githubusercontent.com/c7da4f6aedecfe7ff1983f64d24b4b547c21fa8d66088a4088974375545f4d31/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7965736363782f6265747465722d6c61726176656c2e7376673f6d61784167653d32353932303030)](https://packagist.org/packages/yesccx/better-laravel)[![License](https://camo.githubusercontent.com/5d51ade7e230f9f6e250453f96ffba3d8e9cb80da093f5b4646d88aa9317f72a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7965736363782f6265747465722d6c61726176656c2e7376673f6d61784167653d32353932303030)](https://packagist.org/packages/yesccx/better-laravel)

目录
==

[](#目录)

- [目录](#%E7%9B%AE%E5%BD%95)
- [安装](#%E5%AE%89%E8%A3%85)
    - [运行环境](#%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83)
    - [通过Composer引入依赖包](#%E9%80%9A%E8%BF%87composer%E5%BC%95%E5%85%A5%E4%BE%9D%E8%B5%96%E5%8C%85)
    - [初始化安装](#%E5%88%9D%E5%A7%8B%E5%8C%96%E5%AE%89%E8%A3%85)
    - [定义异常处理](#%E5%AE%9A%E4%B9%89%E5%BC%82%E5%B8%B8%E5%A4%84%E7%90%86)
- [基础功能](#%E5%9F%BA%E7%A1%80%E5%8A%9F%E8%83%BD)
    - [路由](#%E8%B7%AF%E7%94%B1)
        - [ping接口`](#ping%E6%8E%A5%E5%8F%A3)
        - [模块路由](#%E6%A8%A1%E5%9D%97%E8%B7%AF%E7%94%B1)
    - [命令行](#%E5%91%BD%E4%BB%A4%E8%A1%8C)
        - [迁移文件转换为DDL语句](#%E8%BF%81%E7%A7%BB%E6%96%87%E4%BB%B6%E8%BD%AC%E6%8D%A2%E4%B8%BAddl%E8%AF%AD%E5%8F%A5)
        - [Laravel部署优化](#laravel%E9%83%A8%E7%BD%B2%E4%BC%98%E5%8C%96)
    - [异常处理](#%E5%BC%82%E5%B8%B8%E5%A4%84%E7%90%86)
    - [Traits](#traits)
        - [InstanceMake](#instancemake)
            - [Class::make](#classmake)
            - [Class::resolve](#classresolve)
            - [Class::instance](#classinstance)
        - [InitializeTraits](#initializetraits)
        - [WithRescue](#withrescue)
    - [BaseService](#baseservice)
    - [辅助方法](#%E8%BE%85%E5%8A%A9%E6%96%B9%E6%B3%95)
        - [dumps](#dumps)
        - [dds](#dds)
        - [explode\_str\_array](#explode_str_array)
- [数据库](#%E6%95%B0%E6%8D%AE%E5%BA%93)
    - [分页查询](#%E5%88%86%E9%A1%B5%E6%9F%A5%E8%AF%A2)
        - [普通分页查询](#%E6%99%AE%E9%80%9A%E5%88%86%E9%A1%B5%E6%9F%A5%E8%AF%A2)
        - [简单分页查询](#%E7%AE%80%E5%8D%95%E5%88%86%E9%A1%B5%E6%9F%A5%E8%AF%A2)
        - [自定义分页数据](#%E8%87%AA%E5%AE%9A%E4%B9%89%E5%88%86%E9%A1%B5%E6%95%B0%E6%8D%AE)
        - [空分页](#%E7%A9%BA%E5%88%86%E9%A1%B5)
    - [Builder查询](#builder%E6%9F%A5%E8%AF%A2)
        - [customPaginate](#custompaginate)
        - [customSimplePaginate](#customsimplepaginate)
        - [whereLike](#wherelike)
        - [whenLike](#whenlike)
        - [whereToday](#wheretoday)
        - [whereThisDay](#wherethisday)
        - [whereInDay](#whereinday)
        - [whereThisWeek](#wherethisweek)
        - [whereThisMonth](#wherethismonth)
        - [whereInMonth](#whereinmonth)
        - [whereThisYear](#wherethisyear)
        - [whereInYear](#whereinyear)
        - [whereGtDate](#wheregtdate)
        - [whereGteDate](#wheregtedate)
        - [whereLtDate](#whereltdate)
        - [whereLteDate](#whereltedate)
        - [whereBetweenDate](#wherebetweendate)
        - [非严格格式查询](#%E9%9D%9E%E4%B8%A5%E6%A0%BC%E6%A0%BC%E5%BC%8F%E6%9F%A5%E8%AF%A2)
- [HTTP](#http)
    - [请求响应(Responser)](#%E8%AF%B7%E6%B1%82%E5%93%8D%E5%BA%94responser)
        - [responseSuccess](#responsesuccess)
        - [responseError](#responseerror)
        - [responseData](#responsedata)
        - [responseException](#responseexception)
    - [控制器基类](#%E6%8E%A7%E5%88%B6%E5%99%A8%E5%9F%BA%E7%B1%BB)
        - [接口响应(Response)](#%E6%8E%A5%E5%8F%A3%E5%93%8D%E5%BA%94response)
        - [入参类型转换(TypeTransfrom)](#%E5%85%A5%E5%8F%82%E7%B1%BB%E5%9E%8B%E8%BD%AC%E6%8D%A2typetransfrom)
    - [表单验证](#%E8%A1%A8%E5%8D%95%E9%AA%8C%E8%AF%81)
        - [表单验证基类](#%E8%A1%A8%E5%8D%95%E9%AA%8C%E8%AF%81%E5%9F%BA%E7%B1%BB)
        - [验证场景](#%E9%AA%8C%E8%AF%81%E5%9C%BA%E6%99%AF)
    - [验证规则](#%E9%AA%8C%E8%AF%81%E8%A7%84%E5%88%99)
        - [ArrayIdsRule](#arrayidsrule)
        - [Base64Rule](#base64rule)
        - [IdCardRule](#idcardrule)
        - [LandlinePhoneRule](#landlinephonerule)
        - [PhoneRule](#phonerule)
        - [StringArrayIdsRule](#stringarrayidsrule)
        - [SubManyRequestRule](#submanyrequestrule)
        - [SubRequestRule](#subrequestrule)
- [工具类](#%E5%B7%A5%E5%85%B7%E7%B1%BB)
    - [运行环境检测](#%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%E6%A3%80%E6%B5%8B)
        - [Environment](#environment)
            - [verified](#verified)
            - [notVerified](#notverified)
            - [when](#when)
            - [whenNot](#whennot)
            - [wrapStr](#wrapstr)
        - [助手函数](#%E5%8A%A9%E6%89%8B%E5%87%BD%E6%95%B0)
- [配置项](#%E9%85%8D%E7%BD%AE%E9%A1%B9)
    - [date\_format](#date_format)
    - [http.route\_scanning](#httproute_scanning)
    - [http.message\_body\_map](#httpmessage_body_map)
- [使用建议](#%E4%BD%BF%E7%94%A8%E5%BB%BA%E8%AE%AE)
- [License](#license)

安装
==

[](#安装)

运行环境
----

[](#运行环境)

运行环境要求PHP ^8.1.0Laravel Framework ^9.0通过Composer引入依赖包
---------------

[](#通过composer引入依赖包)

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

```
> composer require yesccx/better-laravel:1.x
```

初始化安装
-----

[](#初始化安装)

`Better-Laravel` 支持一系列配置参数，如 `默认时间格式` 等，更多配置项参考[配置项](#%E9%85%8D%E7%BD%AE%E9%A1%B9)章节，通过以下命令进行初始化安装操作：

```
> php artisan better-laravel:install
```

> 初始化之后会默认引入使用服务提供者 `App\Providers\BetterLaravelProvider`，后续可在该提供者内部做更多的定制化处理。

定义异常处理
------

[](#定义异常处理)

当需要使用 `Better-Laravel` 中的异常处理逻辑，仅需在 `\App\Exceptions\Handler@register` 中调用 `\Yesccx\BetterLaravel\Exceptions\ExceptionHandlerManager::register` 即可：

```
