Skip to content

v1.0.0

Choose a tag to compare

@loevgaard loevgaard released this 15 Jun 09:44
7d2cb06

First stable release. πŸŽ‰

The library is now considered stable and follows semantic versioning from this point on.

Highlights

  • Targets Meta Graph API v25.0 β€” facebook/php-business-sdk upgraded to ^25.0, so events are posted to https://graph.facebook.com/v25.0/{pixel}/events.
  • Richer error reporting β€” ClientException now surfaces Meta's error_subcode and the user-facing error_user_title / error_user_msg (when present), alongside the message, code, trace id and raw response.
  • Developer-friendly README β€” runnable examples for server-side events, browser-side fbq() generation with server/browser deduplication, custom events, fbc/fbp value objects, bringing your own HTTP client, logging and extending events.

Under the hood

  • Static analysis migrated from Psalm to PHPStan (level: max).
  • Dev tooling modernized and kept installable on PHP 8.1.
  • Verified on PHP 8.1, 8.2, 8.3 and 8.4.

Requirements

Backwards compatibility

  • Removed Client::setResponseFactory() β€” the client never creates responses, so the method had no effect. If you were calling it (e.g. when upgrading from 0.2.x), just drop the call.

Full changelog: v0.2.4...v1.0.0