Download the PHP package manujoz/iracing-api-sdk-php without Composer
On this page you can find all versions of the php package manujoz/iracing-api-sdk-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package iracing-api-sdk-php
๐ฏ What is this?
iracing-api-sdk-php is a zero-dependency PHP SDK that provides primitives for:
- OAuth2 Authentication: Password Limited, Authorization Code + PKCE, token refresh
- Data API Client: Access to iRacing's Data API (with typed generated services)
- Session Management: List and revoke OAuth2 sessions
- Security First: Credential masking, safe auth header forwarding, secure file caches
It is framework-agnostic by design: you bring your own logger and storage, while the library focuses on secure OAuth flows, token handling, and HTTP interactions.
โจ Features
- โ Zero runtime dependencies - Pure PHP at runtime
- โ Security built-in - Never logs secrets, credential masking utilities
- โ OAuth2 complete - Password Limited, Authorization Code + PKCE, token refresh
- โ
Typed services - Generated service wrappers under
IracingApiSdk\Data\Services\* - โ Flexible storage - File-based storage + interfaces for custom implementations
- โ Production friendly - Explicit error handling, rate limit utilities, and tests
๐ฆ Installation
๐ Quick Start
1. Configure Environment
Create a local .env from .env.example and set your iRacing OAuth credentials.
2. Authenticate & Access Data
The repository ships runnable CLI examples. Recommended first run:
Minimal bootstrap (same classes used by the examples):
๐ Documentation
Core Guides
| Guide | Description |
|---|---|
| ๐ Documentation Index | Complete documentation overview |
| โ๏ธ Configuration | Environment variables and config setup |
| ๐ OAuth Flows | Authentication methods and token management |
| ๐ก Data API | Accessing iRacing Data API with typed services |
| ๐ Security | Security features and best practices |
Advanced Topics
| Guide | Description |
|---|---|
| ๐ Sessions | OAuth2 session management and revocation |
| ๐ฏ Data Services | Generated typed service wrappers |
| ๐ง Integration | Production application patterns |
| ๐งช Testing | Unit and integration testing guide |
Examples
See examples/ for runnable code samples:
- OAuth2 authentication flows
- Token refresh patterns
- Data API calls
- Session management
๐ก๏ธ Security
This SDK follows strict security practices:
- Never logs secrets - Client secrets, passwords, and tokens must never be logged
- Credential masking - Helpers for iRacing's password masking requirements
- Authorization header protection - Auth headers are forwarded only to trusted origins
- Secure file storage - Token/session caches should be stored with restrictive permissions
See Security Documentation for details.
๐งช Development
Prerequisites
- PHP โฅ 8.3
- Composer
Commands
Integration tests are opt-in and only run when IRACING_RUN_INTEGRATION=1 is set (and valid credentials exist in .env).
Project Structure
๐ค Contributing
Please see CONTRIBUTING.md for:
- Development workflow
- Code standards
- Testing requirements
- Commit message format
- Pull request process
๐ License
MIT ยฉ Manu Overa
See LICENSE for details.
All versions of iracing-api-sdk-php with dependencies
ext-curl Version *
ext-json Version *
ext-hash Version *