0.4.2 – “Fishing Extravaganza” – Dec 17, 2008

This release should fix issues with character that could not be retrieved from the armory due to special characters in realm or character names.

Bugs squashed

• phpArmory5Cache: the setCachedData(…) function was called without prior checks if there was any valid data to cache. This has been fixed.
• phpArmory5: Strings used in URLs do not need a manual replacement of the space character. urlencode() handles this for us already.
• phpArmory5: fixed an issue in __construct, where required PHP extension have not been checked properly. Thanks to Gizzmo for the hint.

Features added

• phpArmory5: added getAnyData($searchType = NULL, $objectName = NULL, $filter = NULL). $searchType can be any of “arenateams”, “characters”, “guilds”, “items”. $filter needs to be an associative array of filter properties. For now, try out the armory item search page to see valid filter options.

• phpArmory5: added a third parameter to getCharacterData for retrieving only the basic character data. Defaults to false. Use the following to get basic character data only:

  $character = $phpArmory->getCharacterData($characterName = "Char", $realmName = "Realm", $onlyBasicData = true)
  

Download

Enjoy the 0.4.2 release, and either grab phparmory-0.4.2.zip or phparmory-0.4.2.tar.gz. Please note that all PHP files are formatted with Unix line endings, as I am mostly a Linux / Mac geek.

Feel free to leave a comment if you should end up having trouble with the classes. phparmory-042tar

0.4.1 – “Call to Arms” – Nov 26, 2008

The World of Warcraft armory has received quite a few improvements, making it feature complete with the added character data from the “Wrath of the Lich King” expansion.

Features added

• getCharacterData($characterName, $realmName) will now return an array which contains character achievements and statistics.

  $character = Array
  (
      [characterinfo] => Array
          (
                  ...
          )
  
      [reputationtab] => Array
          (
                  ...
          )
  
      [skilltab] => Array
          (
                  ...
          )
  
      [talenttab] => Array
          (
                  ...
          )
  
      [achievements] => Array
          (
                  ...
          )
  
      [statistics] => Array
          (
                  ...
          )
  
      [armorypatchlevel] => 030003
  )
  

Download

Enjoy the 0.4.1 release, and either grab phparmory-0.4.1.zip or phparmory-0.4.1.tar.gz. Please note that all PHP files are formatted with Unix line endings, as I am mostly a Linux / Mac geek.

Feel free to leave a comment if you should end up having trouble with the classes.

0.4.0 – “Jack-o’-Lantern” – Nov 20, 2008

phpArmory has been rewritten for PHP5 and the new OOP class syntax. The class interfaces have been changed to use getFunction() and setFunction() syntax, and class variables have been adjusted to use private, protected, and public states. Please consult the doc/ folder for updated API documentation.

NOTE: arena team handling has been postponed to release 0.5.0, as with the recent release of Wrath of the Lich King, all arena teams have been wiped and no sample data was available to develop the feature.

Bugs squashed

• all functions have received input checking, now all functions will properly return FALSE when something goes wrong.

Features added

• phpArmory5 and phpArmory5Cache will now make use of trigger_error provided by PHP5 to raise notices (E_USER_NOTICE), warnings (E_USER_WARNING), and errors (E_USER_ERROR). Please note that warnings and notices will only be raised when you use phpArmory from the command line. If you use it on your web server, only errors will be raised.
• you can now use getArea / setArea to make changes to the armory area.
• you can now use getLocale / setLocale to set the language in which you want to query data from the armory.
• you can retrieve talent definitions for all classes, including the recently added Death Knight using getTalentData().

Features changed

• the phpArmory class API has been changed. All functions now use get… and set… for their names. The current API documentation is available online
• character icons will now be properly display for characters up to level 80. We have shiny WotLK character icons.

Download

Enjoy the 0.4.0 release, and either grab phparmory-0.4.0.zip or phparmory-0.4.0.tar.gz. Please note that all PHP files are formatted with Unix line endings, as I am mostly a Linux / Mac geek.

Feel free to leave a comment if you should end up having trouble with the classes.

On Aug 27, 2008 the PHP team has released the final release of PHP4, and thus it is time to make the switch to PHP5 in phpArmory, too.

As some may know, PHP5 introduced quite a few features to enhance the OOP features for classes, and make them feel like real classes. Among the changes, there are real class constructors and destructors, plus private, protected, and public keywords became available for class variables and functions. Cheers for this! I have waited for this quite some time, being a C++ developer it just felt wrong to have no real classes in PHP4.

