[API] TS3 PHP Framework

[florian_fr40]

Do you add the IP of the web server on the query_ip_whitelist file ?
Do you set up correctly the permission in the Guest Query Group ?
The query port is open on the firewall (if there is one) ?

[jujubins]

Error 0: connection to server 'hidden:10011' lost

Why I receive this error?

My servers is online, and my script run, but lost connection.

With serveradmin account I received this message:
Error 3331: flood ban

[maggy]

Is the IP address from which the script is run whitelisted on the server?

[jujubins]

No... xD

I can only edit in the file? Can I edit the whitelist from teamspeak 3 client?


EDIT:

File edited, and I receive the same message:
Error 3331: flood ban

[maggy]

What script are you running that produces this error?

[mwolf]

any chance for joomla 1.6 add on ?

[Grinsekatze]

Hi ScP,
I want to give your framework a try on my Joomla webpage but I get the same Error Message Teris Cooper got before:

Warning: uasort() [function.uasort]: Array was modified by the user comparison function in C:\xampp\htdocs\ts3fw\libraries\TeamSpeak3\Node\Se rver.php on line 0

ERROR 0x602: invalid parameter

I get the Error on both: My local testing enviroment and my webserver too. On my local computer I use PHP 5.3.1 and on my root server is PHP Version 5.2.6-1+lenny9 running. The TS3 PHP Framework is version 1.1.3 beta.
About my configuration:
The TS3 Server is not on my root server so I entered the IP address in the configuration file. Also it's not password protected so I left the password value empty within the configuration file.

I noticed that the Error is called from "TeamSpeak3_Adapter_ServerQuery_Reply::toAssocArra y($ident)" within "reply.php" but I don't know why and how.

Edit:
I could solve the warning now. Therefore I had to edit "/libraries/TeamSpeak3/Adapter/ServerQuery/Reply.php" and had to edit the function "toAssocArray($ident)".
Original:

  public function toAssocArray($ident)
  {
    $nodes = (func_num_args() > 1) ? $this->toArray(1) : $this->toArray();
    $array = array();

    foreach($nodes as $node)
    {
      if(array_key_exists($ident, $node))
      {
        $array[(is_object($node[$ident])) ? $node[$ident]->toString() : $node[$ident]] = $node;
      }
      else
      {
        throw new TeamSpeak3_Adapter_ServerQuery_Exception("invalid parameter", 0x602);
      }
    }

    return $array;
  }

change to:

  public function toAssocArray($ident)
  {
    $nodes = (func_num_args() > 1) ? $this->toArray(1) : $this->toArray();
    $array = array();

    foreach($nodes as $node)
    {
      if(property_exists($ident, (string)$node))
      {
        $array[(is_object($node[$ident])) ? $node[$ident]->toString() : $node[$ident]] = $node;
      }
      else
      {
        throw new TeamSpeak3_Adapter_ServerQuery_Exception("invalid parameter", 0x602);
      }
    }

    return $array;
  }

In short words you have to change "array_key_exists" into "property_exists" and afterwards you have to transform the second Parameter "$node" what is an array into a string ("(string)$node").

The Error 0x602 is caused because "array_key_exists" / "property_exists" returns "false". But why?

Edit 2:
Now I also figured out how on earth the Error is caused:
It's caused because of "/libraries/TeamSpeak3/Node/Server.php" and there within "function channelList(array $filter = array())". The function "toAssocArray" (that generates the Error) is called with a value called "cid". But this value is not within "$node" (check the function mentioned earlier above) so "array_key_exists" / "property_exists" returns "false" and the function "toAssocArray" generates the Error.

[ScP]

Thank you for reporting this. A fix will be included in the next release.

[Grinsekatze]

Unlikely I still get the Error Message:
ERROR 0x602: invalid parameter

I just figured out that it has to do with the channel listing. When I echo $ident and print_r($node) it says: $ident == 'cid'.
Within the array i get a lot of "cid" 's.
So I don't know why on earth the error is generated.

it's this lines of code I think:

      if(array_key_exists($ident, $node))
#      if(property_exists($ident, (string)$node))
      {
        $array[(is_object($node[$ident])) ? $node[$ident]->toString() : $node[$ident]] = $node;
      }
      else
      {
        throw new TeamSpeak3_Adapter_ServerQuery_Exception("invalid parameter", 0x602);
      }

