PHPackages                             namesfang/wechat-oauth - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. namesfang/wechat-oauth

ActiveLibrary[Authentication & Authorization](/categories/authentication)

namesfang/wechat-oauth
======================

微信公众号、小程序、APP授权

1.0.4(5y ago)145MITPHPPHP >=7.2

Since Jan 28Pushed 5y ago1 watchersCompare

[ Source](https://github.com/namesfang/wechat-oauth)[ Packagist](https://packagist.org/packages/namesfang/wechat-oauth)[ Docs](https://github.com/namesfang/wechat-oauth)[ RSS](/packages/namesfang-wechat-oauth/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (6)Used By (0)

### 微信公众号、小程序、APP授权

[](#微信公众号小程序app授权)

##### 微信公众号授权 示例

[](#微信公众号授权-示例)

```
// 导入命名空间
use Namesfang\WeChat\OAuth\Log\Logger;
use Namesfang\WeChat\OAuth\Bundle\Code;
use Namesfang\WeChat\OAuth\Bundle\CodeOption;
use Namesfang\WeChat\OAuth\Bundle\AccessToken;
use Namesfang\WeChat\OAuth\Bundle\AccessTokenOption;
use Namesfang\WeChat\OAuth\Bundle\UserInfo;
use Namesfang\WeChat\OAuth\Bundle\UserInfoOption;

// +-----------------------------------------------------------
// | 日志记录
// | 自行封装需要实现 LoggerInterface 接口类
// +-----------------------------------------------------------
$logger = new Logger(LOG_PATH, true);

// +-----------------------------------------------------------
// | 第1步
// | 获得CODE
// +-----------------------------------------------------------

// 参数配置方式1
 /*
 $option = new CodeOption([
 'appid'=> 'wx1111111111111111',
 'scope'=> 'snsapi_userinfo',
 'state'=> 'xxx',
 'redirect_uri'=> '',
 ]);
 */

// 参数配置方式2
$option = new CodeOption();
$option->setAppId('wx1111111111111111');
$option->setRedirectUri('http://cli.life/auth/wechat');
$option->setScope($option::SCOPE_SNSAPI_USERINFO);
$option->setState('xxx');

// 实例化 用于获取code也可自行组装URL
$code = new Code($option, $logger);

// 生成跳转到微信平台授权URL
// 从微信平台跳转回来会携带 code和state
$url = $code->makeUrl();

// 打印接口返回信息
$logger->print($url, true);

// 前台展示授权按钮
// $logger->print("授权", true);

// +-----------------------------------------------------------
// | 第2步
// | 获得 ACCESS-TOKEN和OPENID
// +-----------------------------------------------------------

// 配置参数
/*
 $option = new AccessTokenOption([
 'appid'=> '',
 'secret'=> '',
 'code'=> '',
 ]);
 */

$option = new AccessTokenOption();
$option->setAppId('wxf584e0d5640d7cc1');
$option->setSecret('eba4effd57f3781d30d1a0f7e7a5f5db');
$option->setCode('code');

$token = new AccessToken($option, $logger);

$result = $token->request();

$logger->print($result->original, true);

$logger->print($result->openid);

// +-----------------------------------------------------------
// | 第3步
// | 获得 授权信息
// +-----------------------------------------------------------
/*
 $option = new UserInfoOption([
 'openid'=> '',
 'access_token'=> '',
 'lang'=> 'zh_CN'
 ]);
 */

$option = new UserInfoOption();
$option->setOpenId('openid');
$option->setAccessToken('token');
$option->setLang();

$userinfo = new UserInfo($option, $logger);

$result = $userinfo->request();

$logger->print($result->original);
$logger->print($result->nickname);

```

##### 小程序code2session 示例

[](#小程序code2session-示例)

```
// 导入命名空间
use Namesfang\WeChat\OAuth\Log\Logger;
use Namesfang\WeChat\OAuth\Bundle\AccessToken;
use Namesfang\WeChat\OAuth\Bundle\AccessTokenOption;
use Namesfang\WeChat\OAuth\Util\Decrypt;

// +-----------------------------------------------------------
// | 日志记录
// | 自行封装需要实现 LoggerInterface 接口类
// +-----------------------------------------------------------
$logger = new Logger(LOG_PATH, true);

// +-----------------------------------------------------------
// | 获得登录信息
// +-----------------------------------------------------------
// 配置参数
/*
$option = new AccessTokenOption([
    'appid'=> '',
    'secret'=> '',
    'code'=> '',
]);
*/
$option = new AccessTokenOption();
$option->setAppId('wxf584exxxxcc1');
$option->setSecret('eba4exxxxxxf7e7a5f5db');
$option->setCode("023c550w3LL7KV2HmX2w3Z4PMj1c550v");

$token = new AccessToken($option, $logger);

//
// $with_miniprogram 为 true
// 程序自动差异处理
//
$result = $token->request(true);

$logger->print($result->original, true);

$logger->print($result->openid);

// +-----------------------------------------------------------
// | 解密小程序敏感数据
// +-----------------------------------------------------------
//
// 将 wx.getUserInfo 回调函数返回的参数分别传入
//
$decrypt = new Decrypt();

// 解密成功
if($decrypt->handle('encryptedData', $result->session_key, $result->iv)) {
    $logger->print($decrypt->result);
} else {
    $logger->print($decrypt->error);
}

```

##### 刷新 ACCESS TOKEN

[](#刷新-access-token)

```
// +-----------------------------------------------------------
// | 刷新 token 仅APP和公众号可用
// +-----------------------------------------------------------
/*
$option = new AccessTokenOption();
$option->setAppId('adfasdfadasdfadf');
$option->setRefreshToken('ea0d1a0f7e7a5f5db');

$token = new AccessToken($option, $logger);

$result = $token->refresh();

$logger->print($result->original, true);

$logger->print($result->access_token);
*/

```

##### 校验 ACCESS TOKEN

[](#校验-access-token)

```
// +-----------------------------------------------------------
// | 校验 token 仅APP和公众号可用
// +-----------------------------------------------------------
$option = new AccessTokenOption();
$option->setOpenId('adfasdfadasdfadf');
// 将第2步获得的 refresh_token 自行存储
// 在需要的时刷新
$option->setAccessToken('ea0d1a0f7e7a5f5db');

$token = new AccessToken($option, $logger);

$result = $token->check();

$logger->print($result->original, true);

$logger->print($result->errmsg);

```

##### 加密

[](#加密)

```
// 导入命名空间
use Namesfang\WeChat\OAuth\Util\Encrypt;

$decrypt = new Encrypt();

// 加密成功
if($encrypt->handle('明文数据 自动将（array或object）转为JSON')) {
    print_r($encrypt->key);
    print_r($encrypt->iv);
    print_r($encrypt->result);
} else {
    echo $encrypt->error;
}

```

##### 解密

[](#解密)

```
// 导入命名空间
use Namesfang\WeChat\OAuth\Util\Decrypt;

$decrypt = new Decrypt();

// 解密成功
if($decrypt->handle($encrypt->data, $encrypt->key, $encrypt->iv)) {
    $logger->print($decrypt->result);
} else {
    $logger->print($decrypt->error);
}

```

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

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 ~9 days

Total

5

Last Release

1888d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fa09e20469810904248a584192465904ddf55238e183dc41ee888634b395e0bc?d=identicon)[namesfang](/maintainers/namesfang)

---

Top Contributors

[![namesfang](https://avatars.githubusercontent.com/u/5258216?v=4)](https://github.com/namesfang "namesfang (14 commits)")

---

Tags

oauth2

### Embed Badge

![Health badge](/badges/namesfang-wechat-oauth/health.svg)

```
[![Health](https://phpackages.com/badges/namesfang-wechat-oauth/health.svg)](https://phpackages.com/packages/namesfang-wechat-oauth)
```

###  Alternatives

[league/oauth2-server

A lightweight and powerful OAuth 2.0 authorization and resource server library with support for all the core specification grants. This library will allow you to secure your API with OAuth and allow your applications users to approve apps that want to access their data from your API.

6.6k136.0M247](/packages/league-oauth2-server)[league/oauth2-client

OAuth 2.0 Client Library

3.8k118.6M1.2k](/packages/league-oauth2-client)[google/auth

Google Auth Library for PHP

1.4k272.7M161](/packages/google-auth)[knpuniversity/oauth2-client-bundle

Integration with league/oauth2-client to provide services

83416.7M61](/packages/knpuniversity-oauth2-client-bundle)[league/oauth2-google

Google OAuth 2.0 Client Provider for The PHP League OAuth2-Client

41721.2M118](/packages/league-oauth2-google)[thenetworg/oauth2-azure

Azure Active Directory OAuth 2.0 Client Provider for The PHP League OAuth2-Client

2509.6M48](/packages/thenetworg-oauth2-azure)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)