Download the PHP package barretzhi/laravel-wechat without Composer
On this page you can find all versions of the php package barretzhi/laravel-wechat. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravel-wechat
laravel-wechat
注意:此版本为 4.x 版本,不兼容 3.x,与 overtrue/wechat 4.x 同步
微信 SDK for Laravel 5 / Lumen, 基于 overtrue/wechat
交流QQ群:319502940
安装
- 安装包文件
!!! 注意,4.0 还没发布!所以下面的命令是装不上的,你要试用 4.0,请将 4.0 改成 dev-master
配置
Laravel 应用
-
注册
ServiceProvider
(5.5+ 版本不需要手动注册): -
创建配置文件:
-
请修改应用根目录下的
config/wechat.php
中对应的项即可; - (可选)添加外观到
config/app.php
中的aliases
部分:
Lumen 应用
-
在
bootstrap/app.php
中 82 行左右: - 如果你习惯使用
config/wechat.php
来配置的话,将vendor/overtrue/laravel-wechat/src/config.php
拷贝到app/config
目录下,并将文件名改成wechat.php
。
使用
Laravel <= 5.1
- Laravel 5 起默认启用了 CSRF 中间件,因为微信的消息是 POST 过来,所以会触发 CSRF 检查导致无法正确响应消息,所以请去除默认的 CSRF 中间件,改成路由中间件。可以参考我的写法:overtrue gist:Kernel.php
- 5.1 里的 CSRF 已经带了可忽略部分url的功能,你可以参考:http://laravel.com/docs/master/routing#csrf-protection
Laravel 5.2+
Laravel 5.2 以后的版本默认启用了 web 中间件,意味着 CSRF 会默认打开,有两种方案:
- 在 CSRF 中间件里排除微信相关的路由
- 关掉 CSRF 中间件(极不推荐)
下面以接收普通消息为例写一个例子:
假设您的域名为
overtrue.me
那么请登录微信公众平台 “开发者中心” 修改 “URL(服务器配置)” 为:http://overtrue.me/wechat
。
路由:
注意:一定是
Route::any
, 因为微信服务端认证的时候是GET
, 接收用户消息时是POST
!
然后创建控制器 WeChatController
:
上面例子里的 Log 是 Laravel 组件,所以它的日志不会写到 EasyWeChat 里的,建议把 wechat 的日志配置到 Laravel 同一个日志文件,便于调试。
我们有以下方式获取 SDK 的服务实例
使用容器的自动注入
以公众号为例:
使用外观
在 config/app.php
中 alias
部分添加外观别名:
然后就可以在任何地方使用外观方式调用 SDK 对应的服务了:
OAuth 中间件
使用中间件的情况下 app/config/wechat.php
中的 oauth.callback
就随便填写吧(因为用不着了 :smile:)。
-
在
app/Http/Kernel.php
中添加路由中间件: - 在路由中添加中间件:
以 5.2 为例:
如果你在用 5.1 上面没有 'web' 中间件
当然,你也可以在中间件参数指定当前的 scopes
:
上面的路由定义了 /user
是需要微信授权的,那么在这条路由的回调 或 控制器对应的方法里, 你就可以从 session('wechat.oauth_user')
拿到已经授权的用户信息了。
路由支持
首先在配置文件中将route.enabled
项改为 true
启用路由,无需在项目中定义路由、控制器等,只需监听相应的事件即可。
开放平台路由支持
修改配置文件中的 route.open_platform_serve_url
为开放平台第三方应用设置的授权事件接收 URL。
模拟授权
有时候我们希望在本地开发完成后线上才真实的走微信授权流程,这将减少我们的开发成本,那么你需要做以下两步:
- 在 config/wechat.php 中将:'enable_mock' 启用,不论你是用
.env
文件里WECHAT_ENABLE_MOCK=true
或者其它什么方法都可以。 - 在 config/wechat.php 中配置
mock_user
为微信的模拟的用户资料:
以上字段在 scope 为 snsapi_userinfo
时尽可能配置齐全哦,当然,如果你的模式只是 snsapi_base
的话只需要 openid
就好了。
事件
你可以监听相应的事件,并对事件发生后执行相应的操作。
-
OAuth 网页授权:
Overtrue\LaravelWeChat\Events\WeChatUserAuthorized
- 开放平台授权成功:
Overtrue\LaravelWeChat\Events\OpenPlatform\Authorized
- 开放平台授权更新:
Overtrue\LaravelWeChat\Events\OpenPlatform\UpdateAuthorized
- 开放平台授权取消:
Overtrue\LaravelWeChat\Events\OpenPlatform\Unauthorized
更多 SDK 的具体使用请参考:https://easywechat.com
License
MIT