bubblehearth/bubblehearth

Blizzard API bindings for PHP.

dev-main 2024-01-23 05:15 UTC

Requires

• php: >=8.3
• doctrine/annotations: ^2.0
• guzzlehttp/guzzle: ^7.8
• illuminate/collections: ^10.37
• league/oauth2-client: ^2.7
• nesbot/carbon: ^2.72
• symfony/property-access: ^6.3 || ^7.0
• symfony/serializer: ^6.3 || ^7.0

Requires (Dev)

• laravel/pint: ^1.13
• pestphp/pest: ^2.28
• pestphp/pest-plugin-type-coverage: ^2.2.0
• pestphp/pest-plugin-watch: ^2.0
• phpstan/phpstan: ^1.10

MIT

• Joey McKenzie

README

PHP bindings for Blizzard's Game Data APIs!

Overview

The BubbleHearth is a convenient and easy-to-use PHP wrapper for accessing the Blizzard Game Data APIs. It simplifies the process of making requests to various Blizzard game data endpoints, allowing developers to seamlessly integrate Blizzard game data into their PHP applications.

Features

• Ease of Use: Simple and intuitive interface for interacting with Blizzard Game Data APIs.
• Authentication: Handles OAuth 2.0 authentication with Blizzard, making it easy to access secure endpoints.
• Multiple Endpoints: Supports multiple game data endpoints, including World of Warcraft, Diablo, Hearthstone, and more.

Installation

Install the BubbleHearth PHP Library using Composer:

composer require bubblehearth/bubblearth

Usage

<?php

use BubbleHearth\BubbleHearth;

// Initialize the library with your Blizzard API credentials
$clientId = (string) getenv('CLIENT_ID');
$clientSecret = (string) getenv('CLIENT_SECRET');
$client = new BubbleHearthClient($clientId, $clientSecret, AccountRegion::US, Locale::EnglishUS);

// Get World of Warcraft Classic realm data
$regions = $client
    ->classic()
    ->regions()
    ->getRegionIndex();
    
var_dump($characterData);

?>