Download the PHP package timmsy/piltover-client without Composer
On this page you can find all versions of the php package timmsy/piltover-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package piltover-client
๐ง PiltoverClient
A PHP / Laravel-ready API wrapper for the Riot Games Developer API, built by Timmsy.
๐ Overview
PiltoverClient is a lightweight, framework-agnostic API client for the Riot Games Developer API. It integrates seamlessly with Laravel but can also be used in any PHP project.
The client implements the modern Riot API flow:
- ๐น Resolve players via account-v1 using their Riot ID (
gameName+tagLine) - ๐น Use PUUID to fetch summoner profiles, matches, and more
- ๐น Automatically maps platform โ regional clusters (EUW โ EUROPE, NA โ AMERICAS, etc.)
- ๐น Provides Laravel Facade + helper for elegant usage
- ๐น Fully PSR-compliant, Guzzle-powered
โ๏ธ Installation
๐งฉ Laravel Setup
If you're using Laravel, PiltoverClient auto-discovers its service provider and facade.
Publish Configuration
Add to .env
๐ป Usage Examples
๐ธ Laravel Facade
๐ธ Standalone PHP
๐งญ Supported Endpoints
| Endpoint | Scope | Method | Description |
|---|---|---|---|
/riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine} |
Regional | accountByRiotId() |
Get player account and PUUID |
/lol/summoner/v4/summoners/by-puuid/{puuid} |
Platform | summonerByPuuid() |
Get Summoner info |
/lol/match/v5/matches/by-puuid/{puuid}/ids |
Regional | matchesByPuuid() |
Get recent match IDs |
/lol/match/v5/matches/{matchId} |
Regional | matchById() |
Get full match details |
๐งฐ Helpers
๐งช Testing
Includes PHPUnit + Orchestra Testbench for Laravel context tests.
โ๏ธ Config File (config/piltover.php)
๐ API Documentation
PiltoverClient includes a built-in OpenAPI 3.1 specification and ReDoc-powered documentation viewer. This allows developers to explore all supported Riot Games API endpoints visually.
๐ง Laravel Integration
Once installed in a Laravel app, the docs are automatically available at:
- ReDoc UI:
/piltover/docs - Raw Spec:
/piltover/docs/openapi.json
Configure in config/piltover.php or .env:
Optional authentication:
๐งฉ Standalone Mode
PiltoverClient also ships with a local static docs server:
Visit: http://127.0.0.1:8765/docs/
This uses the same OpenAPI spec from resources/openapi/.
๐ง OpenAPI Overview
The included spec documents:
| Endpoint | Scope | Method | Description |
|---|---|---|---|
/riot/account/v1/accounts/by-riot-id/{gameName}/{tagLine} |
Regional | GET | Retrieve account + PUUID by Riot ID |
/lol/summoner/v4/summoners/by-puuid/{puuid} |
Platform | GET | Fetch Summoner profile by PUUID |
/lol/match/v5/matches/by-puuid/{puuid}/ids |
Regional | GET | List recent matches by PUUID |
/lol/match/v5/matches/{matchId} |
Regional | GET | Retrieve match details |
๐งพ Notes
- Works both in Laravel and standalone PHP contexts.
- Fully PSR-4 compliant โ no runtime dependencies beyond
illuminate/supportandguzzle. - You can extend the
resources/openapi/openapi.yamlspec as you add endpoints.
๐ฆ Future Roadmap
- [ ] Add all Riot endpoints (League, Spectator, Champion)
- [ ] Rate-limit & retry middleware
- [ ] Data Dragon (champions, icons, maps)
- [ ] Cached responses
- [ ] CLI utilities for dev testing
๐ License
MIT License ยฉ 2025 James Timms Created and maintained by @Timmsy1998
All versions of piltover-client with dependencies
guzzlehttp/guzzle Version ^7.8 || ^8.0
illuminate/support Version ^10.0 || ^11.0 || ^12.0
illuminate/config Version ^10.0 || ^11.0 || ^12.0
illuminate/view Version ^10.0 || ^11.0 || ^12.0
illuminate/routing Version ^10.0 || ^11.0 || ^12.0