Download the PHP package blob-solutions/laravel-vcr-am without Composer
On this page you can find all versions of the php package blob-solutions/laravel-vcr-am. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download blob-solutions/laravel-vcr-am
More information about blob-solutions/laravel-vcr-am
Files in blob-solutions/laravel-vcr-am
Package laravel-vcr-am
Short Description Official Laravel adapter for the VCR.AM Virtual Cash Register PHP SDK — ServiceProvider, Facade, config publishing, and Artisan commands.
License ISC
Homepage https://vcr.am
Informations about the package laravel-vcr-am
Laravel adapter for the VCR.AM PHP SDK
A thin Laravel adapter around blob-solutions/vcr-am-sdk. Wires the SDK's VcrClient into Laravel's container, publishes a config file, exposes a facade, and registers an Artisan health-check command.
The adapter contains zero business logic — every API call goes straight through to the SDK. If the SDK supports it, the adapter exposes it.
Requirements
- PHP 8.2 or newer
- Laravel 11.x or 12.x
- A VCR.AM account and API key — sign up at vcr.am
Installation
The service provider and facade are auto-discovered.
Add your API key to .env:
That's it — the package is ready to use.
Configuration
To customise the configuration (e.g. point at a staging environment), publish the config file:
This creates config/vcr-am.php:
Usage
Via the facade
Via dependency injection
VcrClient is bound as a singleton, so the same instance is reused for the lifetime of every request.
Via the container
Health check
To verify connectivity from a running app or as part of your deployment pipeline:
Exit code is 0 on success, 1 on failure (with the SDK's error message printed).
Logging
The package forwards Laravel's PSR-3 logger into the SDK automatically. Every request and response is logged at the level configured in your config/logging.php. To filter only VCR.AM log entries, give the SDK its own channel:
HTTP client override
The SDK ships with Guzzle 7 by default. To swap it (e.g. for testing or to use a shared HTTP client with custom retry policies), bind a PSR-18 implementation in your AppServiceProvider:
The adapter detects this binding and passes it into the SDK constructor.
Documentation for SDK methods
See the SDK README for every endpoint, every input DTO, and every response type. The Laravel adapter is a 1:1 wrapper — anything documented for VcrClient works through the facade or container binding.
Status
Pre-release. API tracks the SDK's
0.xreleases. Pin tightly until1.0.
License
ISC
All versions of laravel-vcr-am with dependencies
ext-json Version *
blob-solutions/vcr-am-sdk Version ^0.6.0
illuminate/console Version ^11.0 || ^12.0 || ^13.0
illuminate/contracts Version ^11.0 || ^12.0 || ^13.0
illuminate/support Version ^11.0 || ^12.0 || ^13.0
spatie/laravel-package-tools Version ^1.16