orbisnull/socialauther

SocialAuther 是一个 PHP 库，简化了通过流行的社交网络和服务的网站认证实现：vk.com、odnoklassniki.ru、mail.ru、yandex.ru、google.com、facebook.com。基于 https://github.com/stanislav-protasevich/SocialAuther

维护者

详细信息

github.com/orbisnull/SocialAuther

源代码

安装次数: 763

依赖者: 0

建议者: 0

安全: 0

星标: 1

关注者: 2

分支: 47

dev-master 2017-04-09 10:09 UTC

Requires

GPL-3.0+ 6290b7c07ae76737677a03f95a89067631968782

  • Vasiliy Shvakin <zen4dev.woop@gmail.com>

This package is not auto-updated.

Last update: 2024-09-14 13:18:14 UTC

README

SocialAuther - 一个用于通过流行的社交网络和服务简化网站认证的 PHP 库

注意： 以下示例中的设置是为 本地服务器 进行的

注意： 要使用此库，请连接类自动加载器 require_once 'lib/SocialAuther/autoload.php';

使用方法

通过 VKontakte 进行认证

注意： 如果通过 $vkAdapter->getAuthUrl() 方法生成的授权链接访问时，返回 {"error":"invalid_request","error_description":"Security Error"} 消息，则需要访问您的 vk 账户的 设置页面。在 "您的页面的安全性" 部分中，点击 "查看活动历史" 链接。在打开的窗口中，点击 "结束所有会话"，以清除 vk 缓存。这样，就可以解决出现的 security_error 问题。

要使用 VKontakte 社交网络进行认证，您需要先创建一个新项目并配置参数：client_id、client_secret 和 redirect_uri

  • 步骤 1. 创建 新应用
    • 名称： "SocialAuther 测试"
    • 类型： "网站"
  • 步骤 2. 设置 "Open API" 部分
    • 网站地址： http://localhost/auth?provider=vk
    • 基本域名： "localhost"
  • 步骤 3. 配置参数 client_id、client_secret 和 redirect_uri
    • client_id - 位于 "应用 ID" 选项中。例如： 3078654
    • client_secret - 位于 "安全密钥" 选项中。例如： zrCHcmKAcBvblSUIBIwu
    • redirect_uri - 位于 "网站地址" 选项中。例如： http://localhost/auth?provider=vk
  • 步骤 4. 使用 SocialAuther。

使用 SocialAuther

<?php

// конфигурация настроек адаптера
$vkAdapterConfig = array(
    'client_id'     => '3078654',
    'client_secret' => 'zrCHcmKAcBvblSUIBIwu',
    'redirect_uri'  => 'http://localhost/auth?provider=vk'
);

// создание адаптера и передача настроек
$vkAdapter = new SocialAuther\Adapter\Vk($vkAdapterConfig);

// передача адаптера в SocialAuther
$auther = new SocialAuther\SocialAuther($vkAdapter);

// аутентификация и вывод данных пользователя или вывод ссылки для аутентификации
if (!isset($_GET['code'])) {
	echo '<p><a href="' . $auther->getAuthUrl() . '">Аутентификация через ВКонтакте</a></p>';
} else {
	if ($auther->authenticate()) {
		if (!is_null($auther->getSocialId()))
			echo "Социальный ID пользователя: " . $auther->getSocialId() . '<br />';
		
		if (!is_null($auther->getName()))
			echo "Имя пользователя: " . $auther->getName() . '<br />';
		
		if (!is_null($auther->getEmail()))
			echo "Email пользователя: " . $auther->getEmail() . '<br />';
		
		if (!is_null($auther->getSocialPage()))
			echo "Ссылка на профиль пользователя: " . $auther->getSocialPage() . '<br />';

		if (!is_null($auther->getSex()))
			echo "Пол пользователя: " . $auther->getSex() . '<br />';

		if (!is_null($auther->getBirthday()))
			echo "День Рождения: " . $auther->getBirthday() . '<br />';

		// аватар пользователя 
		if (!is_null($auther->getAvatar()))
			echo '<img src="' . $auther->getAvatar() . '" />'; echo "<br />";
	}
}

