mervick/socialauther

SocialAuth 是一个 PHP 库，用于简化通过流行的社交网络和服务（vk.com、odnoklassniki.ru、mail.ru、yandex.ru、google.com、plus.google.com、facebook.com、twitter.com）实现网站认证的过程。

维护者

详细信息

github.com/mervick/SocialAuther

源代码

安装: 61

依赖项: 0

建议者: 0

安全: 0

星标: 4

关注者: 4

分支: 47

v2.0 2013-10-06 23:25 UTC

Requires

GPL-3.0+ 4eb5734b7b175b981f0058edba5a5c16a859f7b0

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

This package is not auto-updated.

Last update: 2024-09-18 19:42:32 UTC

README

Analytics

SocialAuther 是一个用于通过流行的社交网络和服务（例如 VK、OK、Mail.Ru、Yandex、Google、Facebook 和 Twitter）简化网站认证的 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 Test"
    • 类型: "网站"
  • 步骤 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. 创建 新的应用
    • 选择 "外部"
    • 选择 "oAuth 认证"
  • 步骤 2. 配置应用
    • 名称: "SocialAuther Test"
    • 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 Test"
    • 主页地址: 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