flipboxdigital / oauth2-salesforce
Salesforce OAuth 2.0 Client Provider for The PHP League OAuth2-Client
1.0.0
2018-02-22 21:06 UTC
Requires
Requires (Dev)
- mockery/mockery: ~0.9
- phpunit/phpunit: ~4.0
- squizlabs/php_codesniffer: ~2.0
This package is auto-updated.
Last update: 2024-10-09 13:25:01 UTC
README
This package provides Salesforce OAuth 2.0 support for the PHP League's OAuth 2.0 Client.
Installation
To install, use composer:
composer require flipboxdigital/oauth2-salesforce
Usage
Usage is the same as The League's OAuth client, using \Flipbox\OAuth2\Client\Provider\Salesforce
as the provider.
Authorization Code Flow
$provider = new Flipbox\OAuth2\Client\Provider\Salesforce([ 'clientId' => '{salesforce-client-id}', 'clientSecret' => '{salesforce-client-secret}', 'redirectUri' => 'https://example.com/callback-url', 'domain' => '{custom-salesforce-domain}' // optional, defaults to https://login.salesforce.com 'apiVersion' => '{custom-salesforce-api-version}' // optional, defaults to v21.0 ]);
For further usage of this package please refer to the core package documentation on "Authorization Code Grant".
Refreshing a Token
$provider = new Flipbox\OAuth2\Client\Provider\Salesforce([ 'clientId' => '{salesforce-client-id}', 'clientSecret' => '{salesforce-client-secret}', 'redirectUri' => 'https://example.com/callback-url' ]); $existingAccessToken = getAccessTokenFromYourDataStore(); if ($existingAccessToken->hasExpired()) { $newAccessToken = $provider->getAccessToken('refresh_token', [ 'refresh_token' => $existingAccessToken->getRefreshToken() ]); // Purge old access token and store new access token to your data store. }
Using a custom Salesforce domain
$provider->setDomain('https://foo-bar.salesforce.com');
For further usage of this package please refer to the core package documentation on "Refreshing a Token".
Testing
$ ./vendor/bin/phpunit
Contributing
Please see CONTRIBUTING for details.
Credits
License
The MIT License (MIT). Please see License File for more information.