README

一个用于访问 Strava API 数据的 Laravel 包。兼容 Laravel 5.0 及以上版本。由于 @RichieMcMullen 的包无法在 Laravel 8 上使用，因此进行了分支。

Strava 访问凭证

为了使用此包，您需要在您的 Strava 账户中创建一个应用。创建 Strava 应用以访问您的 API 凭证。有关 Strava API 的更多信息，请点击此处 Strava API。

安装

要在您的 Laravel 项目中安装此包，请使用以下 composer 命令

composer require deniztezcan/laravel-strava

发布 Strava 配置文件

vendor:publish 命令将在您的 Laravel 项目配置文件夹（config/strava.php）中发布一个名为 strava.php 的文件。使用您创建的 Strava 应用生成的 Strava API 凭证编辑此文件。

php artisan vendor:publish --provider="DenizTezcan\Strava\StravaServiceProvider"

已发布配置文件内容

'client_id' => env('STRAVA_CLIENT_ID', '')
'client_secret' => env('STRAVA_SECRET_ID', '')
'redirect_uri' => env('STRAVA_REDIRECT_URI', '')

或者，您可以忽略上述发布命令，并将以下变量添加到您的 .env 文件中。确保添加您的 Strava 应用凭证

STRAVA_CLIENT_ID=ADD-STRAVA-CLIENT-ID-HERE
STRAVA_SECRET_ID=ADD-STRAVA-SECRET-HERE
STRAVA_REDIRECT_URI=ADD-STRAVA-REDIRECT-URI-HERE

自动发现

如果您正在使用 Laravel 5.5+，则不需要手动添加服务提供者或门面。这将自动发现。对于 Laravel 5.5 以下的所有版本，您必须手动将 ServiceProvider & Facade 添加到您的 Laravel 项目 config/app.php 中相应的数组中

提供商

DenizTezcan\Strava\StravaServiceProvider::class,

别名 / 门面

'Strava' => DenizTezcan\Strava\StravaFacade::class,

用法

使用 Strava 门面

将 Strava 门面添加到您的控制器顶部，以便可以访问 Strava 类的方法。

use Strava;

class MyController extends Controller
{
  // Controller functions here...
}

验证用户

调用 Strava::authenticate() 方法将您重定向到 Strava。如果身份验证成功，用户将被重定向到您在 config 文件或 .env 文件中添加的 redirect_uri。现在您还可以在身份验证时传递 $scope 作为参数。您可以根据需要添加或删除作用域。一些是必需的，一些是可选的。有关可用作用域的详细信息，请参阅此处 Strava 身份验证作用域

public function stravaAuth()
{
  return Strava::authenticate($scope='read_all,profile:read_all,activity:read_all');
}

获取用户访问令牌

当返回到重定向 URI 时，调用 Strava::token($code) 方法以生成用户的 Strava 访问令牌和刷新令牌。令牌使用重定向 URI 中的 code 参数值生成。请确保将用户的 access_token 和 refresh_token 存储在您的数据库中。

public function getToken(Request $request)
{
  $token = Strava::token($request->code);

  // Store $token->access_token & $token->refresh_token in database
}

示例响应

"token_type": "Bearer"
"expires_at": 1555165838
"expires_in": 21600 // 6 Hours
"refresh_token": "671129e56b1ce64d7e0c7e594cb6522b239464e1"
"access_token": "e105062b153da39f81a439b90b23357c741a40a0"
"athlete": ...

到此为止，您已经可以访问 Athlete 对象，该对象可以用于登录到您的网站。当然，您需要编写登录系统的逻辑，但运动员名称、电子邮件等数据都包含在对象中，以便您可以验证用户与您的数据库数据。

访问令牌过期时间

根据Strava实施的新流程，访问令牌现在将在6小时后过期，并且需要使用刷新令牌进行更新。在上面的示例中，您可以看到响应中有一个refresh_token和一个expires_at字段。当存储用户访问令牌时，您可能还想存储expires_at字段。这将允许您检查当前访问令牌何时过期。

在调用以下任何Strava方法时，您可能想将当前时间与expires_at字段进行比较以验证令牌。如果令牌已过期，您需要调用Strava::refreshToken($refreshToken)方法以生成新的令牌。您需要做的只是传递当前存储的refresh_token，然后该方法将返回一组新的令牌（访问和刷新），并使用响应中的新令牌更新当前用户的令牌。以下是一个使用Strava::athlete($token)方法的示例。

