ne0h12/social-auther

我们网站上的社交认证

dev-master 2015-04-13 16:55 UTC

This package is not auto-updated.

Last update: 2024-09-18 07:51:21 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_idclient_secretredirect_uri

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

应用 SocialAuther

<?php

// конфигурация настроек адаптера
$vkAdapterConfig = array(
    'client_id'     => '3078654',
    'client_secret' => 'zrCHcmKAcBvblSUIBIwu',
    'redirect_uri'  => 'https:///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_idclient_secretredirect_uripublic_key

  • 步骤 1. 创建 新应用
    • 选择 "网站外"
    • 选择 "OAuth 认证"
  • 步骤 2. 配置应用
    • 名称: "SocialAuther 测试"
    • shortname: _www.odnoklassniki.ru/game/auther
    • 应用链接: https:///auth?provider=odnoklassniki
    • "图片链接" 和 "头像链接": 链接到任何图片
  • 步骤 3. 配置参数 client_idclient_secretredirect_uripublic_key。所有必要信息都将包含在添加应用后发送到您的电子邮件的邮件中
    • client_id - 应用程序 ID。例如:658606315
    • client_secret - 应用密钥。例如:C35045020A8C7C066F25C4C7
    • redirect_uri - 应用链接。例如:https:///auth?provider=odnoklassniki
    • public_key - 应用公钥。例如:BAMKABABACADCBBAB
  • 步骤 4. 使用 SocialAuther

应用 SocialAuther

<?php

$odnoklassnikiConfig = array(
    'client_id'     => '658606315',
    'client_secret' => 'C35045020A8C7C066F25C4C7',
    'redirect_uri'  => 'https:///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 测试"
    • 主页地址: https:///auth?provider=mailru
  • 步骤 2. 配置应用
    • 下载提供的文件 receiver.html 并将其放入项目文件夹中
    • 要在本地服务器上安装,请点击“跳过”
  • 步骤 3. 配置 client_idclient_secretredirect_uri 参数
    • client_id - ID。示例:670707
    • client_secret - 密钥。示例:a619062972f2073ded61405b8f8eccd2
    • redirect_uri - 主页地址。示例:https:///auth?provider=mailru
  • 步骤 4. 使用 SocialAuther

应用 SocialAuther

<?php

$mailruAdapterConfig = array(
    'client_id'     => '670707',
    'client_secret' => 'a619062972f2073ded61405b8f8eccd2',
    'redirect_uri'  => 'https:///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:https:///auth?provider=yandex
  • 步骤 3. 配置 client_idclient_secretredirect_uri 参数
    • client_id - 应用程序 ID。示例:bff0bfcaef054ab66c0538b39e0a86cf
    • client_secret - 应用程序密码。示例:219ba88d386b114b9c6abef7eab4e8e4
    • redirect_uri - 回调 URI。示例:https:///auth?provider=yandex
  • 步骤 4. 使用 SocialAuther

应用 SocialAuther

<?php

$yandexAdapterConfig = array(
    'client_id'     => 'bff0bfcaef054ab66c0538b39e0a86cf',
    'client_secret' => '219ba88d386b114b9c6abef7eab4e8e4',
    'redirect_uri'  => 'https:///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 Access”
    • 点击“Create an OAuth 2.0 Client ID...”按钮
  • 步骤 2. 配置应用
    • API Access: “SocialAuther Test”
    • 点击“Next”
    • 应用程序类型: “Web application”
    • 您的网站或主机名: localhost/google-auth
    • 点击“Create client ID”
  • 步骤 3. 配置 client_idclient_secretredirect_uri 参数
    • client_id - 应用程序 ID。示例:333739311538.apps.googleusercontent.com
    • client_secret - 应用程序密码。示例:lZB3aW8UG8gDj6WVIEIcidt5
    • redirect_uri - 回调 URI。示例:https:///auth?provider=google
  • 步骤 4. 使用 SocialAuther

应用 SocialAuther

<?php

$googleAdapterConfig = array(
    'client_id'     => '393337311853.apps.googleusercontent.com',
    'client_secret' => 'B38WaUlZG8gDI6jIEWVct5id',
    'redirect_uri'  => 'https:///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. 创建 新应用程序
    • 点击“+ Create new app”按钮
    • App Name: “SocialAuther Test”
    • 点击“Continue”
  • 步骤 2. 配置应用
    • 点击“Website with Facebook Login”
    • 输入 Site URL: https:///auth?provider=facebook
  • 步骤 3. 配置 client_idclient_secretredirect_uri 参数
    • client_id - 应用程序 ID。示例:346158195993388
    • client_secret - 应用程序密钥。示例:2de1ab376d1c17cd47250920c05ab386
    • redirect_uri - 回调 URI。示例:https:///auth?provider=facebook
  • 步骤 4. 使用 SocialAuther

应用 SocialAuther

<?php

$facebookAdapterConfig = array(
    'client_id'     => '346158195993388',
    'client_secret' => '2de1ab376d1c17cd47250920c05ab386',
    'redirect_uri'  => 'https:///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'  => 'https:///auth/?provider=vk'
    ),
    'odnoklassniki' => array(
        'client_id'     => '658606315',
        'client_secret' => 'C35045020A8C7C066F25C4C7',
        'redirect_uri'  => 'https:///auth?provider=odnoklassniki',
        'public_key'    => 'BAMKABABACADCBBAB'
    ),
    'mailru' => array(
        'client_id'     => '670707',
        'client_secret' => 'a619062972f2073ded61405b8f8eccd2',
        'redirect_uri'  => 'https:///auth/?provider=mailru'
    ),
    'yandex' => array(
        'client_id'     => 'bff0bfcaef054ab66c0538b39e0a86cf',
        'client_secret' => '219ba88d386b114b9c6abef7eab4e8e4',
        'redirect_uri'  => 'https:///auth/?provider=yandex'
    ),
    'google' => array(
        'client_id'     => '393337311853.apps.googleusercontent.com',
        'client_secret' => 'B38WaUlZG8gDI6jIEWVct5id',
        'redirect_uri'  => 'https:///auth?provider=google'
    ),
    'facebook' => array(
        'client_id'     => '346158195993388',
        'client_secret' => '2de1ab376d1c17cd47250920c05ab386',
        'redirect_uri'  => 'https:///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