PHPackages                             lucie/ballchasing-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. lucie/ballchasing-sdk

ActiveLibrary[API Development](/categories/api)

lucie/ballchasing-sdk
=====================

Laravel package for Ballchasing.com API integration

10PHP

Since Sep 27Pushed 7mo agoCompare

[ Source](https://github.com/othomation/ballchasing-sdk)[ Packagist](https://packagist.org/packages/lucie/ballchasing-sdk)[ RSS](/packages/lucie-ballchasing-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Ballchasing Laravel SDK
=======================

[](#ballchasing-laravel-sdk)

A Laravel package for integrating with the [Ballchasing.com](https://ballchasing.com) API, providing easy access to Rocket League replay data and analysis.

Features
--------

[](#features)

- ✅ **Replay Management**: List, retrieve, upload, update, and delete replays
- ✅ **Group Management**: Create and manage replay groups
- ✅ **Maps Information**: Get available Rocket League maps
- ✅ **Laravel Integration**: Service provider with dependency injection
- ✅ **Type Safety**: Full PHP 8.2+ type declarations and DTOs
- ✅ **Testing**: Comprehensive test suite with mocked HTTP responses
- ✅ **Error Handling**: Custom exceptions with detailed error messages
- ✅ **Retry Logic**: Automatic retry for server errors

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require lucie/ballchasing-laravel
```

Configuration
-------------

[](#configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag=ballchasing-config
```

Add your Ballchasing API key to your `.env` file:

```
BALLCHASING_API_KEY=your_api_key_here
```

Testing
-------

[](#testing)

### Unit Tests (Mocked)

[](#unit-tests-mocked)

Run unit tests with mocked HTTP responses (no API key required):

```
composer test
# or specifically
composer test-unit
```

### Integration Tests (Real API)

[](#integration-tests-real-api)

For integration testing with the real Ballchasing API:

1. Copy the example environment file:

    ```
    cp .env.testing .env
    ```
2. Add your real API key to `.env`:

    ```
    BALLCHASING_API_KEY=your_real_api_key_here
    ```
3. Run integration tests:

    ```
    composer test-integration
    ```

### Coverage Reports

[](#coverage-reports)

Generate test coverage reports:

```
composer test-coverage
```

Development
-----------

[](#development)

### Code Style

[](#code-style)

Format code using Pint:

```
composer format
```

### Static Analysis

[](#static-analysis)

Run PHPStan analysis:

```
composer analyse
```

### Versioning

[](#versioning)

This package follows [Semantic Versioning](https://semver.org/). To create a new release:

1. Update the version in `composer.json`
2. Run all checks: `composer release`
3. Commit the changes
4. Create a new git tag: `git tag v1.0.0`
5. Push with tags: `git push --tags`

**Note:** Since this is a beta package (0.x.x), the API may change between minor versions until we reach 1.0.0.

Documentation
-------------

[](#documentation)

📖 **Full documentation is available in multiple languages:**

- **English**: [docs/en/usage.md](docs/en/usage.md)
- **Français**: [docs/fr/usage.md](docs/fr/usage.md)

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 10.0+
- Guzzle HTTP 7.0+

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

Support
-------

[](#support)

If you discover any security vulnerabilities, please send an e-mail to .

Credits
-------

[](#credits)

- [Lucie](https://github.com/othomation)
- [Ballchasing.com](https://ballchasing.com) for providing the API

---

Built for the Rocket League community 🚗⚽

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance44

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/ed1d0f144654e53e98ea4eb08bb685255860e7263644c1d6a3dc1c23b714f7b8?d=identicon)[othomation](/maintainers/othomation)

### Embed Badge

![Health badge](/badges/lucie-ballchasing-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/lucie-ballchasing-sdk/health.svg)](https://phpackages.com/packages/lucie-ballchasing-sdk)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)