Download the PHP package syntax/steam-api without Composer

On this page you can find all versions of the php package syntax/steam-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package steam-api

Steam API

Join the chat at https://gitter.im/syntaxerrors/Steam

Unit Tests Maintainability Latest Stable Version Total Downloads License

Version Support
Laravel >= 10.0
PHP >= 8.1

This package provides an easy way to get details from the Steam API service. The services it can access are:

Installation

Begin by installing this package with composer.

"require": {
    "syntax/steam-api": "3.*"
}

Next, update composer from the terminal.

composer update syntax/steam-api

Alternately, you can run "composer require syntax/steam-api:dev-master" from the command line.

Lastly, publish the config file. You can get your API key from Steam.

php artisan vendor:publish --provider="Syntax\SteamApi\SteamApiServiceProvider"

Usage

Each service from the Steam API has its own methods you can use.

Global

These are methods that are available to each service.

convertId

This will convert the given steam ID to each type of steam ID (64 bit, 32 bit and steam ID3).

Arguments
Name Type Description Required Default
id string The id you want to convert Yes
format string The format you want back. No null

Possible formats are ID64, id64, 64, ID32, id32, 32, ID3, id3 and 3.

Example usage

Example Output: convertId

News

The Steam News web api is used to get articles for games.

GetNewsForApp

This method will get the news articles for a given app ID. It has three parameters.

Arguments
Name Type Description Required Default
appId int The id for the app you want news on Yes
count int The number of news items to return No 5
maxlength int The maximum number of characters to return No null
Example usage

Example Output: GetNewsForApp

Player

The Player Service is used to get details on players.

When instantiating the player class, you are required to pass a steamId or Steam community ID.

GetSteamLevel

This method will return the level of the Steam user given. It simply returns the integer of their current level.

Example Output: GetSteamLevel

GetPlayerLevelDetails

This will return a Syntax\Containers\Player_Level object with full details for the players level.

Example Output: GetPlayerLevelDetails

GetBadges

This call will give you a list of the badges that the player currently has. There is currently no schema for badges, so all you will get is the ID and details.

Example Output: GetBadges

GetOwnedGames

GetOwnedGames returns a list of games a player owns along with some playtime information, if the profile is publicly visible. Private, friends-only, and other privacy settings are not supported unless you are asking for your own personal details (i.e. the WebAPI key you are using is linked to the steamID you are requesting).

Arguments
Name Type Description Required Default
includeAppInfo boolean Whether or not to include game details No true
includePlayedFreeGames boolean Whether or not to include free games No false
appIdsFilter array An array of appIds. These will be the only ones returned if the user has them No array()

Example Output: GetOwnedGames

GetRecentlyPlayedGames

GetRecentlyPlayedGames returns a list of games a player has played in the last two weeks, if the profile is publicly visible. Private, friends-only, and other privacy settings are not supported unless you are asking for your own personal details (i.e. the WebAPI key you are using is linked to the steamID you are requesting).

Arguments
Name Type Description Required Default
count int The number of games to return No null

Example Output: GetRecentlyPlayedGames

IsPlayingSharedGame

IsPlayingSharedGame returns the original owner's SteamID if a borrowing account is currently playing this game. If the game is not borrowed or the borrower currently doesn't play this game, the result is always 0.

Arguments
Name Type Description Required Default
appId int The game to check for Yes

Example Output: IsPlayingSharedGame

User

The User WebAPI call is used to get details about the user specifically.

When instantiating the user class, you are required to pass at least one steamId or steam community ID.

ResolveVanityURL

This will return details on the user from their display name.

Arguments
Name Type Description Required Default
displayName string The display name to get the steam ID for. In http://steamcommunity.com/id/gabelogannewell it would be gabelogannewell. Yes NULL

Example Output: ResolveVanityURL

GetPlayerSummaries

This will return details on one or more users.

Arguments
Name Type Description Required Default
steamId int[] An array of (or singular) steam ID(s) to get details for No Steam ID passed to user()

Example Output: GetPlayerSummaries

GetFriendList

Returns the friend list of any Steam user, provided his Steam Community profile visibility is set to "Public".

Arguments
Name Type Description Required Default
relationship string (all or friend) The type of friends to get No all
summaries bool (true or false) To return the friend player summaries, or only steamIds No true

Once the list of friends is gathered, if summaries is not set to false; it is passed through GetPlayerSummaries. This allows you to get back a collection of Player objects.

Example Output: GetFriendList

GetPlayerBans

Returns the possible bans placed on the provided steam ID(s).

Arguments
Name Type Description Required Default
steamId int[] An array of (or singular) steam id(s) to get details for No Steam id passed to user()

Example Output: GetPlayerBans

User Stats

The User Stats WebAPI call is used to get details about a user's gaming.

When instantiating the user stats class, you are required to pass a steamID or Steam community ID.

GetPlayerAchievements

Returns a list of achievements for this user by app ID.

Arguments
Name Type Description Required Default
appId int The id of the game you want the user's achievements in Yes

Example Output: GetPlayerAchievements

GetGlobalAchievementPercentagesForApp

This method will return a list of all achievements for the specified game and the percentage of all users that have unlocked each achievement.

Arguments
Name Type Description Required Default
appId int The ID of the game you want the user's achievements in Yes

Example Output: GetGlobalAchievementPercentagesForApp

GetUserStatsForGame

Returns a list of achievements for this user by app ID.

Arguments
Name Type Description Required Default
appId int The ID of the game you want the user's achievements in Yes
all boolean If you want all stats and not just the achievements set to true. No FALSE

Example Output: GetUserStatsForGame (all)

GetSchemaForGame

Returns a list of game details, including achievements and stats.

Arguments
Name Type Description Required Default
appId int The ID of the game you want the details for. Yes

Example Output: GetSchemaForGame

App

This area will get details for games.

appDetails

This gets all the details for a game. This is most of the information from the store page of a game.

Arguments
Name Type Description Required Default
appIds int[] The ids of the games you want details for Yes
cc string The cc is the country code, you can get appropriate currency values according to ISO 3166-1 No
l string The l is the language parameter, you can get the appropriate language according to ISO 639-1 No

Example Output: appDetails

GetAppList

This method will return an array of app objects directly from Steam. It includes the appID and the app name.

Example Output: GetAppList

Package

This method will get details for packages.

packageDetails

This gets all the details for a package. This is most of the information from the store page of a package.

Arguments
Name Type Description Required Default
packIds int[] The ids of the packages you want details for Yes
cc string The cc is the country code, you can get appropriate currency values according to ISO 3166-1 No
l string The l is the language parameter, you can get the appropriate language according to ISO 639-1 (If there is one) No

Example Output: packageDetails

Item

This method will get user inventory for item.

GetPlayerItems

This gets all the item for a user inventory.

Arguments
Name Type Description Required Default
appId int The appid of the game you want for Yes
steamid int The steamid of the Steam user you want for Yes

⚠️ Now known to supports:440, 570, 620, 730, 205790, 221540, 238460

Example Output: GetPlayerItems

Group

This service is used to get details on a Steam group.

GetGroupSummary

This method will get the details for a group.

Arguments
Name Type Description Required Default
group string or int The ID or the name of the group. Yes
Example usage

Example Output: GetGroupSummary

Testing the Steam Package

A Steam API key must be provided or most tests will fail.

Run Tests

Contributors


All versions of steam-api with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
laravel/framework Version ^10.0|^11.0
guzzlehttp/guzzle Version ^7.8
ext-bcmath Version *
ext-simplexml Version *
ext-libxml Version *
ext-curl Version *
ext-json Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package syntax/steam-api contains the following files

Loading the files please wait ....