Skip to content

Commit 16933c1

Browse files
authored
Merge pull request #102 from mingyoung/patch-4
Update README.md
2 parents 865692d + 6612684 commit 16933c1

File tree

1 file changed

+35
-18
lines changed

1 file changed

+35
-18
lines changed

README.md

Lines changed: 35 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -219,6 +219,12 @@ Route::group(['middleware' => ['web', 'wechat.oauth:snsapi_userinfo']], function
219219

220220
上面的路由定义了 `/user` 是需要微信授权的,那么在这条路由的**回调 或 控制器对应的方法里**, 你就可以从 `session('wechat.oauth_user')` 拿到已经授权的用户信息了。
221221

222+
## 路由支持
223+
224+
首先在配置文件中将`route.enabled` 项改为 `true` 启用路由,无需在项目中定义路由、控制器等,只需监听相应的事件即可。
225+
226+
#### 开放平台路由支持
227+
修改配置文件中的 `route.open_platform_serve_url` 为开放平台第三方应用设置的授权事件接收 URL。
222228

223229
## 模拟授权
224230

@@ -228,36 +234,47 @@ Route::group(['middleware' => ['web', 'wechat.oauth:snsapi_userinfo']], function
228234
2. 在 config/wechat.php 中配置 `mock_user` 为微信的模拟的用户资料:
229235

230236
```php
231-
/*
232-
* 开发模式下的免授权模拟授权用户资料
233-
*
234-
* 当 enable_mock 为 true 则会启用模拟微信授权,用于开发时使用,开发完成请删除或者改为 false 即可
235-
*/
236-
'enable_mock' => env('WECHAT_ENABLE_MOCK', true),
237-
'mock_user' => [
238-
"openid" =>"odh7zsgI75iT8FRh0fGlSojc9PWM",
239-
// 以下字段为 scope 为 snsapi_userinfo 时需要
240-
"nickname" => "overtrue",
241-
"sex" =>"1",
242-
"language" =>"zh_CN",
243-
"province" =>"北京",
244-
"city" =>"北京",
245-
"country" =>"中国",
246-
"headimgurl" => "http://wx.qlogo.cn/mmopen/C2rEUskXQiblFYMUl9O0G05Q6pKibg7V1WpHX6CIQaic824apriabJw4r6EWxziaSt5BATrlbx1GVzwW2qjUCqtYpDvIJLjKgP1ug/0",
237+
/*
238+
* 开发模式下的免授权模拟授权用户资料
239+
*
240+
* 当 enable_mock 为 true 则会启用模拟微信授权,用于开发时使用,开发完成请删除或者改为 false 即可
241+
*/
242+
'enable_mock' => env('WECHAT_ENABLE_MOCK', true),
243+
'mock_user' => [
244+
'openid' => 'odh7zsgI75iT8FRh0fGlSojc9PWM',
245+
// 以下字段为 scope 为 snsapi_userinfo 时需要
246+
'nickname' => 'overtrue',
247+
'sex' => '1',
248+
'province' => '北京',
249+
'city' => '北京',
250+
'country' => '中国',
251+
'headimgurl' => 'http://wx.qlogo.cn/mmopen/C2rEUskXQiblFYMUl9O0G05Q6pKibg7V1WpHX6CIQaic824apriabJw4r6EWxziaSt5BATrlbx1GVzwW2qjUCqtYpDvIJLjKgP1ug/0',
247252
],
248253
```
249254

250255
以上字段在 scope 为 `snsapi_userinfo` 时尽可能配置齐全哦,当然,如果你的模式只是 `snsapi_base` 的话只需要 `openid` 就好了。
251256

252-
## 授权事件
257+
## 事件
253258

254-
每次授权均会触发 `Overtrue\LaravelWechat\Events\WeChatUserAuthorized`,你可以监听该事件,该事件有两个属性:
259+
> 你可以监听相应的事件,并对事件发生后执行相应的操作。
260+
261+
- OAuth 网页授权:`Overtrue\LaravelWechat\Events\WeChatUserAuthorized`
255262

256263
```php
264+
// 该事件有两个属性
257265
$event->user; // 同 session('wechat.oauth_user') 一样
258266
$event->isNewSession; // 是不是新的会话(第一次创建 session 时为 true)
259267
```
260268

269+
- 开放平台授权成功:`Overtrue\LaravelWechat\Events\OpenPlatform\Authorized`
270+
- 开放平台授权更新:`Overtrue\LaravelWechat\Events\OpenPlatform\UpdateAuthorized`
271+
- 开放平台授权取消:`Overtrue\LaravelWechat\Events\OpenPlatform\Unauthorized`
272+
273+
```php
274+
// 开放平台事件有如下属性
275+
$message = $event->message; // 获取授权事件通知内容
276+
```
277+
261278
更多 SDK 的具体使用请参考:https://easywechat.org
262279

263280
## License

0 commit comments

Comments
 (0)