PHP 8.5.0 RC 2 available for testing

XMLReader::isValid

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

XMLReader::isValid โ€” Zeigt an, ob das geparste Dokument valide ist

Beschreibung

public XMLReader::isValid(): bool

Gibt einen booleschen Wert zurรผck, der angibt, ob das zu analysierende Dokument aktuell gemรครŸ der DTD oder einem XML- oder RelaxNG-Schema gรผltig ist. Wenn es kein Schema gibt und die DTD-Validierungsoption nicht angegeben ist, gibt diese Methode false zurรผck.

Parameter-Liste

Diese Funktion besitzt keine Parameter.

Rรผckgabewerte

Gibt true zurรผck, wenn das Dokument gรผltig ist, oder false andernfalls.

Beispiele

Beispiel #1 Validierung von XML

<?php
$xml
= XMLReader::open('examples/book-simple.xml');

// Die Option VALIDATE muss gesetzt werden, damit diese Methode
// ordnungsgemรครŸ funktioniert
$xml->setParserProperty(XMLReader::VALIDATE, true);

var_dump($xml->isValid());
?>

Anmerkungen

Hinweis: Dies รผberprรผft den aktuellen Knoten, nicht das gesamte Dokument.

Siehe auch

๏ผ‹add a note

User Contributed Notes 4 notes

up
3
remy dot damour at laposte dot net ยถ
16 years ago
1. If you validate against relax-ng, no need to call $xml->setParserProperty(XMLReader::VALIDATE, true);

2. Be aware that $xml->isValid() will return validity for currently active node (ie. node currently positioned using $xml->read()). It won't check validity of your entire tree at once, but rather on a step by step basis
up
1
me at lubu dot ch ยถ
3 years ago
Be aware that $xml->isValid() will return validity only for currently active node, so you have to loop trough the nodes.

Here is a example how to validate a entire XML file against a XSD schema:

<?php

$xmlReader
= new \XMLReader();
$xmlReader->open('./example.xml');
$xmlReader->setParserProperty(\XMLReader::VALIDATE, true);
$xmlReader->setSchema('./schema.xsd');

\libxml_use_internal_errors(true);

$msgs = [];

while (
$xmlReader->read()) {
if (!
$xmlReader->isValid()) {
$err = \libxml_get_last_error();
if (
$err && $err instanceof \libXMLError) {
$msgs[] = \trim($err->message) . ' on line ' . $err->line;
}
}
}

if (
$msgs) {
throw new
\Exception("XML schema validation errors:\n - " . implode("\n - ", array_unique($msgs)));
}
?>
up
0
zubin at trattonuovo dot com ยถ
15 years ago
I encountered some problems to use isValid method with xml2assoc function.
I use this way to validate the entire xml file and put it into an associative array.

$xml = new XMLReader();
if (!$xml->xml($xml_string, NULL, LIBXML_DTDVALID)) {
echo "XML not valid: load error";
exit();
}

libxml_use_internal_errors(TRUE);

$xml_array = xml2assoc($xml);

$arErrors = libxml_get_errors();
$xml_errors = "";
foreach ($arErrors AS $xmlError) $xml_errors .= $xmlError->message;
if ($xml_errors != "") {
echo "XML not valid: ".$xml_errors;
exit();
}

//all ok
up
0
anzenews at volja dot net ยถ
17 years ago
This comment is only partially correct:
"isValid() always returns false unless you enable checking for validity by $reader->setParserProperty(XMLReader::VALIDATE, true);"
This enables DTD checking, but you can also check by using RelaxNG (see setRelaxNGSchema() and setRelaxNGSchemaSource()).

And also, this is NOT correct:
"If you just need to check if XML file is well formed, successful loading into XMLReader object is usually enough."
It is not enough. Pull parsers operate on stream and if you have a large enough file they will not know it is well formed until it is read to the end. If you need to know if it is well formed or/and valid, read it till the end or validation error (you can use next() for fast reading if you don't care about contents).
To Top