What's Changed

• Migrate to STAB optics (Iso<S,T,A,B> / Lens<S,T,A,B>) by @veewee in #64

Full Changelog: 0.33.0...0.34.0

What's Changed

• GH-59: Fix ObjectEncoder dropping attributes with falsy values by @ademarco in #60

New Contributors

• @ademarco made their first contribution in #60

Full Changelog: 0.32.0...0.33.0

Upgrade to veewee/xml v4 and PHP 8.4+

This release migrates the package to PHP 8.4's spec-compliant DOM API via veewee/xml ^4.10.

Requirements

• PHP 8.4+ (dropped 8.3 support)
• veewee/xml ^4.10
• Standalone PSL packages ^6.1 (replaces the monolith php-standard-library/php-standard-library)

Breaking Changes

• Element::fromDOMElement() and Element::element() now accept/return Dom\Element instead of DOMElement
• XsiTypeDetector::detectXsdTypeFromXmlElement() and detectEncoderFromXmlElement() accept Dom\Element instead of DOMElement
• ElementValueReader methods accept Dom\Element instead of DOMElement
• SOAP 1.2 fault detail serialization may produce namespace declarations in a different order (alphabetical, per the new DOM spec)

Dependency Bumps

DOM Migration Details

• All legacy DOMDocument, DOMElement, DOMNode, DOMAttr type hints replaced with Dom\ namespace equivalents
• Deprecated Document::configure(loader(...)) replaced with Document::fromLoader()
• getAttribute() / getAttributeNS() now return null instead of '' for missing attributes (handled throughout)
• textContent is now ?string (null-guarded in fault encoders)
• ownerDocument access uses assert_document() (returns ?Dom\Document, not ?Dom\XMLDocument)
• DOM stubs added to psalm.xml for static analysis support

Performance

Encoding (PHP values to XML) is 12-16% faster, and memory usage dropped ~7% across the board.

Decoding (XML to PHP values) shows a small regression in SOAP encoded mode:

The encoded decode regression is caused by PHP 8.4's new Dom\ implementation being marginally slower per-operation on XPath queries (+22%), node iteration (+11%), and XML parsing (+2%). These small differences compound through the encoded decode path, which performs ~2x more DOM interactions than literal mode (xsi:type attribute reads, namespace resolution on every element). This is a PHP engine characteristic, not something fixable at the library level, and may improve in future PHP releases. (/cc @ndossche)

In real-world usage, the encoded decode overhead translates to roughly 15-20 microseconds per decoded message, which is negligible compared to network latency.

What's Changed

• Migrate to veewee/xml v4 and PHP 8.4+ by @veewee in #58

Full Changelog: 0.31.0...0.32.0

What's Changed

• Backport: Fix ObjectEncoder dropping attributes with falsy values by @veewee in #62

Full Changelog: 0.31.0...0.31.1

Performance Release

This release focuses entirely on encoding/decoding performance. No breaking changes.

What changed

A series of targeted caching improvements were introduced across the encoder pipeline. Each fix eliminates redundant object construction on repeated calls to iso() within a single request.

Merged PRs

Bumping veewee/reflecta to ^0.17 also contributes a small improvement via a properties_set clone-once optimization (reflecta#26).

Benchmark results

Benchmarks run with phpbench on PHP 8.4, using a complex SOAP type with nested objects. WSDL parsing is excluded from measurements (@BeforeMethods). The baseline is the commit where benchmarks were introduced (before any optimizations).

Encoding

Decoding

Comparison with ext-soap

For context, ext-soap (C extension) measured on the same machine:

The gap vs ext-soap is expected: php-soap/encoding operates at the PHP level and provides full type-safety and WSDL-driven encoding as a pure PHP implementation.

Upgrade notes

• Minimum veewee/reflecta version bumped to ^0.17.
• No changes to public API. Drop-in upgrade.
• The new ScopedCache class (Soap\Encoding\Cache\ScopedCache) is @internal.

What's Changed

• Add phpbench benchmarks with CI regression detection by @veewee in #51
• Cache inner iso in XsiTypeEncoder by @veewee in #52
• Cache type iso in ElementEncoder, refactor value builder/reader by @veewee in #53
• Cache type iso in AttributeValueEncoder by @veewee in #55
• Cache xsi:type encoder detection in XsiTypeDetector by @veewee in #56
• Cache ObjectAccess::forContext() using ScopedCache by @veewee in #57

Full Changelog: 0.30.0...0.31.0

What's Changed

• Fix duplicate xmlns attributes on qualified elements with xsi:type by @veewee in #50

Full Changelog: 0.29.0...0.30.0

What's Changed

• Fix xsi:type namespace resolution for server-side prefixes by @veewee in #49
• Fix base64Binary decoding for unpadded and whitespace-containing input by @veewee in #47

Full Changelog: 0.28.0...0.29.0

What's Changed

• Replace azjezz/psl with php-standard-library/php-standard-library by @veewee in #45

Full Changelog: 0.27.0...0.28.0

What's Changed

• feat: Update azjezz/psl requirement to include version 5.0 by @EJTJ3 in #44

New Contributors

• @EJTJ3 made their first contribution in #44

Full Changelog: 0.26.0...0.27.0

What's Changed

• Allow configuration of libxml options for decoding XML by @veewee in #43

Full Changelog: 0.25.0...0.26.0