Looking to hire Laravel developers? Try LaraJobs
This package is not available.

laravel-free-fire maintained by refatbd

Description
Laravel integration for refatbd/free-fire-php.
Last update
2026/09/29 05:12 (dev-main)
License
MIT
Links
GitHub - Packagist
Downloads
15

dev-main

Last update
2026/09/29 05:12
License
MIT
Require
  • php ^8.2
  • illuminate/cache ^11.0 || ^12.0 || ^13.0
  • illuminate/console ^11.0 || ^12.0 || ^13.0
  • illuminate/contracts ^11.0 || ^12.0 || ^13.0
  • illuminate/http ^11.0 || ^12.0 || ^13.0
  • illuminate/routing ^11.0 || ^12.0 || ^13.0
  • illuminate/support ^11.0 || ^12.0 || ^13.0
  • refatbd/free-fire-php ^1.0
v1.1.2

Last update
2026/09/29 05:12
License
MIT
Require
  • php ^8.2
  • illuminate/cache ^11.0 || ^12.0 || ^13.0
  • illuminate/console ^11.0 || ^12.0 || ^13.0
  • illuminate/contracts ^11.0 || ^12.0 || ^13.0
  • illuminate/http ^11.0 || ^12.0 || ^13.0
  • illuminate/routing ^11.0 || ^12.0 || ^13.0
  • illuminate/support ^11.0 || ^12.0 || ^13.0
  • refatbd/free-fire-php ^1.0
v1.1.1

Last update
2026/09/28 07:23
License
MIT
Require
  • php ^8.2
  • illuminate/cache ^11.0 || ^12.0 || ^13.0
  • illuminate/console ^11.0 || ^12.0 || ^13.0
  • illuminate/contracts ^11.0 || ^12.0 || ^13.0
  • illuminate/http ^11.0 || ^12.0 || ^13.0
  • illuminate/routing ^11.0 || ^12.0 || ^13.0
  • illuminate/support ^11.0 || ^12.0 || ^13.0
  • refatbd/free-fire-php ^1.0
v1.1.0

Last update
2026/09/27 17:42
License
MIT
Require
  • php ^8.2
  • illuminate/cache ^11.0 || ^12.0 || ^13.0
  • illuminate/console ^11.0 || ^12.0 || ^13.0
  • illuminate/contracts ^11.0 || ^12.0 || ^13.0
  • illuminate/http ^11.0 || ^12.0 || ^13.0
  • illuminate/routing ^11.0 || ^12.0 || ^13.0
  • illuminate/support ^11.0 || ^12.0 || ^13.0
  • refatbd/free-fire-php ^1.0
v1.0.1

Last update
2026/08/02 03:17
License
MIT
Require
  • php ^8.2
  • illuminate/cache ^11.0 || ^12.0 || ^13.0
  • illuminate/console ^11.0 || ^12.0 || ^13.0
  • illuminate/contracts ^11.0 || ^12.0 || ^13.0
  • illuminate/http ^11.0 || ^12.0 || ^13.0
  • illuminate/routing ^11.0 || ^12.0 || ^13.0
  • illuminate/support ^11.0 || ^12.0 || ^13.0
  • refatbd/free-fire-php ^1.0
v1.0.0

Last update
2026/07/27 17:35
License
MIT
Require
  • php ^8.2
  • illuminate/cache ^11.0 || ^12.0 || ^13.0
  • illuminate/console ^11.0 || ^12.0 || ^13.0
  • illuminate/contracts ^11.0 || ^12.0 || ^13.0
  • illuminate/http ^11.0 || ^12.0 || ^13.0
  • illuminate/routing ^11.0 || ^12.0 || ^13.0
  • illuminate/support ^11.0 || ^12.0 || ^13.0
  • refatbd/free-fire-php ^1.0
Comments
comments powered by Disqus

refatbd/laravel-free-fire

Laravel integration package for the Free Fire player information & official ASTC media rendering engine.

Generated distribution repository: development happens in refatbd/free-fire-php-monorepo. Do not edit the split repository directly.

Version

Latest release: v1.1.2 (rate-limit resilience, safe media fallback & OB55). The previous v1.1.1 release introduced binary-safe media serialization. The package version (vX.Y.Z) is separate from the Free Fire protocol version (OB55). Release tags originate in the canonical monorepo; see its release process.

Installation

composer require refatbd/laravel-free-fire
php artisan vendor:publish --tag=freefire-config
php artisan freefire:media-check

Basic Usage

use Refatbd\LaravelFreeFire\Facades\FreeFire;

// Retrieve player information (JSON array)
$player = FreeFire::player('4422076728', 'BD');

// Access basic info and ranks
echo $player['basicInfo']['nickname']; // ᴛᴀʙᴀꜱꜱᴜᴍ♡ʀ
echo $player['basicInfo']['level'];    // 67

Diagnostic & Media Capability Checker

Run the built-in Artisan diagnostic command to verify ASTC decoding and WebP media capability on your server:

php artisan freefire:media-check

Server Requirements & Media Engine Guidance

Platform / Server Type Recommended Setup
Ubuntu / Debian / VPS sudo apt update && sudo apt install astc-encoder
cPanel / Shared Hosting Leave FREEFIRE_ASTCENC_BINARY=astcenc; the core package auto-detects the bundled Linux decoder when proc_open is enabled
Windows Server / Local Leave FREEFIRE_ASTCENC_BINARY=astcenc; the core package auto-detects the bundled Windows decoder

Graceful Fallback Note: If proc_open is disabled or astcenc is missing on cheap shared hosting, player statistics and JSON API endpoints continue to work 100% reliably. Media rendering automatically degrades to PHP GD gradient graphics without crashing.

Protocol & Configuration

FREEFIRE_ENABLED=true
FREEFIRE_DEFAULT_REGION=BD
FREEFIRE_PROTOCOL=OB55
FREEFIRE_ASTCENC_BINARY=astcenc

API Routes

  • GET /api/free-fire/v1/health
  • GET /api/free-fire/v1/players/{uid}?region=BD
  • GET /api/free-fire/v1/players/{uid}/avatar?region=BD
  • GET /api/free-fire/v1/players/{uid}/banner?region=BD&raw=1 (Clean background mode)
  • GET /api/free-fire/v1/players/{uid}/banner?region=BD (Composited banner graphic mode)

Legacy Compatibility Routes

  • GET /player-info?uid={uid}&region={region}
  • GET /api/avatar/avatar_{uid}.webp
  • GET /api/banner/banner_{uid}.webp