通过 Одноклассники 进行认证

要使用 Одноклассники 社交网络进行认证，您需要先创建一个新项目并配置参数：client_id、client_secret、redirect_uri、public_key

  • 步骤 1. 创建 新应用
    • 选择 "除 Одноклассniki 外"
    • 选择 "oAuth 认证"
  • 步骤 2. 设置应用
    • 名称： "SocialAuther 测试"
    • shortname: _www.odnoklassniki.ru/game/auther
    • 应用链接： http://localhost/auth?provider=odnoklassniki
    • "图片链接" 和 "头像链接"：任意图像的链接
  • 步骤 3. 配置参数 client_id、client_secret、redirect_uri、public_key。所需的所有信息都包含在成功添加应用后发送到您的电子邮箱的信件中。
    • client_id - 应用 ID。例如： 658606315
    • client_secret - 应用安全密钥。例如： C35045020A8C7C066F25C4C7
    • redirect_uri - 应用链接。例如： http://localhost/auth?provider=odnoklassniki
    • public_key - 应用公钥。例如： BAMKABABACADCBBAB
  • 步骤 4. 使用 SocialAuther。

使用 SocialAuther

<?php

$odnoklassnikiConfig = array(
    'client_id'     => '658606315',
    'client_secret' => 'C35045020A8C7C066F25C4C7',
    'redirect_uri'  => 'http://localhost/auth?provider=odnoklassniki',
    'public_key'    => 'BAMKABABACADCBBAB'
);

$odnoklassnikiAdapter = new SocialAuther\Adapter\Odnoklassniki($odnoklassnikiConfig);

$auther = new SocialAuther\SocialAuther($odnoklassnikiAdapter);

if (!isset($_GET['code'])) {
    echo '<p><a href="' . $auther->getAuthUrl() . '">Аутентификация через Одноклассники</a></p>';
} else {
    if ($auther->authenticate()) {
        if (!is_null($auther->getSocialId()))
            echo "Социальный ID пользователя: " . $auther->getSocialId() . '<br />';

        if (!is_null($auther->getName()))
            echo "Имя пользователя: " . $auther->getName() . '<br />';

        if (!is_null($auther->getEmail()))
            echo "Email пользователя: " . $auther->getEmail() . '<br />';

        if (!is_null($auther->getSocialPage()))
            echo "Ссылка на профиль пользователя: " . $auther->getSocialPage() . '<br />';

        if (!is_null($auther->getSex()))
            echo "Пол пользователя: " . $auther->getSex() . '<br />';

        if (!is_null($auther->getBirthday()))
            echo "День Рождения: " . $auther->getBirthday() . '<br />';

        // аватар пользователя
        if (!is_null($auther->getAvatar()))
            echo '<img src="' . $auther->getAvatar() . '" />'; echo "<br />";
    }
}

通过 Mail.ru 进行认证

  • 步骤 1. 创建 新应用
    • 同意规则
    • 名称： "SocialAuther 测试"
    • 主页地址: http://localhost/auth?provider=mailru
  • 步骤 2. 设置应用
    • 下载提供的receiver.html文件并将其放置到项目文件夹中
    • 为了在本地服务器上安装，请点击“跳过”
  • 步骤3. 配置参数 client_id、client_secret、redirect_uri
    • client_id - ID。示例: 670707
    • client_secret - 密钥。示例: a619062972f2073ded61405b8f8eccd2
    • redirect_uri - 主页地址。示例: http://localhost/auth?provider=mailru
  • 步骤 4. 使用 SocialAuther。

使用 SocialAuther

<?php

