GitlabProvider
class GitlabProvider extends AbstractProvider implements ProviderInterface
Traits
Properties
| static protected int | $nextContextNamespace | The next provider context namespace. |
from HasProviderContext |
| protected string|null | $contextNamespace | The unique context namespace for this provider instance. |
from HasProviderContext |
| protected array | $parameters | The custom parameters to be sent with the request. |
from AbstractProvider |
| protected bool | $stateless | Indicates if the session state should be utilized. |
from AbstractProvider |
| protected array | $additionalConfig | The provider's baseline configuration. |
from AbstractProvider |
| protected array | $scopes | The scopes being requested. |
|
| protected string | $scopeSeparator | The separating character for the requested scopes. |
|
| protected int | $encodingType | The type of the encoding in the query. |
from AbstractProvider |
| protected bool | $usesPKCE | Indicates if PKCE should be used. |
from AbstractProvider |
| protected null|Closure(array): string | $redirectFormatter | The callback that formats redirect URLs for the provider. |
from AbstractProvider |
| protected string | $host | The Gitlab instance host. |
Methods
Get a value from the provider context.
Set a value in the provider context.
Get or set a value in the provider context.
Create a new provider instance.
Set the baseline provider configuration.
Override provider configuration for the current request.
Get a value from the provider configuration.
Set the Guzzle HTTP client instance.
Indicate that the provider should operate as stateless.
Set the custom parameters of the request.
Get the authentication URL for the provider.
Get the token URL for the provider.
Get the raw user for the given access token.
Map the raw user array to a Socialite User instance.
Redirect the user of the application to the provider's authentication screen.
Build the authentication URL for the provider from the given base URL.
Get the GET parameters for the code request.
Format the given scopes.
Create a user instance from the given data.
Get the raw user from the token response.
Get a Social User instance from a known access token.
Determine if the current request / session has a mismatching "state".
Get the access token response for the given code.
Get the headers for the access token request.
Refresh a user's access token with a refresh token.
Get the refresh token response for the given refresh token.
Parse the access token from a token response.
Parse the refresh token from a token response.
Parse the expiration period from a token response.
Parse the approved scopes from a token response.
Merge the scopes of the requested access.
Set the scopes of the requested access.
Set the callback that formats redirect URLs for the provider.
Validate the token audience for the provider.
Generate a random string of the right length for the PKCE code verifier.
Generate the PKCE code challenge based on the PKCE code verifier in the session.
Return the hash method used to calculate the PKCE code challenge.
Set the Gitlab instance host.
Get the Gitlab instance host.
Details
in
HasProviderContext at line 30
protected mixed
getContext(string $key, mixed $default = null)
Get a value from the provider context.
in
HasProviderContext at line 38
protected mixed
setContext(string $key, mixed $value)
Set a value in the provider context.
in
HasProviderContext at line 46
protected mixed
getOrSetContext(string $key, mixed $value)
Get or set a value in the provider context.
in
HasProviderContext at line 54
protected void
forgetContext(string $key)
Forget a value from the provider context.
in
HasProviderContext at line 62
protected string
getContextKey(string $key)
Get the context key for the provider.
in
AbstractProvider at line 60
__construct(Request $request, string $clientId, string $clientSecret, Closure|string $redirectUrl, array $guzzle = [])
Create a new provider instance.
in
AbstractProvider at line 57
AbstractProvider
withConfig(array $config)
Set the baseline provider configuration.
On a worker-cached provider, the configuration persists and affects every subsequent request. Use setConfig() for per-request overrides.
in
AbstractProvider at line 571
AbstractProvider
setConfig(array $config)
Override provider configuration for the current request.
Extends the base setConfig to also handle OAuth2-specific credential keys (client_id, client_secret, redirect) in coroutine context.
in
AbstractProvider at line 85
protected mixed
getConfig(string|null $key = null, mixed $default = null)
Get a value from the provider configuration.
Reads per-request context first, falls back to baseline instance property.
in
AbstractProvider at line 95
protected Client
getHttpClient()
Get an instance of the Guzzle HTTP client.
in
AbstractProvider at line 116
AbstractProvider
setHttpClient(Client $client)
Set the Guzzle HTTP client instance.
in
AbstractProvider at line 131
AbstractProvider
setRequest(Request $request)
Set the request instance.
Stores the request in coroutine context so cached providers read the current request without leaking it to concurrent coroutines.
in
AbstractProvider at line 141
protected Request
getRequest()
Get the request instance.
in
AbstractProvider at line 157
protected bool
usesState()
Determine if the provider is operating with state.
in
AbstractProvider at line 165
protected bool
isStateless()
Determine if the provider is operating as stateless.
in
AbstractProvider at line 175
AbstractProvider
stateless()
Indicate that the provider should operate as stateless.
in
AbstractProvider at line 185
protected string
getState()
Get the string used for session state.
in
AbstractProvider at line 195
AbstractProvider
with(array $parameters)
Set the custom parameters of the request.
in
AbstractProvider at line 205
protected array
getParameters()
Get the custom parameters of the request.
at line 41
protected string
getAuthUrl(string|null $state)
Get the authentication URL for the provider.
at line 46
protected string
getTokenUrl()
Get the token URL for the provider.
at line 51
protected array
getUserByToken(string $token)
Get the raw user for the given access token.
at line 78
protected User
mapUserToObject(array $user)
Map the raw user array to a Socialite User instance.
in
AbstractProvider at line 94
RedirectResponse
redirect()
Redirect the user of the application to the provider's authentication screen.
in
AbstractProvider at line 112
protected string
buildAuthUrlFromBase(string $url, string|null $state)
Build the authentication URL for the provider from the given base URL.
in
AbstractProvider at line 120
protected array
getCodeFields(string|null $state = null)
Get the GET parameters for the code request.
in
AbstractProvider at line 144
protected string
formatScopes(array $scopes, string $scopeSeparator)
Format the given scopes.
in
AbstractProvider at line 155
User
user()
Get the User instance for the authenticated user.
in
AbstractProvider at line 173
protected User|null
getUser()
Get the user instance from the context.
in
AbstractProvider at line 183
protected AbstractProvider
setUser(User $user)
Set the user instance in the context.
in
AbstractProvider at line 193
protected User
userInstance(array $response, array $user)
Create a user instance from the given data.
in
AbstractProvider at line 211
protected array
getUserByTokenResponse(array $response)
Get the raw user from the token response.
in
AbstractProvider at line 219
User
userFromToken(string $token)
Get a Social User instance from a known access token.
in
AbstractProvider at line 228
protected bool
hasInvalidState()
Determine if the current request / session has a mismatching "state".
in
AbstractProvider at line 248
array
getAccessTokenResponse(string $code)
Get the access token response for the given code.
in
AbstractProvider at line 261
protected array
getTokenHeaders(string $code)
Get the headers for the access token request.
in
AbstractProvider at line 269
protected array
getTokenFields(string $code)
Get the POST fields for the token request.
in
AbstractProvider at line 289
Token
refreshToken(string $refreshToken)
Refresh a user's access token with a refresh token.
in
AbstractProvider at line 304
protected array
getRefreshTokenResponse(string $refreshToken)
Get the refresh token response for the given refresh token.
in
AbstractProvider at line 320
protected string
parseAccessToken(array $response)
Parse the access token from a token response.
in
AbstractProvider at line 328
protected string|null
parseRefreshToken(array $response)
Parse the refresh token from a token response.
in
AbstractProvider at line 336
protected int|null
parseExpiresIn(array $response)
Parse the expiration period from a token response.
in
AbstractProvider at line 357
protected array
parseApprovedScopes(array $response)
Parse the approved scopes from a token response.
in
AbstractProvider at line 371
protected string
getCode()
Get the code from the request.
in
AbstractProvider at line 388
AbstractProvider
scopes(array|string $scopes)
Merge the scopes of the requested access.
in
AbstractProvider at line 402
AbstractProvider
setScopes(array|string $scopes)
Set the scopes of the requested access.
in
AbstractProvider at line 415
array
getScopes()
Get the current scopes.
in
AbstractProvider at line 431
AbstractProvider
withRedirectFormatter(Closure $formatter)
Set the callback that formats redirect URLs for the provider.
On a worker-cached provider, the callback persists and affects every subsequent request. Use setConfig() for per-request redirect values.
in
AbstractProvider at line 444
AbstractProvider
redirectUrl(string $url)
Set the redirect URL.
in
AbstractProvider at line 455
protected string
getRedirectUrl()
Get the redirect URL.
in
AbstractProvider at line 485
protected string
getClientId()
Get the client ID.
in
AbstractProvider at line 493
protected string
getClientSecret()
Get the client secret.
in
AbstractProvider at line 501
protected void
validateAudience(mixed $audience)
Validate the token audience for the provider.
in
AbstractProvider at line 520
protected bool
usesPKCE()
Determine if the provider uses PKCE.
in
AbstractProvider at line 530
AbstractProvider
enablePKCE()
Enable PKCE for the provider.
in
AbstractProvider at line 540
protected string
getCodeVerifier()
Generate a random string of the right length for the PKCE code verifier.
in
AbstractProvider at line 548
protected string
getCodeChallenge()
Generate the PKCE code challenge based on the PKCE code verifier in the session.
in
AbstractProvider at line 558
protected string
getCodeChallengeMethod()
Return the hash method used to calculate the PKCE code challenge.
at line 32
GitlabProvider
setHost(string|null $host)
Set the Gitlab instance host.
at line 63
protected string
getHost()
Get the Gitlab instance host.