World of Warcraft Armory xml Grabber with cURL

mortisimus · 08-24-2008, 10:00 PM

Ok, I ran across this a little while ago and since I spent a lot of time looking for this, I thought I would share this with all you guys here that want it.

PHP Code:


			
class armory {

 const BROWSER="Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.1.2) Gecko/20070319 Firefox/2.0.0.3";

 public $query;
 public $server;
 public $guild;
 public $guildie;
 public $page;

public function __construct ( $query, $server, $guild, $guildie, $page ) {
    $this->query = $query;
    $this->server = $server;
    $this->guild = $guild;
    $this->guildie = $guildie;
    $this->page = $page;
 } // end of __construct()

public function pull_xml() {

    // change the first part of the $url to the armory link that you need
    if( $this->query === 'roster' ){
        $url = 'http://eu.wowarmory.com/guild-info.xml?r=' . urlencode($this->server) . '&n=' . urlencode($this->guild) . '&p=' . $this->page;
        
      }elseif( $this->query === 'character' ){
        $url = 'http://eu.wowarmory.com/character-sheet.xml?r=' . urlencode($this->server) . '&n=' . $this->guildie;
        
        }  

    $ch = curl_init();
    curl_setopt ($ch, CURLOPT_URL, $url);
    curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, 15);
    curl_setopt ($ch, CURLOPT_USERAGENT,  self::BROWSER);
    
    $url_string = curl_exec($ch);
    curl_close($ch);
    return simplexml_load_string($url_string);
    
   
 } // end of pull_xml()

} // end class

And then to use it:

PHP Code:


			
Syntax:
$armory = new armory( [character or roster] , realm , [guild name or NULL] , character name , [page number (guilds only) or NULL];

Example:
$armory = new armory(character, hellscream, NULL, mortisimus, NULL);
$xml = $armory->pull_xml();

Then you could var_dump($xml) to see all the options you can pull from the armory.

Another example (to get the name):

PHP Code:


			
$armory = new armory(character, hellscream, NULL, mortisimus, NULL);
$xml = $armory->pull_xml();
echo $xml->characterInfo->character['name'];

Which will get the value of the name in the character tag, contained in the characterInfo tag in the xml file from the armory or in short, the characters name

All simple stuff but it helped me out.

The World of Warcraft Armory - EU
The World of Warcraft Armory - US

sketchMedia · 08-25-2008, 03:12 PM

Thanks, I wrote something similar not long ago for a guild website i was developing. In my case I used armory to populate the guild roster in the DB.

One thing i did notice about your code:

PHP Code:


			
$url_string = curl_exec($ch); 
return simplexml_load_string($url_string); 
     
curl_close($ch);

The curl_close is defined after the return, thus it is never fired and resources never freed.

This is the correct code:

PHP Code:


			
$url_string = curl_exec($ch); 
curl_close($ch); 

return simplexml_load_string($url_string);

Also

PHP Code:


			
curl_setopt ($ch, CURLOPT_USERAGENT,  armory::BROWSER);

may aswell be:

PHP Code:


			
curl_setopt ($ch, CURLOPT_USERAGENT,  self::BROWSER);

Just in case you wish to change the name of your class.

mortisimus · 08-26-2008, 01:03 PM

Thanks, updated it.

Tanax · 10-05-2008, 05:24 PM

Looks cool :D

ReSpawN · 10-10-2008, 11:57 AM

Pretty good, but I don't play WoW. ;) Non the less, good share.

Mithadriel · 11-08-2008, 09:07 PM

Great contribution, really simple to follow and takes a whole lot of headache out of querying the armory!

Managed to get information on characters with no problems but hit a snag when trying to query guild info. Noticed a wee typo on the example above:

PHP Code:


			
// change the first part of the $url to the armory link that you need
    if( $this->query === 'roster' ){
        $url = 'http://eu.wowarmory.com.com/guild-info.xml?r=' . $this->server . '&n=' . $this->guild . '&p=' . $this->page;

Remove the spurious .com and everything works as expected :)

p.s excuse the thread necromancy ... figured this was worth it though.

Mithadriel · 11-08-2008, 09:32 PM

Just also noticed, for guilds or server names with spaces the above code breaks. This very slightly modified version should be fine as it converts the whitespace to '+' which is how blizz formats it.

PHP Code:


			
public function pull_xml() {

    // change the first part of the $url to the armory link that you need
    if( $this->query === 'roster' ){
        $url = 'http://eu.wowarmory.com/guild-info.xml?r=' . urlencode($this->server) . '&n=' . urlencode($this->guild) . '&p=' . $this->page;
        
      }elseif( $this->query === 'character' ){
        $url = 'http://eu.wowarmory.com/character-sheet.xml?r=' . urlencode($this->server) . '&n=' . $this->guildie;
        
        }

mortisimus · 11-09-2008, 09:43 AM

Cheers

TheMuffinMan · 11-21-2008, 08:44 PM

Ok quick question for you PHP folks. :)

I have managed to get this "working" for a guild roster.

I get to this point...

PHP Code:


			
$armory = new armory('roster', 'Dawnbringer', 'Fates Defiance', 'Bberrymuffin', NULL);

$xml = $armory->pull_xml();

echo $xml->guildInfo->guild->members->character['name'];

Now I have the XML, and the "character" tag repeats for every member in the guild.

My question is, how do you look through all of the character elements of the members element to get the information on each character?

My PHP skills aren't the best in the world, sorry if this is a dumb question!

Thanks in advance for any help!

TheMuffinMan · 11-21-2008, 09:12 PM

Ok I figured it out (should have googled first haha!)

PHP Code:


			
foreach ($xml->guildInfo->guild->members->character as $char) {

    echo $char['name'] . "<br>";

}

Anyone know how I can go about sorting this array of arrays for the ['name']?