$mailruAdapterConfig = array(
    'client_id'     => '670707',
    'client_secret' => 'a619062972f2073ded61405b8f8eccd2',
    'redirect_uri'  => 'http://localhost/auth?provider=mailru'
);

$mailruAdapter = new SocialAuther\Adapter\Mailru($mailruAdapterConfig);

$auther = new SocialAuther\SocialAuther($mailruAdapter);

if (!isset($_GET['code'])) {
    echo '<p><a href="' . $auther->getAuthUrl() . '">Аутентификация через Mail.ru</a></p>';
} else {
    if ($auther->authenticate()) {
        if (!is_null($auther->getSocialId()))
            echo "Социальный ID пользователя: " . $auther->getSocialId() . '<br />';

        if (!is_null($auther->getName()))
            echo "Имя пользователя: " . $auther->getName() . '<br />';

        if (!is_null($auther->getEmail()))
            echo "Email пользователя: " . $auther->getEmail() . '<br />';

        if (!is_null($auther->getSocialPage()))
            echo "Ссылка на профиль пользователя: " . $auther->getSocialPage() . '<br />';

        if (!is_null($auther->getSex()))
            echo "Пол пользователя: " . $auther->getSex() . '<br />';

        if (!is_null($auther->getBirthday()))
            echo "День Рождения: " . $auther->getBirthday() . '<br />';

        // аватар пользователя
        if (!is_null($auther->getAvatar()))
            echo '<img src="' . $auther->getAvatar() . '" />'; echo "<br />";
    }
}

通过Yandex进行身份验证

  • 步骤1. 创建新应用
  • 步骤 2. 设置应用
    • 名称: "SocialAuther Test"
    • 权限: "Яндекс.Логин - 电子邮件地址；出生日期；用户名，姓名，性别"
    • 回调URI: http://localhost/auth?provider=yandex
  • 步骤3. 配置参数 client_id、client_secret、redirect_uri
    • client_id - 应用ID。示例: bff0bfcaef054ab66c0538b39e0a86cf
    • client_secret - 应用密码。示例: 219ba88d386b114b9c6abef7eab4e8e4
    • redirect_uri - 回调URI。示例: http://localhost/auth?provider=yandex
  • 步骤 4. 使用 SocialAuther。

使用 SocialAuther

<?php

$yandexAdapterConfig = array(
    'client_id'     => 'bff0bfcaef054ab66c0538b39e0a86cf',
    'client_secret' => '219ba88d386b114b9c6abef7eab4e8e4',
    'redirect_uri'  => 'http://localhost/auth?provider=yandex'
);

$yandexAdapter = new SocialAuther\Adapter\Yandex($yandexAdapterConfig);

$auther = new SocialAuther\SocialAuther($yandexAdapter);

if (!isset($_GET['code'])) {
    echo '<p><a href="' . $auther->getAuthUrl() . '">Аутентификация через Yandex</a></p>';
} else {
    if ($auther->authenticate()) {
        if (!is_null($auther->getSocialId()))
            echo "Социальный ID пользователя: " . $auther->getSocialId() . '<br />';

        if (!is_null($auther->getName()))
            echo "Имя пользователя: " . $auther->getName() . '<br />';

        if (!is_null($auther->getEmail()))
            echo "Email пользователя: " . $auther->getEmail() . '<br />';

        if (!is_null($auther->getSocialPage()))
            echo "Ссылка на профиль пользователя: " . $auther->getSocialPage() . '<br />';

        if (!is_null($auther->getSex()))
            echo "Пол пользователя: " . $auther->getSex() . '<br />';

        if (!is_null($auther->getBirthday()))
            echo "День Рождения: " . $auther->getBirthday() . '<br />';

        // аватар пользователя
        if (!is_null($auther->getAvatar()))
            echo '<img src="' . $auther->getAvatar() . '" />'; echo "<br />";
    }
}

