ibrand / common
iBrand common server.
Installs: 14 789
Dependents: 1
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 1
Open Issues: 0
Requires
- php: >=7.0
- barryvdh/laravel-cors: ^1.0
- overtrue/http: ~1.0
Requires (Dev)
- orchestra/database: ~4.0
- orchestra/testbench: ~4.0
- phpunit/phpunit: ~8.0
This package is auto-updated.
Last update: 2024-12-16 15:10:36 UTC
README
适用于 Laravel 项目的通用包,目前广泛引用果酱社区的所有开源与商业项目,
安装
$ composer require ibrand/common:~1.0 -vvv
$ php artisan vendor:publish --provider="iBrand\DatabaseLogger\ServiceProvider"
使用
微信
基于 overtrue/wechat 适配 Laravel,同时又支持多项目配置,使用方法与 overtrue/wechat 基本一致。
在果酱社区的项目中,经常会配置多个微信公众号或者小程序,在这种场景下需要用到多项目配置的方式。
创建实例
- 代码中直接声明配置
use iBrand\Common\Wechat\Factory;
$config = [
'app_id' => 'wx3cf0f39249eb0exx',
'secret' => 'f1c242f4f28f735d4687abb469072axx',
// 指定 API 调用返回结果的类型:array(default)/collection/object/raw/自定义类名
'response_type' => 'array',
//...
];
$app = Factory::officialAccount($config);
- 基于 config/ibrand/wechat.php config 文件
use iBrand\Common\Wechat\Factory;
$app = Factory::officialAccount(); //use default
$app = Factory::officialAccount('ec'); //use ec project config
使用
具体参加 overtrue/wechat 官方文档: https://www.easywechat.com/docs
获取微信 js config
支持通过微信开放平台和直接获取 JSSDK,请通过 config('ibrand.platform.enabled_jssdk')
配置项来决定采用哪种方式。
详见 src/Controllers/WechatController.php
代码。
第三方平台
目前在微信的体系中,经常会涉及到第三方平台,比如:
- 公众号授权第三方平台提供服务。
- 小程序托管发布。果酱团队虽然不怎么接外包,但是也有不少客户,那么通过授权后统一托管发布很更简单一点。
果酱也提供了官方的第三方平台源码:laravel-wechat-platform
帮助函数
helpers.php
文件里是目前常用的一些辅助函数,后续会陆续增加。这里只简单罗列下清单:
platform_application()
: 实例化第三方平台应用对象。is_mobile
: 手机判断。is_mail
:邮箱判断。is_username
:用户名判断。get_wechat_config
:获取微信配置信息collect_to_array
:把 Laravel 的 collection 集合转化成数组,常用语 json 数据返回前转化一下。
API Resource 封装
这个模块主要核心实现如下功能:
- 兼容 Dingo/api ,因为历史原因,在返回前端数据上,需要和 dingo/api 保持一致。在果酱的所有系列产品中,无论是 dingo/api 还是 API Resource 返回的数据结构一定是一致的。
- 实现了 API Resource 返回数据时隐藏字段功能,在 Model 中通过
$withoutFields
字段指定即可。 iBrand\Common\Controllers\Controller
封装常见的 API 返回方法。
果酱云社区
-
全网真正免费的IT课程平台
-
专注于综合IT技术的在线课程,致力于打造优质、高效的IT在线教育平台
-
课程方向包含Python、Java、前端、大数据、数据分析、人工智能等热门IT课程
-
300+免费课程任你选择