Last updated: Fri, 06 Nov 2009

DOMDocument::getElementsByTagName

(PHP 5)

DOMDocument::getElementsByTagName — Searches for all elements with given tag name

Description

DOMNodeList DOMDocument::getElementsByTagName ( string $name )

This function returns a new instance of class DOMNodeList containing the elements with a given tag name.

Parameters

name: The name of the tag to match on. The special value * matches all tags.

Return Values

A new DOMNodeList object containing all the matched elements.


Following Example is of multiple attributes and multiple child nodes. this is being used to make joomla plugin for bulk upload of articles. Gurmukh Singh Bhatti



<?php

$xml =<<<EOT

<?xml version="1.0"?>

<root>

<section name="Section1">

  <category id="Category1" name="google">

   <arti name="article1">

   <p>any html code here</p>

   <b>my name is so so</b>

    </arti>

   <arti name="article2">value2</arti>

   <arti name="article3">value3</arti>

   <arti name="article4">value4</arti>

  </category>

    <category id="Category2" name="yahoo">

   <arti name="articleSection2">Test value</arti>

  </category>

</section>

<section name="Section2">

  <category id="category1_of_section2" name="msn">

   <arti name="article2">value1</arti>

   <arti name="article3">value2</arti>

  </category>

    <category id="Category2_of_section2" name="webcare">

    <arti name="param3">value4</arti>

   </category>

</section>

</root>

EOT;



$dom = new DomDocument;

$dom->preserveWhiteSpace = FALSE;

$dom->loadXML($xml);

$params = $dom->getElementsByTagName('section'); // Find Sections 

$k=0;

foreach ($params as $param) //go to each section 1 by 1 

{

         echo "Section Attribute :-> ".$params->item($k)->getAttribute('name')."<br>";   //get section attribute            

         $params2 = $params->item($k)->getElementsByTagName('category'); //digg categories with in Section

      $i=0; // values is used to iterate categories  

        foreach ($params2 as $p) {

           echo "&nbsp;&nbsp;- Category Attribute Name :-> ".$params2->item($i)->getAttribute('name')."<br>"; //get Category attributes

            $params3 = $params2->item($i)->getElementsByTagName('arti'); //dig Arti into Categories

                 $j=0;//values used to interate Arti

                     foreach ($params3 as $p2)

                   {

                    echo "&nbsp;&nbsp;&nbsp;- Article Attribute Name : ".$params3->item($j)->getAttribute('name').""; //get arti atributes

echo "&nbsp;&nbsp; Value : ".$params3->item($j)->nodeValue."<br>"; //get Node value ;

                              $j++;   

                   }              

         $i++;

      }

$k++;    

          

}

?>



output :

 Section Attribute :-> Section1

  - Category Attribute Name :-> google

            - Article Attribute Name : article1   Value : any html code heremy name is so so

            - Article Attribute Name : article2   Value : value2

            - Article Attribute Name : article3   Value : value3

            - Article Attribute Name : article4   Value : value4

  - Category Attribute Name :-> yahoo

            - Article Attribute Name : articleSection2   Value : Test value

Section Attribute :-> Section2

  - Category Attribute Name :-> msn

            - Article Attribute Name : article2   Value : value1

            - Article Attribute Name : article3   Value : value2

  - Category Attribute Name :-> webcare

            - Article Attribute Name : param3   Value : value4

StudioAMK.com
10-Oct-2008 03:09


<?php





$doc = new DOMDocument();


$doc->load( 'Users.xml' );


  


$dataset = $doc->getElementsByTagName( "dataUser" );


foreach( $dataset as $row )


{


    $xmlUserNames = $row->getElementsByTagName( "UserName" );


    $xmlUserName = $xmlUserNames->item(0)->nodeValue;


  


    $xmlEmails = $row->getElementsByTagName( "Email" );


    $xmlEmail = $xmlEmails->item(0)->nodeValue;


  


    $xmlDisplayNames = $row->getElementsByTagName( "DisplayName" );


    $xmlDisplayName = $xmlDisplayNames->item(0)->nodeValue;


  


    echo "$xmlUserName - $xmlEmail - $xmlDisplayName\n"; 


}


?>





Contents in Users.xml





<NewDataSet> 


    <dataUser> 


        <UserName>StudioAMK</UserName> 


        <Email>user1@mail.com</Email> 


        <DisplayName>StudioAMK.com</DisplayName> 


    </dataUser> 


    <dataUser> 


        <UserName>User2</UserName> 


        <Email>user2@mail.com</Email> 


        <DisplayName>UserTwo</DisplayName> 


    </dataUser> 


</NewDataSet>

James L
19-Aug-2008 11:04


Return if there are no matches is an empty DOMNodeList. Check using length property, e.g.:





<?php


$nodes=$domDocument->getElementsByTagName('book') ; 


if ($nodes->length==0) {


   // no results


}


?>

jason at shaped dot ca
11-Feb-2008 12:59


in response to tildy at pr dot hu



my preferred way is (in example to gather country data from an iso 3166 xml flie)



$countries = new DOMDocument();

$countries->load("./lib/iso_3166.xml");



$countriesList = $countries->getElementsByTagName("ISO_3166-1_Entry");



foreach($countriesList as $country) {

    $values = $country->getElementsByTagName("*");

    foreach($values as $node) {

      echo $node->nodeName."=".$node->nodeValue;

    }

}

tildy at pr dot hu
13-Dec-2007 12:51


If you want to list the nodename and value of one item(node)  this is an example:



$itemnodes = $doc->getElementsByTagName( "item" );

$nodes = $itemnodes->item(0)->getElementsByTagName( "*" );

for ( $i = 0; $i < $nodes->length; $i++ ) {

    print "nodename=".$nodes->item( $i )->nodeName;

    print "\t";

    print "nodevalue : ".$nodes->item( $i )->nodeValue;

    print "\r\n";

}



It will be list all children name and value of item.

Francois Hill
30-Jul-2007 02:36


Careful : getElementsByTagName will yield all elements with the given tag name under the present node, at any sub-level (i.e. among child nodes and all other descendant nodes)

Finding values of a node
14-Mar-2007 10:01


I don't know if this is that obvious but it was not for me, so in addition to gem at rellim dot com's posting:

adding 



<?php

echo $param -> nodeValue.'<br>';

?>



to the loop will output

value1

value2

value3

gem at rellim dot com
29-Sep-2004 11:20


Here is an example of getElementsByTagName():



<?php

$xml =<<<EOT

<?xml version="1.0"?>

<config>

  <section id="section1">

   <param name="param1">value1</param>

   <param name="param2">value2</param>

  </section>

  <section id="section2">

   <param name="param3">value3</param>

  </section>

</config>

EOT;



$dom = new DomDocument;

$dom->preserveWhiteSpace = FALSE;

$dom->loadXML($xml);

$params = $dom->getElementsByTagName('param');



foreach ($params as $param) {

       echo $param -> getAttribute('name').'<br>';

}

?>



Expected result:

--------------

param1

param2

param3

add a note

DOMDocument::getElementsByTagNameNS

DOMDocument::getElementById

Last updated: Fri, 06 Nov 2009

DOMDocument::getElementsByTagName

Description

Parameters

Return Values

See Also