README

Laravel框架的LinkedIn API集成

此包是Happyr/LinkedIn-API-client的包装器。您可以在这里查看php版本的文档。别忘了查看官方的LinkedIn API网站。

如果您需要在Lumen上安装，请参阅Lumen部分

Laravel上的安装

使用Composer安装

composer require artesaos/laravel-linkedin

添加服务提供者

Artesaos\LinkedIn\LinkedinServiceProvider::class,

外观

'LinkedIn'  => \Artesaos\LinkedIn\Facades\LinkedIn::class,

发布配置文件

php artisan vendor:publish --provider="Artesaos\LinkedIn\LinkedinServiceProvider"

Lumen上的安装

使用Composer安装

composer require artesaos/laravel-linkedin

将服务提供者、外观和配置参数添加到bootstrap/app.php文件中，并将linkedin.php复制到您的项目配置目录（如果不存在则创建）

$app->register(\Artesaos\LinkedIn\LinkedinServiceProvider::class);
class_alias(\Artesaos\LinkedIn\Facades\LinkedIn::class,'LinkedIn');

$app->configure('linkedin');

用法

为了使用此API客户端（或任何其他LinkedIn客户端），您必须在LinkedIn上注册您的应用程序以接收API密钥。注册LinkedIn应用程序后，您将获得一个API密钥和密钥，请在linkedin.php配置文件中填写这些值。

####基本用法 此包的独特之处在于LinkedIn外观。而不是这样做

$linkedIn=new Happyr\LinkedIn\LinkedIn('app_id', 'app_secret');
$linkedin->foo();

您可以直接调用外观的任何方法，如下所示

LinkedIn::foo();

或使用laravel容器

app('linkedin')->foo();
app()['linkedin']->foo();
App::make('linkedin')->foo(); // ...

服务容器自动返回一个可用的LinkedIn类实例

LinkedIn登录

以下示例展示了如何使用LinkedIn外观通过LinkedIn登录。

if (LinkedIn::isAuthenticated()) {
     //we know that the user is authenticated now. Start query the API
     $user=LinkedIn::get('v1/people/~:(firstName,lastName)');
     echo  "Welcome ".$user['firstName'];
     exit();
}elseif (LinkedIn::hasError()) {
     echo  "User canceled the login.";
     exit();
}

//if not authenticated
$url = LinkedIn::getLoginUrl();
echo "<a href='$url'>Login with LinkedIn</a>";
exit();

获取基本配置文件信息

您可以使用get()方法检索信息，如下所示

LinkedIn::get('v1/people/~:(firstName,num-connections,picture-url)');

此查询返回一个包含信息的数组。您可以在REST API控制台中查看所有REST API的方法

如何在LinkedIn墙上发布

以下示例展示了如何发布到用户墙上。访问令牌从数据库中获取。

LinkedIn::setAccessToken('access_token_from_db');

$options = ['json'=>
     [
        'comment' => 'Im testing Happyr LinkedIn client with Laravel Framework! https://github.com/artesaos/laravel-linkedin',
        'visibility' => [
               'code' => 'anyone'
        ]
     ]
];

$result = LinkedIn::post('v1/people/~/shares', $options);

当然，您也可以用XML格式完成相同的操作。使用以下选项数组。

$options = array(
'format' => 'xml',
'body' => '<share>
 <comment>Im testing Happyr LinkedIn client! https://github.com/Happyr/LinkedIn-API-client</comment>
 <visibility>
   <code>anyone</code>
 </visibility>
</share>');

配置

API选项

LinkedIn::api的第三个参数是一个包含选项的数组。以下是您可能使用的数组键的表格。

更改请求格式

与LinkedIn API通信时的默认格式是json。您可以允许API为您执行json_encode。以下代码展示了如何操作。

$body = array(
    'comment' => 'Testing the linkedin API!',
    'visibility' => array('code' => 'anyone')
);

LinkedIn::post('v1/people/~/shares', array('json'=>$body));
LinkedIn::post('v1/people/~/shares', array('body'=>json_encode($body)));

当使用array('json'=>$body)作为选项时，格式始终是json。您可以通过三种方式更改请求格式。

// By setter
LinkedIn::setFormat('xml');

// Set format for just one request
LinkedIn::post('v1/people/~/shares', array('format'=>'xml', 'body'=>$body));

理解响应数据类型

从LinkedIn::api返回的数据类型可以配置。您可以使用LinkedIn::setResponseDataType或作为LinkedIn::api的选项。

// By setter
LinkedIn::setResponseDataType('simple_xml');

// Set format for just one request
LinkedIn::get('v1/people/~:(firstName,lastName)', array('response_data_type'=>'psr7'));

以下是调用LinkedIn::api时可能返回的可能数据类型的表格。

使用不同的作用域

当您在验证用户时想要定义特殊的作用域，您应该在生成登录URL时指定它们。如果您没有指定作用域，LinkedIn将使用您为应用配置的默认作用域。

$scope = 'r_fullprofile,r_emailaddress,w_share';
//or 
$scope = array('rw_groups', 'r_contactinfo', 'r_fullprofile', 'w_messages');

$url = LinkedIn::getLoginUrl(array('scope'=>$scope));
return "<a href='$url'>Login with LinkedIn</a>";

更新日志

您可以在此处查看最新更改 这里