andrewfenn/xmlreader

andrewfenn/xmlreader 是一个 XML 库,它使得 sabre/xml 包的使用更加方便

1.0.0 2017-01-30 08:33 UTC

This package is not auto-updated.

Last update: 2024-09-15 01:04:46 UTC


README

Software License Scrutinizer Code Quality Total Downloads Total Downloads Total Downloads

sabre/xml 库是一个针对 PHP 的专用 XML 读取器和写入器,可以从这里下载。本项目与 sabre/xml 项目无关。

Sabre XML 是一个优秀的 PHP XML 读取库,但它在使用上可能比较困难,特别是当你需要解析非常简单的 XML 时,这可能会使你的代码变得不必要复杂。因此,我在 sabre/xml 之上创建了这个小扩展,它允许你更自然地访问信息,从而更容易完成你的任务。

安装

composer require andrewfenn/xmlreader -v ~1.0.0

方法

XMLReaderElement 提供以下方法...

  • array find( string )

    遍历所有子元素或属性,并返回一个数组。如果你在搜索标签,数组将包含 XMLReaderElement 元素。如果你在搜索属性,数组将包含该属性的值。要搜索属性,请在搜索词前加上一个 @。

  • mixed findFirst( string )

    遍历所有子元素或属性,并返回第一个找到的结果。如果你在搜索标签,结果将是一个 XMLReaderElement。如果你在搜索属性,你将得到该属性的值。

  • array children( void )

    返回当前 XMLReaderElement 的子元素数组。

  • bool hasChildren( void )

    如果元素有任何 XMLReaderElement 子元素

示例

$input = <<<XML
<?xml version="1.0" encoding="UTF-8"?>
<HotelMessage Version="1.0"
              TimeStamp="2016-05-26T11:11:50">
    <Message>Hello</Message>
    <Hotel HotelCode="3">
        <AvailableStatus>
            <StatusControl Start="2017-01-01" End="2017-01-02" InvTypeCode="999" RatePlanCode="888" />
            <LengthsOfStay ArrivalDateBased="true">
                <LengthOfStay MinMaxMessageType="MinLOS" TimeUnit="Day" Time="3" />
            </LengthsOfStay>
        </AvailableStatus>
    </Hotel>
    <Hotel HotelCode="7">
        <AvailableStatus>
            <StatusControl Start="2017-01-04" End="2017-01-05" InvTypeCode="111" RatePlanCode="444" />
            <LengthsOfStay ArrivalDateBased="true">
                <LengthOfStay MinMaxMessageType="MinLOS" TimeUnit="Day" Time="7" />
            </LengthsOfStay>
        </AvailableStatus>
    </Hotel>
</HotelMessage>
XML;

// Use Sabre as usual
$reader = new \Sabre\Xml\Reader();
$reader->xml($input);

// Parse in the reader object
$data = (new \Sabre\Xml\XMLReaderElement())->parse($reader->parse());

调试

// Start accessing the data you want
var_dump($data);

/* Returns...
object(Sabre\Xml\XMLReaderElement)#68 (4) {
  ["name"]=>
  string(12) "HotelMessage"
  ["namespace"]=>
  string(0) ""
  ["attributes"]=>
  object(stdClass)#69 (2) {
    ["Version"]=>
    string(3) "1.0"
    ["TimeStamp"]=>
    string(19) "2016-05-26T11:11:50"
  }
  ["children"]=>
  string(19) "Message,Hotel,Hotel"
}
*/

访问单个子标签

echo "Message: ".$data->Message->value."\n";
echo "Message Type: ".$data->Message->attributes->Type."\n";

/* Returns...
Message: Hello
Message Type: Info
*/

当以这种方式访问单个子标签时,它将返回找到的第一个元素,对于多个子元素,请参阅下面。

echo "Hotel ID: ".$data->Hotel->attributes->HotelCode."\n";
/* Returns...
Hotel ID: 3
*/

访问多个子标签

foreach($data->find('Hotel') as $hotel) {
    // Find a specific element's attribute
    echo "Hotel ID: ".$hotel->attributes->HotelCode."\n";
}

foreach($data->children() as $tag) {
    if ($tag->name == 'Hotel') {
        echo "Hotel ID: ".$tag->attributes->HotelCode."\n";
    }
}

/* Returns...
Hotel ID: 3
Hotel ID: 7
Hotel ID: 3
Hotel ID: 7
*/

查找标签或属性的数组

find() 函数始终返回一个数组。你的搜索词必须与标签或属性完全匹配。

// You can search for any tag attribute by prepending an @ infront of the attribute's name like so...
foreach($data->find('@HotelCode') as $hotel_code) {
    echo "Hotel Code: ".$hotel_code."\n";
}

// You can search for any tag like so...
foreach($data->find('LengthsOfStay') as $los) {
    echo "Length of Stay: ".$los->findFirst('@Time')." Days\n";
}

/* Returns...
Hotel Code: 3
Hotel Code: 4
Length of Stay: 3 Days
Length of Stay: 7 Days
*/

获取第一个元素或属性

echo $data->findFirst('@TimeStamp')."\n";
echo $data->findFirst('@HotelCode')."\n";
echo $data->findFirst('Hotel')->findFirst('@RatePlanCode')."\n";

/* Returns...
2016-05-26T11:11:50
3
888
*/