public function myControllerFunction(Request $request)
{
  // Get the user
  $user = User::find($request->id);

  // Check if current token has expired
  if(Carbon::now() > $user->expires_at)
  {
    // Token has expired, generate new tokens using the currently stored user refresh token
    $refresh = Strava::refreshToken($user->refresh_token);

    // Update the users tokens
    User::where('id', $request->id)->update([
      'access_token' => $refresh->access_token,
      'refresh_token' => $refresh->refresh_token
    ]);

    // Call Strava Athlete Method with newly updated access token.
    $athlete = Strava::athlete($user->access_token);

    // Return $athlete array to view
    return view('strava.athlete')->with(compact('athlete'));

  }else{

    // Token has not yet expired, Call Strava Athlete Method
    $athlete = Strava::athlete($user->access_token);

    // Return $athlete array to view
    return view('strava.athlete')->with(compact('athlete'));

  }

}

注销用户

您可以使用您的Strava应用程序允许用户注销其Strava账户。只需允许用户调用以下方法，传递为其账户存储的访问令牌即可。

Strava::unauthenticate($token);

可用方法

所有方法都需要访问令牌，一些方法接受以下列出的可选参数。

可选参数
- $page (Int - 默认 1)
- $perpage (Int - 默认 10)
- $before (Int/Timestamp - 默认 = 最近)
- $after (Int/Timestamp - 默认 = 最近)

运动员数据

返回当前认证的运动员。

Strava::athlete($token);

用户活动数据

返回运动员的活动。

Strava::activities($token, $page, $perPage, $before, $after);

用户单个活动

返回由认证运动员拥有的指定活动。

Strava::activity($token, $activityID);

用户单个活动流

返回指定活动的流。

// $keys is a string array containing required streams
// e.g. ['latlng', 'time']
Strava::activityStream($token, $activityID, $keys = '', $keyByType = true);

活动评论

返回给定活动的评论。

Strava::activityComments($token, $activityID, $page, $perPage);

活动赞

返回点赞活动的运动员。

Strava::activityKudos($token, $activityID, $page, $perPage);

活动圈

返回活动的圈数据。

Strava::activityLaps($token, $activityID);

活动区域

需要Summit功能。返回给定活动的区域。

Strava::activityZones($token, $activityID);

运动员区域

返回认证运动员的心率功率区域。

Strava::athleteZones($token);

运动员统计

返回运动员的活动统计数据。

Strava::athleteStats($token, $athleteID, $page, $perPage);

俱乐部

使用其标识符返回给定的俱乐部。

Strava::club($token, $clubID);

俱乐部成员

返回属于给定俱乐部的运动员列表。

Strava::clubMembers($token, $clubID, $page, $perPage);

俱乐部活动

检索特定俱乐部的成员的最近活动。认证运动员必须属于请求的俱乐部才能访问此端点。支持分页。尊重所有活动的运动员配置文件可见性。

Strava::clubActivities($token, $clubID, $page, $perPage);

俱乐部管理员

返回给定俱乐部的管理员列表。

Strava::clubAdmins($token, $clubID, $page, $perPage);

运动员俱乐部

返回包括认证运动员的俱乐部列表。

Strava::athleteClubs($token, $page, $perPage);

装备

使用设备ID返回设备数据。

Strava::gear($token, $gearID);

路线

返回指定路线。

Strava::route($token, $routeID);

运动员路线

返回由认证运动员创建的路线列表。

Strava::athleteRoutes($token, $athleteID, $page, $perPage);

分段

返回指定的分段。

Strava::segment($token, $segmentID);

分段努力

返回由认证运动员拥有的活动中的分段努力。

Strava::segmentEffort($token, $segmentID);

星标分段

认证运动员的星标分段列表。

Strava::starredSegments($token, $page, $perPage);

参数类型

$token        = String
$activityID   = integer
$athleteID    = integer
$clubID       = integer
$gearID       = integer
$routeID      = integer
$segmentID    = integer
$page         = integer
$perPage      = integer
$before       = integer (timestamp)
$after        = integer (timestamp)

缓存

强烈建议您对对Strava的请求进行缓存，原因有两个。

(1)速率限制

Strava有一个相当不错的API速率限制，每15分钟600次请求，每天30,000次。如果您的网站流量很大，您可能需要考虑缓存Strava响应数据，以免超出这些限制。

(2)网站加载速度

缓存您的Strava数据将显著提高网站加载时间。

deniztezcan / laravel-strava

维护者

详细信息