Edit:
Ok, seems as if my first trys got me to the wrong direction.
After I checked the whole framework again I noticed that there are several files which can cause an Error 0x602.
The one mentioned before (/libraries/TeamSpeak3/Adapter/ServerQuery/Reply.php), /libraries/TeamSpeak3/Adapter/ServerQuery/Event.php, /libraries/TeamSpeak3/Node/Server.php and /libraries/TeamSpeak3/Node/Abstract.php .
After I added some debug informations I noticed that this 0x602 is caused by /libraries/TeamSpeak3/Node/Abstract.php and thats the coresponding code to it:

  /**
   * @ignore
   */
  public function offsetGet($offset)
  {
    if(!$this->offsetExists($offset))
    {
      $this->fetchNodeInfo();
    }

    if(!$this->offsetExists($offset))
    {
      throw new TeamSpeak3_Adapter_ServerQuery_Exception("invalid parameter", 0x602);
    }

    return $this->nodeInfo[(string) $offset];
  }

Unlikely I have no Idea what I can solve here. Someone has an IDea or can point me in the right direction?

[R3M__]

Hi and thanks for this awesome framework.

I'm using the default viewer script on our clan page, and have noticed that every client has a country flag, but some have none. Now my question, where do the viewer get the flag infos, maybe something like MaxMind GeoIP, or from the TS server itself?

http://i53.tinypic.com/ih5r29.png

In this case "The Skull" should have a Slovenia flag.

And it would be nice, if there could be a default flag, if the origin of the client can't resolved instead of none, like:

http://i55.tinypic.com/2z4lqf8.png

Thanks in advanced and keep up the good work!

[ScP]

I'm using the default viewer script on our clan page, and have noticed that every client has a country flag, but some have none. Now my question, where do the viewer get the flag infos, maybe something like MaxMind GeoIP, or from the TS server itself?

My example viewer interface class is using the client_country property to decide which flag icon needs to be shown - just like the TeamSpeak 3 Client does. I've taken all the country flag images from the TeamSpeak 3 Client install directory, but it's possible that some new flags were added so they're probably just missing in the framework package.

In short... If the correct flag is shown in your TeamSpeak 3 Client, just copy all the flag images out of your install directory onto your webserver.



I'll think about that default flag option.

[R3M__]

In short... If the correct flag is shown in your TeamSpeak 3 Client, just copy all the flag images out of your install directory onto your webserver.



I'll think about that default flag option.

Ah thanks, the client didn't have a flag in the teamspeak client as well. But with your hint I now understand your code and changed it a bit to make the "NoFlag" flag to show up:

libraries/TeamSpeak3/Viewer/Html.php

  /**
   * Returns a HTML img tag which can be used to display the country flag for a
   * TeamSpeak_Node_Client object.
   *
   * @return string
   */
  protected function getSuffixFlag()
  {
    if(!$this->currObj instanceof TeamSpeak3_Node_Client) return;

    if($this->flagpath && $this->currObj["client_country"])
    {
      return $this->getImage($this->currObj["client_country"]->toLower() . ".png", $this->currObj["client_country"], null, FALSE, TRUE);
    }
    else
    {
      return "<img src='/images/flags/none.png' alt='NOFLAG' title='NOFLAG' />";
    }
  } 

Result: http://i52.tinypic.com/29z6jom.png

Thanks a bunch! much appreciated

[ScP]

Unlikely I have no Idea what I can solve here. Someone has an IDea or can point me in the right direction?

I can. Unfortunately, the code changes you've made have nothing to do with the warning message. The issue is caused by a PHP bug when you're using exceptions inside uasort() callbacks like I did.

Anyway, the upcoming version 1.1.4-beta should fix this.



What I don't understand is why there's an exception thrown on your end. Which version of the TeamSpeak 3 Server do you use? Maybe this is a compatibility issue.

[Whinis]

I would like to know if there is an easy way to turn a client db id into a regular client id. As it stands I have to request the cluid, then from their request the client info on the cluid. explore the array to find the clid before finally ouputting to a kick functions.

The reason I ask this is I have it so that once an hour my script checks for certain conditions. If these conditions fail for a user I clientDeleteDb them, this only works however if they are not logged in. So I then have to go through proccess above to kick before I can clientDeleteDb.

[ScP]

Version 1.1.4-beta is available now...

=== Release 1.1.4-beta - 05 Feb 2011 ===
 ! codebase converted to Zend Studio 8.0.0 project
 ! upgrading your servers to 3.0.0-beta31 (build >= 13537) is mandatory
 + added TeamSpeak3_Node_Server::clientGetNameByUid()
 + added TeamSpeak3_Node_Server::clientGetNameByDbid()
 + added TeamSpeak3_Node_Server::clientGetServerGroupsByDbid()
 + added TeamSpeak3_Node_Server::permRemoveAny()
 - fixed internal convert error exception caused internally when using integer
   values with more than 16 bits for clientftfid parameters
 * several iconDownload() and iconUpload() methods now use random clientftfid
   parameter values instead of node IDs
 - fixed bug where using exceptions inside uasort() callbacks caused warnings
 * TeamSpeak3_Adapter_ServerQuery_Reply::fetchError() now tries to resolve
   the permission name for failed_permid values to generate comprehensible
   error messages