Package Data | |
---|---|
Maintainer Username: | invisnik |
Maintainer Contact: | invis.nik@gmail.com (Nikita Brytkov) |
Package Create Date: | 2015-03-16 |
Package Last Update: | 2024-04-25 |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-12-15 15:16:59 |
Package Statistics | |
---|---|
Total Downloads: | 151,712 |
Monthly Downloads: | 212 |
Daily Downloads: | 6 |
Total Stars: | 172 |
Total Watchers: | 10 |
Total Forks: | 70 |
Total Open Issues: | 11 |
This package is a Laravel 5 service provider which provides support for Steam OpenID and is very easy to integrate with any project that requires Steam authentication.
composer require invisnik/laravel-steam-auth
Add your Steam API key to your .env
file. You can get your API key here.
STEAM_API_KEY=SomeKindOfAPIKey
Publish the config file.
php artisan vendor:publish --provider="Invisnik\LaravelSteamAuth\SteamServiceProvider"
In config/steam-auth.php
:
return [
/*
* Redirect URL after login
*/
'redirect_url' => '/auth/steam/handle',
/*
* Realm override. Bypass domain ban by Valve.
* Use alternative domain with redirection to main for authentication (banned by valve).
*/
// 'realm' => 'redirected.com',
/*
* API Key (set in .env file) [http://steamcommunity.com/dev/apikey]
*/
'api_key' => env('STEAM_API_KEY', ''),
/*
* Is using https?
*/
'https' => false,
];
In routes/web.php
:
Route::get('auth/steam', 'AuthController@redirectToSteam')->name('auth.steam');
Route::get('auth/steam/handle', 'AuthController@handle')->name('auth.steam.handle');
Note: if you want to keep using Laravel's default logout route, add the following as well:
Route::post('logout', 'Auth\LoginController@logout')->name('logout');
In AuthController
:
namespace App\Http\Controllers;
use Invisnik\LaravelSteamAuth\SteamAuth;
use App\User;
use Auth;
class AuthController extends Controller
{
/**
* The SteamAuth instance.
*
* @var SteamAuth
*/
protected $steam;
/**
* The redirect URL.
*
* @var string
*/
protected $redirectURL = '/';
/**
* AuthController constructor.
*
* @param SteamAuth $steam
*/
public function __construct(SteamAuth $steam)
{
$this->steam = $steam;
}
/**
* Redirect the user to the authentication page
*
* @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
*/
public function redirectToSteam()
{
return $this->steam->redirect();
}
/**
* Get user info and log in
*
* @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
*/
public function handle()
{
if ($this->steam->validate()) {
$info = $this->steam->getUserInfo();
if (!is_null($info)) {
$user = $this->findOrNewUser($info);
Auth::login($user, true);
return redirect($this->redirectURL); // redirect to site
}
}
return $this->redirectToSteam();
}
/**
* Getting user by info or created if not exists
*
* @param $info
* @return User
*/
protected function findOrNewUser($info)
{
$user = User::where('steamid', $info->steamID64)->first();
if (!is_null($user)) {
return $user;
}
return User::create([
'username' => $info->personaname,
'avatar' => $info->avatarfull,
'steamid' => $info->steamID64
]);
}
}
Should you wish to use a login redirection URL that is differant from the one you specified in the config
// Inside your controller login method
$this->steam->setRedirectUrl(route('login.route'));
...
return $this->steam->redirect();
If you need another steamID you can use another package to convert the given steamID64 to another type like xPaw/SteamID.