Reader::parse() and Service::parse() return different values

[kamilszewczyk]

Using sabre with XSD validation I'm getting unexpected result when using the XSD snippet from documentation.
There's actually 2 problems with suggested solution:
$service = new Sabre\Xml\Service(); $reader = $service->getReader(); $validXml = $reader->setSchema('myschema.xsd') if ($validXml) { $reader->xml($xml); print_r($reader->parse()); }
will not work as the Schema needs to be set after xml() method call.
Additionally the parse() method is returning root element array with name, value, and attributes keys.
Looking at code this happens because Service::parse() is returning $result['value'] while Reader::parse() is returning $result.

Can you please either correct the code, to always have same result, or at least update the documentation to make it clear what to expect?

[staabm]

where did you found this code?

[kamilszewczyk]

@staabm
Which code exactly?
Suggested solution is on https://sabre.io/xml/reading at the end of that page.
Reader::parse():

xml/lib/Reader.php

Line 56 in 03a31ca

public function parse(): array

Service::parse():

xml/lib/Service.php

Line 112 in 03a31ca

public function parse($input, string $contextUri = null, string &$rootElementName = null)

[staabm]

are you willing to provide a fix in https://github.com/sabre-io/sabre.io/blob/master/source/xml/reading.md ?

[evert]

The reader and service having slightly different signatures is definitely a bit strange in hindsight, but definitely by design. I expect most people to use the service, and the service is meant to be most user-friendly frontend for all of this.