Skip to content

Version 3.0.0

Latest
Latest

Choose a tag to compare

View all tags
@veewee veewee released this 27 Mar 14:47
· 1 commit to main since this release
3.0.0
This tag was signed with the committer’s verified signature.
veewee Toon Verwerft
GPG key ID: AA36B9960B5B823D
Verified
Learn about vigilant mode.
ef19b69

Breaking changes

  • PHP 8.4+ required (dropped 8.3)
  • WsseEntry interface: __invoke() first parameter changed from VeeWee\Xml\Dom\Document to \DOMDocument
  • KeyIdentifier interface: __invoke() first parameter changed from VeeWee\Xml\Dom\Document to \DOMDocument
  • SamlAssertion constructor: takes \DOMDocument instead of VeeWee\Xml\Dom\Document
  • WssePreset: no longer implements veewee/xml's Configurator interface; use WssePreset::xpath(\DOMDocument) instead
  • Locators (SecurityLocator, BinaryTokenLocator, SignatureLocator, EncryptedKeyLocator): accept \DOMDocument, return \DOMElement
  • CustomKeyIdentifier / ReferencingKeyIdentifier: build nodes via native \DOMDocument API (veewee builders removed)
  • veewee/xml removed as a direct dependency (still available transitively via php-soap/xml)

Dependency upgrades

  • php-soap/psr18-transport: ^1.8 -> ^2.0
  • php-soap/engine: ^2.16 -> ^2.20
  • php-soap/xml: ^1.9 -> ^1.10
  • php-http/client-common: ^2.3 -> ^2.7
  • PSL: replaced php-standard-library/php-standard-library with standalone packages (^6.1)

Why the legacy DOM switch?

robrichards/wse-php operates on legacy \DOMDocument. In veewee/xml v3, the Document wrapper shared the same underlying \DOMDocument, so it worked transparently. In v4, Document wraps Dom\XMLDocument (PHP 8.4's new DOM), which has no shared state with legacy DOM. Every bridge requires an XML round-trip. Since all WSSE/WSA operations flow through robrichards, the wrapper added overhead with no benefit. The package now works directly with legacy \DOMDocument.

Upgrading

  1. Require PHP 8.4+
  2. Custom WsseEntry implementations: change Document $envelope to \DOMDocument $envelope
  3. Custom KeyIdentifier implementations: change Document $envelope to \DOMDocument $envelope
  4. SamlAssertion: pass a \DOMDocument instead of VeeWee\Xml\Dom\Document
  5. If you used WssePreset as a veewee Configurator: use WssePreset::xpath($doc) instead
  6. If you read element text via ->nodeValue: use ->textContent (new DOM spec)

Full Changelog: 2.9.0...3.0.0

Assets 2
Loading