PHPackages chowjiawei/laravel-help-plugin - 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. [Utility & Helpers](/categories/utility) 4. / 5. chowjiawei/laravel-help-plugin ActiveLibrary[Utility & Helpers](/categories/utility) chowjiawei/laravel-help-plugin ============================== Integrating useful auxiliary functions into laravel,Assistant tools based on laravel. v1.6.2(3y ago)671.6k↑116.7%5MITPHPPHP ^7.0|^8.0 Since Sep 29Pushed 3y ago2 watchersCompare [ Source](https://github.com/chowjiawei/laravel-help-plugin)[ Packagist](https://packagist.org/packages/chowjiawei/laravel-help-plugin)[ Docs](https://github.com/chowjiawei/laravel-help-plugin)[ RSS](/packages/chowjiawei-laravel-help-plugin/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (5)Versions (6)Used By (0) - 通知发送（包括但不限于以下频道【更多待接入】） - - 钉钉机器人 - - 企业微信机器人 - - 微信模板消息 - - 飞书机器人 - 威妥码拼音互转获取 - 汇率实时互转获取（Openexchangerates Api） - 全球城市中英互转获取 及更新 - 抖音新交易系统 （非旧交易系统 目前旧交易系统已经被官方废弃 ，正在更新） 本包将持续更新！请详细文档托管 如发现bug 请直接提issue或者直接提pr，造成的不便请谅解。 Laravel辅助工具包 ============ [](#laravel辅助工具包) [![](https://camo.githubusercontent.com/e891a8ab259ed47b00360ac8b893c480bd43a03f239a30e53c9574236fececd0/68747470733a2f2f706f7365722e707567782e6f72672f63686f776a69617765692f6c61726176656c2d68656c702d706c7567696e2f762f737461626c65)](https://packagist.org/packages/chowjiawei/laravel-help-plugin) [![](https://camo.githubusercontent.com/3f4dd2e9246066b91fa7b207ea327d0ccb9504f1622907ce37200aca36099af0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d372e302b2d3539613966382e7376673f7374796c653d666c6174)](https://camo.githubusercontent.com/3f4dd2e9246066b91fa7b207ea327d0ccb9504f1622907ce37200aca36099af0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d372e302b2d3539613966382e7376673f7374796c653d666c6174) [![](https://camo.githubusercontent.com/4bcaafd1dd6d90f4ae10c6e041984c30a37f49229319a91da2519ee2bb40dcc5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d352e352b2d3539613966382e7376673f7374796c653d666c6174)](https://camo.githubusercontent.com/4bcaafd1dd6d90f4ae10c6e041984c30a37f49229319a91da2519ee2bb40dcc5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d352e352b2d3539613966382e7376673f7374796c653d666c6174) #### 目录 [](#目录) - [安装说明](#composer) - [发布配置文件](#config) - [注册门面方法](#facade) - [消息驱动](#channel) - [钉钉机器人](#dingtalk) - [企业微信机器人](#wechat) - [微信模板消息](#wechatTemp) - [直接消息推送](#usem) - [钉钉机器人](#usedingtalk) - [企业微信机器人](#usewechat) - [微信模板消息](#usewechatTemp) - [Artisan命令示例](#artisan) - [国家获取转换](#country) - [Openexchangerates汇率实时获取](#openexchangerates) - [扩展Artisan命令](#extend) - [代码生成器](#generate) - [钉钉Notification模板生成](#generateDingtalk) - [企业微信Notification模板生成](#generateWechat) - [微信模板消息Notification模板生成](#generateWechat) - [威妥码互转汉语拼音-移步详细文档查看](#pinyin) - [抖音新交易系统](#tiktokPay) JetBrains 支持的项目 --------------- [](#jetbrains-支持的项目) 非常感谢 Jetbrains 为我提供了从事这个和其他开源项目的许可。 [![](https://camo.githubusercontent.com/3cf726e7cdadba47755b7f7ea4227945a92a2fa48aadf4a2573140ec6501c989/68747470733a2f2f7265736f75726365732e6a6574627261696e732e636f6d2f73746f726167652f70726f64756374732f636f6d70616e792f6272616e642f6c6f676f732f6a625f6265616d2e737667)](https://www.jetbrains.com/?from=https://github.com/overtrue) 安装说明 ==== [](#安装说明) 环境要求 本包依托于Laravel框架，其他框架暂不适用 - php => ^7.0 - guzzlehttp/guzzle => ^6.3" - laravel/framework => ~5.5|~6.0|~7.0|~8.0|~9.0 - overtrue/laravel-wechat => ~5.0 使用composer安装 `composer require chowjiawei/laravel-help-plugin` 发布配置文件 ====== [](#发布配置文件) - 使用工具包请运行Artisan命令 `php artisan vendor:publish --provider="Chowjiawei\Helpers\Providers\HelpPluginServiceProvider"` - 如若使用微信模板消息则需要发布easywechat配置，本包默认内置easywechat: `php artisan vendor:publish --provider="Overtrue\LaravelWeChat\ServiceProvider"`微信包的配置 按需填写 公共号配置 `official_account` 配置省略 注册facade ======== [](#注册facade) 本报提供laravel Facade便捷，如需使用可按如下配置 打开`config/app.php` 找到 `providers` 项添加 ``` \Chowjiawei\Helpers\Providers\HelpPluginServiceProvider::class, ``` 找到 'aliases'添加 ``` 'Helper'=>\Chowjiawei\Helpers\Facade\Helper::class ``` 消息驱动 ==== [](#消息驱动) - [钉钉机器人](#dingtalk) - [企业微信机器人](#wechat) - [微信模板消息](#wechatTemp) - [飞书机器人](#lark) 钉钉机器人消息发送驱动 ----------- [](#钉钉机器人消息发送驱动) ``` use Chowjiawei\Helpers\Channels\DingtalkRobotChannel; public function via($notifiable) { return [DingtalkRobotChannel::class]; } ``` 微信机器人消息发送驱动 ----------- [](#微信机器人消息发送驱动) ``` use Chowjiawei\Helpers\Channels\WechatRobotChannel; public function via($notifiable) { return [WechatRobotChannel::class]; } ``` 微信模板消息发送驱动 ---------- [](#微信模板消息发送驱动) 该驱动支持单用户发送和广播功能 ``` use Chowjiawei\Helpers\Channels\WechatTemplateMessageChannel; public function via($notifiable) { return [WechatTemplateMessageChannel::class]; } ``` ``` Notification::route('dingtalk_robot', $key)->notify(new YourNotification()); Notification::route('wechat_robot', $key)->notify(new YourNotification()); Notification::route('Wechat_template_message', $key)->notify(new YourNotification()); ``` 飞书机器人消息发送驱动 ----------- [](#飞书机器人消息发送驱动) ``` use Chowjiawei\Helpers\Channels\DingtalkRobotChannel; public function via($notifiable) { return [DingtalkRobotChannel::class]; } ``` 直接消息推送 ====== [](#直接消息推送) - [钉钉机器人](#usedingtalk) - [企业微信机器人](#usewechat) - [微信模板消息](#usewechatTemp) - [飞书机器人](#uselark) ### 钉钉: [](#钉钉) `use Chowjiawei\Helpers\Notifications\DingtalkRobotNotification;` `Notification::route('dingtalk_robot', env("DINGTALK_ROBOT")) ->notify(new DingtalkRobotNotification($message,$title));` ### 企业微信: [](#企业微信) `use Chowjiawei\Helpers\Notifications\WechatRobotNotification;` `Notification::route('wechat_robot', env("WECHAT_ROBOT)")) ->notify(new WechatRobotNotification($message));` ### 微信模板消息: [](#微信模板消息) `use Chowjiawei\Helpers\Notifications\WechatTemplateMessageNotification;` - 不指定用户（广播用户） `Notification::route('WechatTemplateMessage', null)->notify(new WechatTemplateMessageNotification($data));` - 指定用户 ``` $user=['odAYnxOVy7vS266666666','odAYnxEuuTCf66666fov276666']; $template="iA2V1K45vS8IgUEvE666666EH3R-V-66666"; $data=[ "order_id"=>[ "value"=>"20200414234478934343", "color"=>"#173177" ], "package_id"=>[ "value"=>"SF4345454534", "color"=>"#173177" ], "remark"=>[ "value"=>'模板消息发送', "color"=>"#173177" ] ]; Notification::route('WechatTemplateMessage', $user)->notify(new WechatTemplateMessageNotification($data, $template)); ``` ### 飞书: [](#飞书) `use Chowjiawei\Helpers\Notifications\LarkRobotNotification;` `Notification::route('lark', env("LARK_ROBOT")) ->notify(new DingtalkRobotNotification($message));` ### Artisan命令示例: [](#artisan命令示例) 由于业务不同，工具默认提供了通知Notification模板，可以通过extend Artisan命令选择代码生成器生成 国家获取转换 ====== [](#国家获取转换) ``` use Chowjiawei\Helpers\PhpHelps\LaravelHelp; 初始化辅助工具 $help=new LaravelHelp(); 获取所有国家 $help->getAllCountry(); 根据国家代码转国家名字 $help->getCountryName('CN'); 根据国家名字转国家代码 $help->getCountryName('China'); ``` or 还有更多可以下载包后体验哦 ``` Helper::allCountry(); ``` Openexchangerates汇率实时获取 ======================= [](#openexchangerates汇率实时获取) ``` use Chowjiawei\Helpers\Exchange\Exchange; //获取实时汇率 $help->getChangerates(); ``` 将为您返回完整的汇率及接口信息，以下省略篇幅 ``` { "disclaimer": "Usage subject to terms: https://openexchangerates.org/terms", "license": "https://openexchangerates.org/license", "timestamp": 1622097300, "base": "USD", "rates": { "AED": 3.6731, "AFN": 79.130257, "ALL": 101.073262, "AMD": 520.828816, "ANG": 1.796011, "AOA": 643.121, "ARS": 94.4963, "AUD": 1.291358, "AWG": 1.8, "AZN": 1.700805, "BAM": 1.604705, "BBD": 2, "BDT": 85.048855, "BGN": 1.601902, "BHD": 0.377012, "BIF": 1974.680206, ``` ``` use Chowjiawei\Helpers\Exchange\Exchange; //获取特定汇率 $help->getSymbolChangerates(['GBP','EUR','AED','CAD']); ``` 将为您返回指定的汇率及接口信息 ``` { disclaimer: "https://openexchangerates.org/terms/", license: "https://openexchangerates.org/license/", "timestamp": 1424127600, "base": "USD", "rates": { "AED": 3.67295, "CAD": 0.99075, "EUR": 0.793903, "GBP": 0.62885 } } ``` 扩展Artisan命令 =========== [](#扩展artisan命令) 插件为您提供了一个支持中文和英文的扩展命令，您可以用命令呼出，命令提供了以下功能 `php artisan extend --chinese `中文 `php artisan extend `英文 - [钉钉Notification模板生成](#generateDingtalk) - [企业微信Notification模板生成](#generateWechat) - [微信模板消息Notification模板生成](#generateWechat) 威妥码拼音 ----- [](#威妥码拼音) 单汉语拼音转威妥码拼音 ``` Helper::changeHWWord("zhou"); ``` [![汉语拼音转威妥码拼音](https://camo.githubusercontent.com/5be0904f6e2598aed0dfe97fa48e055a3d3e3806e3d3772d6a3015eec7aed2e5/68747470733a2f2f63646e2e6c6561726e6b752e636f6d2f75706c6f6164732f696d616765732f3230323130382f31322f36313139352f6b36636f51355861756a2e706e67216c61726765)](https://camo.githubusercontent.com/5be0904f6e2598aed0dfe97fa48e055a3d3e3806e3d3772d6a3015eec7aed2e5/68747470733a2f2f63646e2e6c6561726e6b752e636f6d2f75706c6f6164732f696d616765732f3230323130382f31322f36313139352f6b36636f51355861756a2e706e67216c61726765) 长句汉语拼音转威妥码拼音 ``` Helper::changeHWWord("zhou jia wei hao shuai"); ``` [![汉语拼音转威妥码拼音](https://camo.githubusercontent.com/9e8b4a4c30d79ebe6b8f2f1c4e4c495daa189f43401948c10b6ce26a54667b3b/68747470733a2f2f63646e2e6c6561726e6b752e636f6d2f75706c6f6164732f696d616765732f3230323130382f31322f36313139352f627969364467483843722e706e67216c61726765)](https://camo.githubusercontent.com/9e8b4a4c30d79ebe6b8f2f1c4e4c495daa189f43401948c10b6ce26a54667b3b/68747470733a2f2f63646e2e6c6561726e6b752e636f6d2f75706c6f6164732f696d616765732f3230323130382f31322f36313139352f627969364467483843722e706e67216c61726765) 单汉语拼音转威妥码拼音 ``` Helper::changeWHWord("chou"); ``` [![威妥码拼音转汉语拼音](https://camo.githubusercontent.com/62e0f01a2333d96ea425a95598cdadee987afd7d0e83fe1e6d8a8b1508ef1a6f/68747470733a2f2f63646e2e6c6561726e6b752e636f6d2f75706c6f6164732f696d616765732f3230323130382f31322f36313139352f713871555536344c69772e706e67216c61726765)](https://camo.githubusercontent.com/62e0f01a2333d96ea425a95598cdadee987afd7d0e83fe1e6d8a8b1508ef1a6f/68747470733a2f2f63646e2e6c6561726e6b752e636f6d2f75706c6f6164732f696d616765732f3230323130382f31322f36313139352f713871555536344c69772e706e67216c61726765) 长句汉语拼音转威妥码拼音 ``` Helper::changeWHWord("chou chia wei hao shuai a"); ``` [![威妥码拼音转汉语拼音](https://camo.githubusercontent.com/bd48fa7a3ac31df77b90b0b54ddf3abc673ca5583dddc4013b49db5b3c83b991/68747470733a2f2f63646e2e6c6561726e6b752e636f6d2f75706c6f6164732f696d616765732f3230323130382f31322f36313139352f4339526d66677048704e2e706e67216c61726765)](https://camo.githubusercontent.com/bd48fa7a3ac31df77b90b0b54ddf3abc673ca5583dddc4013b49db5b3c83b991/68747470733a2f2f63646e2e6c6561726e6b752e636f6d2f75706c6f6164732f696d616765732f3230323130382f31322f36313139352f4339526d66677048704e2e706e67216c61726765) 抖音新交易系统 ------- [](#抖音新交易系统) `use Chowjiawei\Helpers\Services\TTV2Service;` `helpers.php` 配置文件中 `tiktok` 选项 全部需要配置完全才可以使用 - 查询订单 ``` $tiktokService= new TTV2Service(); $tiktokService->query("站内订单号，非抖音侧订单号"); 正确时返回数组 其余返回空数组 ``` - 发起退款 (单个订单单个订单项) ``` $tiktokService= new TTV2Service(); $tiktokService->refund("站内订单号，非抖音侧订单号", '价格 为分', '$itemOrderId'); 正确时返回true 其余返回false ``` - 发起退款 (单个订单多个订单项) ``` $item= [ [ "item_order_id" => '', "refund_amount" => (int)$price ], [ "item_order_id" => '', "refund_amount" => (int)$price ], ]; $tiktokService= new TTV2Service(); $tiktokService->refundManyItem("站内订单号，非抖音侧订单号",$item); 正确时返回true 其余返回false ``` - 同意退款 ``` $tiktokService= new TTV2Service(); $tiktokService->agreeRefund("站内订单号，非抖音侧订单号"); 正确时返回true 其余返回false ``` - 查询退款 ``` $tiktokService= new TTV2Service(); $tiktokService->getRefund("站内订单号，非抖音侧订单号"); 返回数组 ``` - 发起分账 ``` $tiktokService= new TTV2Service(); $tiktokService->settle("站内订单号，非抖音侧订单号", "分账描述"); 正确时返回true 其余返回false ``` - 设置回调配置 #### `config`中配置完成后 `$settingData`可以不传 [](#config中配置完成后-settingdata可以不传) 如果需要再次自定义或者扩展更多糊掉参数 可以传详细参数 更多参数参考抖音 ``` $settingData = [ 'create_order_callback' => "", 'refund_callback' => "", 'pay_callback' => "", ]; $tiktokService= new TTV2Service(); $tiktokService->settingReturn(array $settingData=[]); 正确时返回true 其余返回false ``` - 查询回调配置 ``` $tiktokService= new TTV2Service(); $tiktokService->getSettingReturn(); 正确时返回数组，其余返回空数组 ``` - 支付回调 ``` $tiktokService= new TTV2Service(); $tiktokService->return($request); //控制器内 直接将接受的Request $request 传入return方法，即可自动验签，并返回接收参数 返回 `status` 正确为`true` 附带 `data`数据 错误为 `false` ``` 如果业务处理失败 需要手动返回抖音成功 ``` $tiktokService->returnOK(); ``` 如果业务处理失败 需要手动返回抖音失败 ``` $tiktokService->returnError($result='失败原因，可省略'); ``` - 预下单回调 ``` $tiktokService= new TTV2Service(); $tiktokService->return($request); //控制器内 直接将接受的Request $request 传入return方法，即可自动验签，并返回接收参数 ``` 如果业务处理失败 需要手动返回抖音成功 ``` $tiktokService->returnOK(); ``` 如果业务处理失败 需要手动返回抖音失败 ``` $tiktokService->returnError($result='失败原因，可省略'); ``` ### 建议将数组内数据 存起来 后续退款等操作都需要用 抖音不支持二次查询某些字段 [](#建议将数组内数据--存起来-后续退款等操作都需要用-抖音不支持二次查询某些字段) 如果需要退款 必须存储 item\_order\_id\_list 获取如下: ``` $itemOrderId = json_decode($extendItem['msg'], true)['goods'][0]['item_order_id_list'][0]; ``` - 退款回调 ``` $tiktokService= new TTV2Service(); $tiktokService->refundReturn($request); ``` 如果业务处理失败 需要手动返回抖音成功 ``` $tiktokService->returnOK(); ``` 如果业务处理失败 需要手动返回抖音失败 ``` $tiktokService->returnError($result='失败原因，可省略'); ``` - 分账回调 ``` $tiktokService= new TTV2Service(); $tiktokService->settleCallback($request); ``` 如果业务处理失败 需要手动返回抖音成功 ``` $tiktokService->returnOK(); ``` 如果业务处理失败 需要手动返回抖音失败 ``` $tiktokService->returnError($result='失败原因，可省略'); ``` ### Health Score 33 — LowBetter than 75% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity33 Limited adoption so far Community10 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~8 days Total 5 Last Release 1296d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a50fed69c81f935cf69e064aca0aa78febeec0a6415bccd0efcd17d79c49af04?d=identicon)[zhoujiawei](/maintainers/zhoujiawei) --- Top Contributors [![chowjiawei](https://avatars.githubusercontent.com/u/59349609?v=4)](https://github.com/chowjiawei "chowjiawei (92 commits)") --- Tags dingtalkdingtalk-robotlaravelopenexchangeratesphptiktoktiktokpaywechatwechat-robotpluginlaravelexchangewechatdingtalkrobot ### Code Quality Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/chowjiawei-laravel-help-plugin/health.svg) ``` [![Health](https://phpackages.com/badges/chowjiawei-laravel-help-plugin/health.svg)](https://phpackages.com/packages/chowjiawei-laravel-help-plugin) ``` ### Alternatives [grumpydictator/firefly-iii Firefly III: a personal finances manager. 22.8k69.3k](/packages/grumpydictator-firefly-iii)[gehrisandro/tailwind-merge-laravel TailwindMerge for Laravel merges multiple Tailwind CSS classes by automatically resolving conflicts between them 341682.2k18](/packages/gehrisandro-tailwind-merge-laravel)[backpack/basset Dead-simple way to load CSS or JS assets only once per page, when using Laravel 10+. 202832.4k6](/packages/backpack-basset)[firefly-iii/data-importer Firefly III Data Import Tool. 7545.8k](/packages/firefly-iii-data-importer)[nickurt/laravel-akismet Akismet for Laravel 11.x/12.x/13.x 97139.6k2](/packages/nickurt-laravel-akismet)[ymlluo/group-robot 钉钉、企业微信、飞书 自定义群组机器人。支持链式语法创建发送消息。支持文本、Markdown、图片、文件、图文、卡片等消息。 233.8k1](/packages/ymlluo-group-robot) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)