通过Google进行身份验证

  • 步骤1. 创建新应用
    • 在菜单中选择"API访问"
    • 点击"创建OAuth 2.0客户端ID..."按钮
  • 步骤 2. 设置应用
    • API访问: "SocialAuther Test"
    • 点击“下一步”
    • 应用程序类型: "Web应用程序"
    • 您的网站或主机名: localhost/google-auth
    • 点击创建客户端ID
  • 步骤3. 配置参数 client_id、client_secret、redirect_uri
    • client_id - 应用ID。示例: 333739311538.apps.googleusercontent.com
    • client_secret - 应用密码。示例: lZB3aW8UG8gDj6WVIEIcidt5
    • redirect_uri - 回调URI。示例: http://localhost/auth?provider=google
  • 步骤 4. 使用 SocialAuther。

使用 SocialAuther

<?php

$googleAdapterConfig = array(
    'client_id'     => '393337311853.apps.googleusercontent.com',
    'client_secret' => 'B38WaUlZG8gDI6jIEWVct5id',
    'redirect_uri'  => 'http://localhost/auth?provider=google'
);

$googleAdapter = new SocialAuther\Adapter\Google($googleAdapterConfig);

$auther = new SocialAuther\SocialAuther($googleAdapter);

if (!isset($_GET['code'])) {
    echo '<p><a href="' . $auther->getAuthUrl() . '">Аутентификация через Google</a></p>';
} else {
    if ($auther->authenticate()) {
        if (!is_null($auther->getSocialId()))
            echo "Социальный ID пользователя: " . $auther->getSocialId() . '<br />';

        if (!is_null($auther->getName()))
            echo "Имя пользователя: " . $auther->getName() . '<br />';

        if (!is_null($auther->getEmail()))
            echo "Email пользователя: " . $auther->getEmail() . '<br />';

        if (!is_null($auther->getSocialPage()))
            echo "Ссылка на профиль пользователя: " . $auther->getSocialPage() . '<br />';

        if (!is_null($auther->getSex()))
            echo "Пол пользователя: " . $auther->getSex() . '<br />';

        if (!is_null($auther->getBirthday()))
            echo "День Рождения: " . $auther->getBirthday() . '<br />';

        // аватар пользователя
        if (!is_null($auther->getAvatar()))
            echo '<img src="' . $auther->getAvatar() . '" />'; echo "<br />";
    }
}

通过Facebook进行身份验证

  • 步骤1. 创建新应用
    • 点击“+ 创建新应用”按钮
    • 应用名称: "SocialAuther Test"
    • 点击“继续”
  • 步骤 2. 设置应用
    • 点击“带有Facebook登录的网站”
    • 输入网站URL: http://localhost/auth?provider=facebook
  • 步骤3. 配置参数 client_id、client_secret、redirect_uri
    • client_id - 应用ID。示例: 346158195993388
    • client_secret - 应用密钥。示例: 2de1ab376d1c17cd47250920c05ab386
    • redirect_uri - 回调URI。示例: http://localhost/auth?provider=facebook
  • 步骤 4. 使用 SocialAuther。

使用 SocialAuther

<?php

$facebookAdapterConfig = array(
    'client_id'     => '346158195993388',
    'client_secret' => '2de1ab376d1c17cd47250920c05ab386',
    'redirect_uri'  => 'http://localhost/auth?provider=facebook'
);

$facebookAdapter = new SocialAuther\Adapter\Facebook($facebookAdapterConfig);

$auther = new SocialAuther\SocialAuther($facebookAdapter);

