(PHP 4, PHP 5, PHP 7, PHP 8)
xml_parse_into_struct — Разбор XML-данных и помещение в массив
Эта функция разбирает XML-строку и помещает данные в 2 массива. Массив
index
содержит указатели на размещение значений в
массиве values
. Аргументы, задающие массивы, должны
передаваться в функцию по ссылке.
parser
Ссылка на используемый XML-анализатор.
data
Строка XML-данных.
values
Массив значений XML-данных.
index
Массив указателей на соответствующие значения в массиве $values.
xml_parse_into_struct() возвращает 0 при неудачном
разборе строки и 1 при успешном. Это не то же самое, что false
и true
,
будьте осторожны с такими операторами, как ===.
Версия | Описание |
---|---|
8.0.0 |
Параметр parser ожидает экземпляр класса XMLParser;
раньше параметр ждал корректный xml -ресурс (resource).
|
Ниже представлен пример, демонстрирующий внутреннее устройство массивов,
генерируемых функцией. XML-строка содержит простой тег
note
вложенный в тег para
.
Программа в примере разбирает эту строку и выводит созданные массивы:
Пример #1 Пример использования xml_parse_into_struct()
<?php
$simple = "<para><note>простое примечание</note></para>";
$p = xml_parser_create();
xml_parse_into_struct($p, $simple, $vals, $index);
xml_parser_free($p);
echo "Массив index\n";
print_r($index);
echo "\nМассив vals\n";
print_r($vals);
?>
После обработки программа выведет следующее:
Index array Array ( [PARA] => Array ( [0] => 0 [1] => 2 ) [NOTE] => Array ( [0] => 1 ) ) Массив Vals Array ( [0] => Array ( [tag] => PARA [type] => open [level] => 1 ) [1] => Array ( [tag] => NOTE [type] => complete [level] => 2 [value] => простое примечание ) [2] => Array ( [tag] => PARA [type] => close [level] => 1 ) )
Управляемый событиями разбор (основанный на библиотеке expat) может дать труднообрабатываемый результат в случае, если разбирается составной XML-документ. Эта функция не создаёт DOM-объектов, но создаваемые ею массивы можно преобразовать в древовидную структуру впоследствии. Таким образом можно довольно просто создавать объекты, представляющие содержимое XML-файла. Предположим, что следующий XML файл представляет небольшую базу данных с информацией об аминокислотах:
Пример #2 moldb.xml - небольшая база данных с информацией о молекулах
<?xml version="1.0"?> <moldb> <molecule> <name>Alanine</name> <symbol>ala</symbol> <code>A</code> <type>hydrophobic</type> </molecule> <molecule> <name>Lysine</name> <symbol>lys</symbol> <code>K</code> <type>charged</type> </molecule> </moldb>
Пример #3 parsemoldb.php - разбирает moldb.xml и помещает данные в массив молекул
<?php
class AminoAcid {
var $name; // название аминокислоты
var $symbol; // трёхбуквенное обозначение
var $code; // однобуквенный код
var $type; // гидрофобная, заряженная, нейтральная
function __construct ($aa)
{
foreach ($aa as $k=>$v)
$this->$k = $aa[$k];
}
}
function readDatabase($filename)
{
// чтение XML-базы данных аминокислот
$data = file_get_contents($filename);
$parser = xml_parser_create();
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, 1);
xml_parse_into_struct($parser, $data, $values, $tags);
xml_parser_free($parser);
// проход через структуры
foreach ($tags as $key=>$val) {
if ($key == "molecule") {
$molranges = $val;
// каждая смежная пара значений массивов является верхней и
// нижней границей определения молекулы
for ($i=0; $i < count($molranges); $i+=2) {
$offset = $molranges[$i] + 1;
$len = $molranges[$i + 1] - $offset;
$tdb[] = parseMol(array_slice($values, $offset, $len));
}
} else {
continue;
}
}
return $tdb;
}
function parseMol($mvalues)
{
for ($i=0; $i < count($mvalues); $i++) {
$mol[$mvalues[$i]["tag"]] = $mvalues[$i]["value"];
}
return new AminoAcid($mol);
}
$db = readDatabase("moldb.xml");
echo "** База данных аминокислот:\n";
print_r($db);
?>
** База данных аминокислот: Array ( [0] => aminoacid Object ( [name] => Alanine [symbol] => ala [code] => A [type] => hydrophobic ) [1] => aminoacid Object ( [name] => Lysine [symbol] => lys [code] => K [type] => charged ) )