This means, most variables and functions of phpArmory / phpArmoryCache will be changed. For most class variables, their status will become private to prevent their usage from outside the class. All variables have been intended for internal use anyway. If you did use them, stop now. Class functions will be changed to private or protected. Only two functions will become private, as they are intended to be used only inside phpArmory / phpArmoryCache. The remaining functions will become protected (not public!). What does this mean? Simply spoken, protected functions may only be used from inherited classes.

Along these changes the class documentation will be rewritten from scratch, using the phpDoc syntax. I also plan to add new usage examples.

One change yet is not decided on, but you can raise your voice to help me. I am considering to switch the phpArmoryCache class to use PHP data objects instead of using the MySQL extension directly. In common this does sound good, but in reality I am not sure if it would be worth the effort. Does anyone want to use PostgreSQL, SQLite or other database backends for phpArmory? If yes, raise your voice and tell me. If not, this change will probably become a task for phpArmory 0.5.0.

If you want to see what I am working on currently, I have added a issue tracker. The issue tracker is updated weekly and shows the progress with fixing bugs, implementing features, and how planned releases progress.

There has been a 0.3.1 release which never made it into the open, due to a last minute issue discovered during testing. The Changelog has all the details on what was changed in 0.3.1 and 0.3.2, and why it changed.

0.3.2 – Oct 02, 2008

Bugs squashed

• phpArmory.class.php: Class will not be instantiated if the Curl or XML extension is missing from your PHP installation.
• examples/character.php: Updated to use setArea. Properly dumps character data as XML. Please note that characterFetch() will now return the armory patchlevel, too.
• examples/guildroster.php: Updated to use setArea. Properly dumps the full guild roster as plain table.

0.3.1 – Sep 28, 2008

Features added

• Patchlevel detection*: getCurrentPatchlevel() will return the current patch version for the armory region you use.
• Talent definitions: TalentDefinitionFetch() will retrieve talent definition for all classes from the World of Warcraft website.
• WoW armory lockout prevention: with previous phpArmory versions, it could happen that your applications would be temporarily locked out from the armory. To prevent this, you can now limit the number of retries for XML pulling. To do this inherit your own classes by specifying the `$retries’ parameter with the number of retries to perform.

Features changed

• *Armory region and locales: this has been simplified, to only supply a setArea function to define which armory region we use.

Download

Enjoy the 0.3.2 release, and either grab phparmory-0.3.2.zip or phparmory-0.3.2.tar.gz. Please note that all PHP files are formatted with Unix line endings, as I am mostly a Linux / Mac geek.

Feel free to leave a comment if you should end up having trouble with the classes.

If you happen to be curious like I am, you will have very likely noticed that those nice PHP classes have not received much love and maintenance or bug fixing since then. Thus I decided to jump in, tasking myself with streamlining the classes and fixing any bugs I might find in there. Both the base class for grabbing and parsing XML data, and the database / file caching class had bugs and missing features, which I added.

phpArmory.class.php

Below follows the list of changes and additions.

• Added: language support. You now can use the setLanguage ($language) and getLanguage() methods to set and retrieve the language in which you want to query armory data.
• Added: the characterIconURL method now has a matching sister for items, named itemIconURL($itemRef). E.g. if you have the icon name from a character item slot, you can pass that and receive the full URL to the matching icon in JPG format.
• Fixed: the xmlToArray method was not properly checking if a children of the XML object really was an array. Checks added, thus warning message gone.

phpArmoryCache.class.php

Below follows the list of changes and additions.

• Added: the phpArmoryCache class now has a new optional parameters for its’ constructur. Using the following example you can now define the MySQL connection settings instead of having to hack the PHP class to enter your settings.

  $armory = new phpArmoryCache($armory = "http://www.wowarmory.com/", $dataStore = "mysql", $dataConn = "mysql://arthas:frostmourne@localhost/northrend", $dataTable = "frozen_throne"", $updateInterval = 14400
  

• Fixed: XML caching will now work again.
• Fixed: corrected storing of MySQL results. The cacheSave() method was not properly checking if a XML result already was stored. Now old data will be updated in case it exists instead of giving back a duplicated key error.

Download

Enjoy the unofficial 0.3 release, and either grab phparmory-0.3.0.tar.gz or phparmory-0.3.0.zip. Please note that all PHP files are formatted with Unix line endings, as I am mostly a Linux / Mac geek.

Feel free to leave a comment if you should end up having trouble with the classes.

Update: I have re-uploaded the archives and included the updated phpDoc code documentation.