xpaw / steamid
SteamID conversion library
Installs: 70 838
Dependents: 11
Suggesters: 1
Security: 0
Stars: 145
Watchers: 15
Forks: 18
Open Issues: 0
Requires
- php: >=8.1
- ext-gmp: *
Requires (Dev)
- phpstan/phpstan: ^1.10
- phpunit/phpunit: ^10.3
This package is auto-updated.
Last update: 2024-11-02 16:32:49 UTC
README
This 64bit structure is used for identifying various objects on the Steam network. This library provides an easy way to work with SteamIDs and makes conversions easy.
This library does not use subtraction hacks like described on Valve Developer Wiki, or used in many other functions.
SteamID.php requires modern PHP version, and GMP module to be installed to perform operations 64-bit math.
Brief overview
A SteamID is made up of four parts: its universe, its type, its instance, and its account ID.
- Universe: Currently there are 5 universes. A universe is a unique instance of Steam. You'll probably only be interacting with the public universe, which is the regular Steam. Only Valve employees can access non-public universes.
- Type: A SteamID's type determines what it identifies. The most common type is individual, for user accounts. There are also other types such as clans (Steam groups), gameservers, and more.
- Instance: Steam allows three simultaneous user account instances right now (1 = desktop, 2 = console, 4 = web, 0 = all)
- Account ID: This represents a unique account of a type.
Using this library
It's really easy to use it, as constructor automatically figures out given input
and works its magic from there. If provided SteamID is not in a valid format, an
InvalidArgumentException
is thrown. You can call IsValid
on given SteamID
instance to perform various checks which make sure that given account type /
universe / instance are correct. You can view test file for
multiple examples on how to manipulate SteamIDs.
Example
use xPaw\Steam\SteamID; try { // Constructor also accepts Steam3 and Steam2 representations $s = new SteamID( '76561197984981409' ); } catch( InvalidArgumentException $e ) { echo 'Given SteamID could not be parsed.'; } // Renders SteamID in it's Steam3 representation (e.g. [U:1:24715681]) echo $s->RenderSteam3() . PHP_EOL; // Renders SteamID in it's Steam2 representation (e.g. STEAM_0:1:12357840) echo $s->RenderSteam2() . PHP_EOL; // Converts this SteamID into it's 64bit integer form (e.g. 76561197984981409) echo $s->ConvertToUInt64() . PHP_EOL;
Also see VanityURLs.php
for parsing any user input including URLs.
If you're going to process user input, SteamID::SetFromURL()
is all you need to use.
SteamID normalization
If you run some website where users can enter their own SteamIDs, sometimes you might encounter SteamIDs which have wrong universe or instanceid set, which will result in a completely different, yet valid, SteamID. To avoid this, you can manipulate given SteamID and set universe to public and instance to desktop.
use xPaw\Steam\SteamID; try { $s = new SteamID( $ID ); if( $s->GetAccountType() !== SteamID::TypeIndividual ) { throw new InvalidArgumentException( 'We only support individual SteamIDs.' ); } else if( !$s->IsValid() ) { throw new InvalidArgumentException( 'Invalid SteamID.' ); } $s->SetAccountInstance( SteamID::DesktopInstance ); $s->SetAccountUniverse( SteamID::UniversePublic ); var_dump( $s->RenderSteam3() ); // [U:1:24715681] var_dump( $s->ConvertToUInt64() ); // 76561197984981409 } catch( InvalidArgumentException $e ) { echo $e->getMessage(); }
After doing these steps, you can call RenderSteam3
, RenderSteam2
or
ConvertToUInt64
to get normalized SteamID.
See Example.php
for a fully fledged example.
Functions
New Steam invite URLs
Valve introduce a new way of sharing profile URLs (https://s.team/p/hjqp or https://steamcommunity.com/user/hjqp). The encoding is simply hex encoded account id and each letter being replaced with a custom alphabet. While HEX originally is 0-9a-f
, in the converted version numbers and letters a
or e
are not included, but they still work in the URL because Valve does a single pass replacement.
This library natively supports parsing s.team/p/
or steamcommunity.com/user/
URLs in SetFromURL
function.
Here's the mapping of replacements: