Releases · eustasy/browning

31 May 15:38

d6cc9a0

Browning v1.31 Latest

Latest

A ground-up rewrite from a single global function into a small, namespaced, dependency-injected library. This is a breaking release : the Browning() / Recaptcha_Verify() functions and the global $Browning config are gone, replaced by classes you construct with your config.

⚠️ Breaking changes

Requires PHP 8.1+ (was 7.4). Now declares ext-curl (was lib-curl).
No more global functions or global $Browning — configuration is injected into classes instead.
PSR-4 autoloading under Eustasy\Browning\ (replaces the files autoloader).
The config file now returns an array instead of populating globals.
Installs as composer require eustasy/browning.

Migration

Sending email

// Before (v0.30)
require 'config/browning.php';                 // set global $Browning
$mail = Browning('to@example.com', 'Subject', 'Body');
if ($mail['Success']) { /* ... */ }

// After (v1.31)
use Eustasy\Browning\Mailer;
$config = require 'config/browning.php';        // returns an array
$result = Mailer::fromArray($config)->send('to@example.com', 'Subject', 'Body');
if ($result->success) { /* ... */ } else { echo $result->error; }

reCAPTCHA

// Before
$v = Recaptcha_Verify($secret, $_POST['g-recaptcha-response'], $_SERVER['REMOTE_ADDR']);
if ($v['Success']) { /* ... */ }

// After
use Eustasy\Browning\Recaptcha;
$v = Recaptcha::fromArray($config)->verify($_POST['g-recaptcha-response'] ?? null, $_SERVER['REMOTE_ADDR'] ?? null);
if ($v->success) { /* ... */ }

✨ What's new

New Mailer and Recaptcha classes with typed value-object results (Result, RecaptchaResult) ->success, ->error, ->errorCodes.
A Transport interface + default CurlTransport: the cURL call is injectable, so it can be swapped (e.g. for tests) without touching the network.
Mailer::fromArray() / Recaptcha::fromArray() build straight from the config array.
Friendly-vs-technical error messages via a debug flag (Mailer::fromArray($config, debug: true)).

🧪 Quality

New PHPUnit suite (23 tests) : logic unit-tested through a fake transport, plus a real-cURL integration test.
Fully type-hinted; PHPStan-clean through max.
The Test (PHP) workflow is enabled (PHP 8.3–8.6, coverage to Qlty).