# xml_parse

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_parse — Commence l'analyse d'un document XML

### Description

xml_parse(XMLParser `$parser`, string `$data`, bool `$is_final` = `false`): int

xml_parse() analyse un document XML. Les gestionnaires pour les événements configurés sont appelés autant de fois que nécessaire.

### Liste de paramètres

`parser`

  Une référence sur l'analyseur XML à utiliser.

`data`

  Une partie des données à analyser. Un document peut être analysé morceau par morceau par appels successifs à xml_parse() avec de nouvelles données, aussi longtemps que le paramètre `is_final` est défini et `true` lorsque les dernières données sont analysées.

`is_final`

  Si défini et vaut `true`, `data` sera le dernier morceau de données envoyées à l'analyseur.

### Valeurs de retour

Retourne 1 en cas de succès ou 0 en cas d'échec.

Lors d'un échec d'analyse, la cause de l'erreur peut être obtenue grâce aux fonctions xml_get_error_code(), xml_error_string(), xml_get_current_line_number(), xml_get_current_column_number() et xml_get_current_byte_index().

> Note:

> Quelques erreurs (dont les erreurs d'entités) sont reportées à la fin des données, ceci uniquement si `is_final` vaut `true`.

### Historique

Version | Description
--- | ---
8.0.0 | `parser` attend une instance de XMLParser désormais; auparavent, une resource `xml` était attendue.

### Exemples

Exemple #1 Analyse de gros documents XML par morceaux

Cet exemple montre comment les gros documents XML peuvent être lus et analysés en morceaux, permettant ainsi de ne pas conserver en mémoire la totalité du document. Aucun gestionnaire d'erreur n'a été positionné pour rendre l'exemple plus concis.

`<?php
$stream = fopen('examples/book-simple.xml', 'r');
$parser = xml_parser_create();
xml_set_element_handler(
$parser,
function($parser, $name, $attributes) { echo $name, PHP_EOL; },
function($parser, $name) { echo $name, PHP_EOL; }
);
while (($data = fread($stream, 16384))) {
xml_parse($parser, $data); // analyse du morceau courant
}
xml_parse($parser, '', true); // finalisation de l'analyse
xml_parser_free($parser);
fclose($stream);`