if (!isset($_GET['code'])) {
    echo '<p><a href="' . $auther->getAuthUrl() . '">Аутентификация через Facebook</a></p>';
} else {
    if ($auther->authenticate()) {
        if (!is_null($auther->getSocialId()))
            echo "Социальный ID пользователя: " . $auther->getSocialId() . '<br />';

        if (!is_null($auther->getName()))
            echo "Имя пользователя: " . $auther->getName() . '<br />';

        if (!is_null($auther->getEmail()))
            echo "Email пользователя: " . $auther->getEmail() . '<br />';

        if (!is_null($auther->getSocialPage()))
            echo "Ссылка на профиль пользователя: " . $auther->getSocialPage() . '<br />';

        if (!is_null($auther->getSex()))
            echo "Пол пользователя: " . $auther->getSex() . '<br />';

        if (!is_null($auther->getBirthday()))
            echo "День Рождения: " . $auther->getBirthday() . '<br />';

        // аватар пользователя
        if (!is_null($auther->getAvatar()))
            echo '<img src="' . $auther->getAvatar() . '" />'; echo "<br />";
    }
}

使用SocialAuther与多个社交网络和服务的集成

<?php

$adapterConfigs = array(
    'vk' => array(
        'client_id'     => '3078654',
        'client_secret' => 'zrCHcmKAcBvblSUIBIwu',
        'redirect_uri'  => 'http://localhost/auth/?provider=vk'
    ),
    'odnoklassniki' => array(
        'client_id'     => '658606315',
        'client_secret' => 'C35045020A8C7C066F25C4C7',
        'redirect_uri'  => 'http://localhost/auth?provider=odnoklassniki',
        'public_key'    => 'BAMKABABACADCBBAB'
    ),
    'mailru' => array(
        'client_id'     => '670707',
        'client_secret' => 'a619062972f2073ded61405b8f8eccd2',
        'redirect_uri'  => 'http://localhost/auth/?provider=mailru'
    ),
    'yandex' => array(
        'client_id'     => 'bff0bfcaef054ab66c0538b39e0a86cf',
        'client_secret' => '219ba88d386b114b9c6abef7eab4e8e4',
        'redirect_uri'  => 'http://localhost/auth/?provider=yandex'
    ),
    'google' => array(
        'client_id'     => '393337311853.apps.googleusercontent.com',
        'client_secret' => 'B38WaUlZG8gDI6jIEWVct5id',
        'redirect_uri'  => 'http://localhost/auth?provider=google'
    ),
    'facebook' => array(
        'client_id'     => '346158195993388',
        'client_secret' => '2de1ab376d1c17cd47250920c05ab386',
        'redirect_uri'  => 'http://localhost/auth?provider=facebook'
    )
);

// создание адаптеров
$adapters = array();
foreach ($adapterConfigs as $adapter => $settings) {
    $class = 'SocialAuther\Adapter\\' . ucfirst($adapter);
    $adapters[$adapter] = new $class($settings);
}

if (!isset($_GET['code'])) {
    foreach ($adapters as $title => $adapter) {
        echo '<p><a href="' . $adapter->getAuthUrl() . '">Аутентификация через ' . ucfirst($title) . '</a></p>';
    }
} else {
    if (isset($_GET['provider']) && array_key_exists($_GET['provider'], $adapters)) {
        $auther = new SocialAuther\SocialAuther($adapters[$_GET['provider']]);
    }

    if ($auther->authenticate()) {
        if (!is_null($auther->getSocialId()))
            echo "Социальный ID пользователя: " . $auther->getSocialId() . '<br />';

        if (!is_null($auther->getName()))
            echo "Имя пользователя: " . $auther->getName() . '<br />';

        if (!is_null($auther->getEmail()))
            echo "Email пользователя: " . $auther->getEmail() . '<br />';

        if (!is_null($auther->getSocialPage()))
            echo "Ссылка на профиль пользователя: " . $auther->getSocialPage() . '<br />';

        if (!is_null($auther->getSex()))
            echo "Пол пользователя: " . $auther->getSex() . '<br />';

        if (!is_null($auther->getBirthday()))
            echo "День Рождения: " . $auther->getBirthday() . '<br />';

        // аватар пользователя
        if (!is_null($auther->getAvatar()))
            echo '<img src="' . $auther->getAvatar() . '" />'; echo "<br />";
    }
}

变更历史

SocialAuther 1.0