README

本项目不再继续维护，请移步 https://github.com/kuainiu/yii2-kuainiu

yii2-fond

This extension adds Fond.io OAuth2 supporting for yii2-authclient.

安装

yii2-fond 需要使用 composer 安装. 建议使用 composer 国内源 composer config repo.packagist composer https://packagist.phpcomposer.com

在项目根目录运行

composer require summic/yii2-fond

或者手动添加到 composer.json

"summic/yii2-fond": "*"

之后

composer install -vvv

配置

首先需要在内部通行证系统注册您的应用

然后修改需使用统一登录项目的配置文件(main.php 或 main-local.php)

//按需配置
'modules' => [
    'fond' => [
        'class' => 'fond\Module',
    ],
    ...
],

authClient 的配置需要放在 common 项目的配置文件(main.php 或 main-local.php )

//全局配置
return [
    'components' => [
		'authClientCollection' => [
	        'class' => 'yii\authclient\Collection',
	        'clients' => [
	            'fond' => [
	                'class' => 'fond\components\authclient\Fond',
	                'clientId' => 'fond_client_id',
	                'clientSecret' => 'fond_client_secret',
	            ],
	        ],
	    ],
	    ...
	]
];

执行数据迁移:

php yii migrate --migrationPath=@vendor/summic/yii2-fond/migrations

以上脚本在 user 表增加了 avatar fullname position 三个字段用来存储头像、中文名和职位，字段名冲突或有错误的话,可以在 modules 中配置,例如:

'modules' => [
    'fond' => [
        'class' => 'fond\Module',
        'tableMap' => [ // Optional, but if defined, all must be declared
            'user_table'            =>  '{{%user}}',
            'username_field'        =>  'name',
            'email_field'           =>  'email',
            'password_hash_field'   =>  'password_hash',
            'fullname_field'        =>  'chinese_name',
            'avatar_field'          =>  'avatar',
            'position_field'        =>  'position',
        ],
    ],
    ...
],

使用

OAuth 登录

在登录页面增加『使用企业通行证登录』链接

<div class="social-auth-links text-center">
    <p class="text-light-blue">- 或 -</p>
    <a href="/fond/user/auth?authclient=fond" class="btn btn-block btn-social btn-dropbox">
        <i class="fa fa-ticket"></i>使用企业通行证登录
    </a>
</div>

或

如果全站只允许员工访问，不需要登录页面，直接修改 SiteController 的 actionLogin 方法:

public function actionLogin()
{
	if (!Yii::$app->user->isGuest) {
    	return $this->goHome();
	}
    $this->redirect(['fond/user/auth','authclient'=>'fond']);
}

用户完成登录之后，用户资料的使用无任何变化，在 view 文件中直接使用, 注意: 用户未登录界面调用会抛异常

//头像
<?=Yii::$app->user->identity->avatar?>
//帐号
<?=Yii::$app->user->identity->username?>
//中文名
<?=Yii::$app->user->identity->fullname?>
//职位
<?=Yii::$app->user->identity->position?>

API 获取组织架构信息

use fond\components\FondClient;
...
$client = new FondClient();
$response = $client->DepartmentList(82);

API 获取组织架构下的用户信息

use fond\components\FondClient;
...
$client = new FondClient();
$response = $client->DepartmentUser(82);

API 发送企业微信消息

use fond\components\FondClient;
...
$client = new FondClient();
$response = $client->Notification('Allen', 'Hello World');

One more thing...

如果你的项目使用了 AdminLTE, 其使用的 GOOGLE 字体不可描述原因会导致页面打开慢，在 composer.json 增加以下内容可解决：

"scripts": {
    "post-install-cmd": [
        "fond\\components\\AdminLTEInstaller::initProject"
    ],
    "post-update-cmd": [
        "fond\\components\\AdminLTEInstaller::initProject"
    ]
}

summic / yii2-fond

Maintainers

Details