minishlink/web-push

Migration

WebPush now depends on standard interfaces instead of Guzzle directly. Any PSR-18 client now works.

If you already have guzzlehttp/guzzle installed and call new WebPush(...) with no client-related arguments: no code changes needed. php-http/discovery auto-detects Guzzle and uses it. If you use flushPooled(), you now need one extra package, see below.

If you pass the old $timeout / $clientOptions constructor arguments, you must update that call.

Constructor signature change

Before:

public function __construct(
      array $auth = [],
      array $defaultOptions = [],
      ?int $timeout = 30,
      array $clientOptions = [],
      ?LoggerInterface $logger = null
)

After:

public function __construct(
      array $auth = [],
      array $defaultOptions = [],
      ?ClientInterface $client = null,          // PSR-18
      ?RequestFactoryInterface $requestFactory = null, // PSR-17
      ?StreamFactoryInterface $streamFactory = null,   // PSR-17
      ?HttpAsyncClient $asyncClient = null,     // HTTPlug, optional, only needed for flushPooled()
      ?LoggerInterface $logger = null
)

$timeout and $clientOptions are replaced by configuring your client instance directly:

Before:

$timeout = 20;
$clientOptions = [\GuzzleHttp\RequestOptions::ALLOW_REDIRECTS => false];
$webPush = new WebPush([], [], $timeout, $clientOptions);

After:

$client = new \GuzzleHttp\Client([
      'timeout' => 20,
      \GuzzleHttp\RequestOptions::ALLOW_REDIRECTS => false,
]);
$webPush = new WebPush([], [], $client);

If you were relying on the default (new WebPush()), nothing changes.

Keeping flushPooled() concurrency

flushPooled() used Guzzle's Pool for real concurrent requests. PSR-18 has no concept of concurrency, so this now requires an HTTPlug async client: composer require php-http/guzzle7-adapter (if you use guzzle)

The requestConcurrency option is no longer used, HTTPlug async clients manage their own concurrency (e.g. php-http/guzzle7-adapter delegates to Guzzle's MultiCurl handler).

Using a different PSR-18 client entirely

composer remove guzzlehttp/guzzle
composer require symfony/http-client nyholm/psr7

$psr18Client = new \Symfony\Component\HttpClient\Psr18Client();
$webPush = new WebPush([], [], $psr18Client, $psr18Client, $psr18Client);

For concurrent sending with a non-Guzzle stack (flushPooled), check the php-http adapter list for an HTTPlug adapter matching your client; otherwise use flush().

What's Changed

• (breaking) feat: use PSR-18 http interface (or http async) by @Minishlink in #458
• Cast TTL option to string in headers to avoid Guzzle deprecation warnings by @maciek-szn in #456

New Contributors

• @maciek-szn made their first contribution in #456

Full Changelog: v10.1.0...v11.0.0

What's Changed

• feat: return static on Subscription::create() by @bitwise-operators in #453
• feat: support PSR-3 logger in requirement checks (#451) by @la-refactory in #452

New Contributors

• @bitwise-operators made their first contribution in #453
• @la-refactory made their first contribution in #452

Full Changelog: v10.0.3...v10.1.0

What's Changed

• fix: base 64 errors introduced in v10.0.2. See #449

Full Changelog: v10.0.2...v10.0.3

What's Changed

• fix: EC key generation for OpenSSL 3.6+ by @eyupcanakman in #448
• chore: use code style PER Coding Style 3.0 by @Rotzbua in #436
• chore: use more explicit error handling with json_encode by @Rotzbua in #437
• chore: improve VAPID config doc and type hints by @Rotzbua in #443
• chore: add override by @Rotzbua in #439
• chore: add PHPStan extensions by @Rotzbua in #440
• chore: use base64 fn from web-token/jwt-library by @Rotzbua in #438
• chore: bump actions/cache from 4 to 5 in the github-actions group by @dependabot[bot] in #444
• chore: show OpenSSL version in CI by @Rotzbua in #446

New Contributors

• @eyupcanakman made their first contribution in #448

Full Changelog: v10.0.1...v10.0.2

What's Changed

• feat: convert contentEncoding to typesafe enum by @Rotzbua in #423

Full Changelog: v10.0.0...v10.0.1

What's Changed

⚠️ Breaking changes

• Drop support for PHP 8.1

PRs

• chore: drop php8.1; add php8.5 by @Rotzbua in #435

Full Changelog: v9.0.4...v10.0.0

What's Changed

• fix: option for concurrency not working by @Rotzbua in #426
• feat: hide sensitive parameters in stack traces by @Rotzbua in #425
• chore: add php8.4 tests in CI by @Rotzbua in #421
• chore: remove ignored error in phpstan by @Rotzbua in #424
• chore: update php-cs-fixer by @Minishlink in #434

Full Changelog: v9.0.3...v9.0.4

What's Changed

• feat: add contentType option by @wapacro in #433
• chore: upgrade dev dependencies by @Rotzbua in #418
• chore: migrate from phpdocs to attributes by @Rotzbua in #419
• chore: use strict assert by @Rotzbua in #420

New Contributors

• @wapacro made their first contribution in #433

Full Changelog: v9.0.2...v9.0.3

What's Changed

• Fix typing and syntax tests by @Minishlink in #415
• Fix private VAPID key padding when importing from PEM by @GribouilleVert in #414

New Contributors

• @GribouilleVert made their first contribution in #414

Full Changelog: v9.0.1...v9.0.2

What's Changed

• Fix exception in rejected callback for HTTP connection errors when using flushPooled by @sleptor in #410

Full Changelog: v9.0.0...v9.0.1