You want to make sure your XML document abides by a schema, such as XML Schema, Relax NG, and DTDs.
Use the DOM extension.
To validate a DOM object against a schema stored in a file, call DOMDocument::schemaValidate() or DOMDocument::relaxNGValidate():
|
1 2 3 4 5 6 7 8 9 10 |
$file = __DIR__ . '/address-book.xml'; $schema = __DIR__ . '/address-book.xsd'; $ab = new DOMDocument; $ab->load($file); if ($ab->schemaValidate($schema)) { print "$file is valid.\n"; } else { print "$file is invalid.\n"; } |
If your XML document specifies a DTD at the top, call DOMDocument::validate() to validate it against the DTD.
To validate a DOM object against a schema stored in a variable, call DOMDocument::schemaValidateSource() or DOMDocument::relaxNGValidateSource():
|
1 2 3 4 5 6 7 8 9 10 11 |
$file = __DIR__ . '/address-book.xml'; $ab = new DOMDocument; $ab->load($file); $schema = file_get_contents(__DIR__ . '/address-book.xsd'); if ($ab->schemaValidateSource($schema)) { print "XML is valid.\n"; } else { print "XML is invalid.\n"; } |
Schemas are a way of defining a specification for your XML documents. Though the goal is the same, there are multiple ways to encode a schema, each with a different syntax.
Some popular formats are DTDs (Document Type Definitions), XML Schema, and Relax NG. DTDs have been around longer, but they are not written in XML and have other issues, so they can be difficult to work with.
XML Schema and Relax NG are more recent schemas and attempt to solve some of the issues surrounding DTDs.
PHP uses the libxml2 library to provide its validation support. Therefore, it lets you validate files against all three types. It is most flexible when you’re using XML Schema and Relax NG, but its XML Schema support is incomplete.
You shouldn’t run into issues in most XML Schema documents; however, you may find that libxml2 cannot handle
some complex schemas or schemas that use more esoteric features.
Within PHP, the DOM extension supports DTD, XML Schema, and Relax NG validation, whereas SimpleXML provides only an XML Schema validator.
Validating any file using DOM is a similar process, regardless of the underlying schema format. To validate, call a validation method on a DOM object. For example:
|
1 2 3 4 5 6 7 8 9 10 |
$file = __DIR__ . '/address-book.xml'; $schema = __DIR__ . '/address-book.xsd'; $ab = new DOMDocument; $ab->load($file); if ($ab->schemaValidate($schema)) { print "$file is valid.\n"; } else { print "$file is invalid.\n"; } |
It returns true if the file passes. If there’s an error, it returns false and prints a message to the error log. There is no method for capturing the error message.
If the schema is stored in a string, use DOMDocument::schemaValidateSource() instead of schemaValidate(). Table 12-3 lists all the validation methods.
Table 12-3. DOM schema validation methods
| Method name | Schema type | Data location |
| schemaValidate
schemaValidateSource relaxNGValidate relaxNGValidateSource validate |
XML Schema
XML Schema Relax NG Relax NG DTD |
File
String File String N/A |
All of the validation methods behave in a similar manner, so you only need to switch the method name in the previous example to switch to a different validation scheme.
Both XML Schema and Relax NG support validation against files and strings. You can validate a DOM object only against the DTD defined at the top of the XML document.
