The ts3admin.class is a powerful api for communication with Teamspeak 3 Servers from your website! Your creativity knows no bounds!
License: GNU General Public License v3.0
The ts3admin.class is a powerful api for communication with Teamspeak 3 Servers from your website! Your creativity knows no bounds!
ts3admin.class.php written by Stefan 'par0noid' Zehnpfennig
You can use this software under the terms of the GNU General Public License v3.
Dev-Website: http://ts3admin.info
Hey, I've tried finding, yet failed, how to list the clients in a channel. The only channel related information for a client found: "Default channel". Is there a way of finding out what users are currently in a channel?
Thanks!
This method doesn't displays ALL client identities known by the server if $duration parameter isn't specified (or is -1), but just a few (in my case just 25 users).
If you set $duration with a big number the function will work properly. I'm using the latest ts3admin.class ( 1.0.2.1 ) and the teamspeak3 server version I'm testing on is 3.0.13.6 on Linux.
Hi,
First - Sry for my bad english i'm from portugal :D
I want to get all users online in 1 ou + groups, count and display in the banner like http://imgur.com/pYS4hwY
I want to get the total number of channels and display to.
Thx :)
Hi,
I'm using ts3admin lib for a long time but I've got a little problem with readChatMessage function.
When I put it to my PHP file, the script drops 504 Gateway Time-out error. I can't get what I'm
doing wrong. I tried to frind a solution with no effect. This is code I'm using:
<?php
define('ROOT_DIR', '/var/www/admin/public_html/');
ini_set('max_execution_time', 0);
ini_set('error_log', ROOT_DIR.'cron/error.log');
ini_set('log_errors', 1);
require_once(ROOT_DIR.'classes/TS3Admin.class.php');
$ts3_server['ip'] = 'localhost';
$ts3_server['port'] = 9988;
$ts3_server['queryport'] = 10222;
$ts3_server['user'] = 'serveradmin';
$ts3_server['pass'] = '---';
$ts = new ts3admin($ts3_server['ip'], $ts3_server['queryport']);
$connection = false;
for($i=0; $i<=3; $i++) {
if($ts->getElement('success', $ts->connect())) { $connection = true; break; }
sleep(10);
}
if($connection!==true) {
error_log('Cant\'t reach the server.');
exit();
}
unset($connection);
$ts->login($ts3_server['user'], $ts3_server['pass']);
$ts->selectServer($ts3_server['port']);
echo $ts->readChatMessage('textprivate');
if(count($ts->getDebugLog()) > 0) {
foreach($ts->getDebugLog() as $logEntry) {
echo '<script>alert("'.$logEntry.'");</script>';
}
}
I tried to use this function with a lot of parameters with the same effect, only If i typed not existing "type" name It shows error array.
I tried to do it on newly cretated TS so I dont think Its permissions problem.
I really wan to use this lib so I will be very greatful for help.
Regards
Hey,
I´am not sure, but for some reason Teaspeak will not work with your Script. If I check manuely the Telnet connection the telnet looks the same like Teamspeak.
TeaSpeak
Welcome on the TeaSpeak ServerQuery interface.
login serveradmin *****
error id=0 msg=ok
use 1
notifyclientupdated clid=0
error id=0 msg=ok
clientlist
clid=1 cid=4 client_database_id=2 client_nickname=test client_type=0|clid=2 cid=0 client_database_id=1 client_nickname=serveradmin client_type=1
error id=0 msg=ok
Message in the Teaspeak console:
[03:07:43] [INFO] [Query] Got new client from 62.75.187.128:33474
[03:07:43] [ERROR] Query invalid read. Code: 0 errno: 0 msg: Success
Did you have an Idea what´s wrong?
Hallo,
kurz und knapp: wenn ich wie gewohnt bei composer nur die autoload.php include kann die Klasse ts3admin nicht gefunden werden.
Evtl. sollte in Klasse mal ein namespace erstellt werden und das autload angepasst werden.
Nebenfrage:
Wieso besteht das Projekt nur aus einer Klasse ?
Das ganze ist doch nicht wirklich (2017) oop, beim holen von den Server (serverList Funktion) bekommt man nur ein Array mit den Werten...
Wieso wird dort z.b. kein Array aus Server Klassen wiedergeben und an denen kann man die Informationen holen ?
Also z.b.
$ts3admin = new ts3admin("ip", 10011);
$ts3admin->login("login", "pw");
$serverList = $ts3admin->serverList();
foreach ($serverList as $index => $server)
{
echo "Id:" . $server->getId() . PHP_EOL;
echo "Maximale Clienten:" . $server->getMaxClientCount() . PHP_EOL;
}Hallo.
Ich würde gerne wissen, ob es möglich ist, sich für Events zu registrieren. Bspw. für das Event notifycliententerview. Ähnlich wie es beim ts3phpframework möglich ist.
Ich freue mich über jede hilfreiche Antwort.
LG Marvin
Is it possible to get an client_ping info?
Hey!
When I first run my code, there is no problem with connectig.
After I have terminated it through my console, I get this error while trying to connect: Error in connect() on line 4388: host isn't a ts3 instance!
Then I have to wait something about 15 minutes before I can use it again.
Can someone explain why it is like that?
My code:
`<?php
require_once("includes/ts3admin.class.php");
require_once("config.php");
$tsAdmin = new ts3admin($config['connect']['ip'], $config['connect']['qPort']);
function PokeAllAdmins($message)
{
global $tsAdmin;
foreach($tsAdmin->clientList() as $clients)
{
if($clients['cid'] == 5)
{
echo "Gracz znajduje sie na CP!";
foreach($ts3->clientList("-groups") as $client)
{
if($tsAdmin->getElement("9", $client["client_servergroups"]))
{
$tsAdmin->clientPoke($client, $message);
}
}
}
}
}
if($tsAdmin->getElement('success', $tsAdmin->connect()))
{
$tsAdmin->login($config['connect']['qName'], $config['connect']['qPass']);
$tsAdmin->selectServer($config['connect']['port']);
$tsAdmin->setName($config['botSettings']['nick']);
echo "Polaczono z serwerem!\n";
$clients = $tsAdmin->clientList();
echo count($clients['data'])." osob online na serwerze\n\n";
if(count($tsAdmin->getDebugLog()) > 0)
{
foreach($tsAdmin->getDebugLog() as $logEntry)
{
print_r($logEntry);
}
}
while(true)
{
$clients = $tsAdmin->clientList();
$data['virtualserver_name'] = "TestowyTS [Online: ".count($clients['data'])."]";
$tsAdmin->serverEdit($data);
PokeAllAdmins("Użytkownik znajduje się na Centrum Pomocy!");
sleep(5);
}
}
if(count($tsAdmin->getDebugLog()) > 0) {
foreach($tsAdmin->getDebugLog() as $logEntry) {
echo "[C] ".$logEntry."\n";
}
};
?>
`
Thanks
GryTrean
Just noticed that the website is still at 1.0.1.6
Verbindung über einem Ipv6 Teamspeak server schlägt fehl. Werden diese nicht unterstützt? Falls ja gibt es demnächst eine Unterstützung?
So im actually building a teamspeak 3 web panel with ts3admin class because i personally find it very easy to use, fast and very very easy to implement.
But, when i try to stop a server process, the server stops himself, but ts3admin keeps running and the server returns me max execution time limit exceeded.
this is my code:
`
$teamspeak = new ts3admin($data->ip, $data->sq_port);
if($teamspeak->getElement('success', $teamspeak->connect())) {
if($teamspeak->login($data->sq_username, $data->sq_password)) {
if($teamspeak->serverProcessStop()) {
$response = true;
} else {
$response = false;
}
} else {
$response = false;
}
}`
Moin,
bei channelList() ist der Wert von "channel_needed_subscribe_power" immer auf 0. Ich habe dies nun auf mehreren Teamspeak-Servern gesteset. Ist Dir da ein Fehler bekannt?
Gruß Daniel
Hi, my code:
$ts->uploadIcon(file_get_contents('http://icons.iconarchive.com/icons/graphicloads/100-flat-2/16/shield-icon.png'));
return:
["errors"]=> array(1) { [0]=> string(26) "Error: file does not exist" }
Does anyone know what's going on?
Hi. I want to create a page, where client can set his icon, but i dont know how to upload icon to server usign ts3admin.class 😳
Can you help me? 😇
Hi, i was trying to use the function clientDbList(), but the default parameter duration (-1) return this error:
ErrorID: 1540 | Message: convert error
This is my code:
$node = new ts3admin($data->ip, $data->sq_port);
// Se l'oggetto è stato creato -> connetti al server
if($node->getElement('success', $node->connect())) {
// esegui il login come server query admin
if ($node->getElement('success', $node->login($data->sq_username, $data->sq_password))) {
if($node->getElement('success', $node->selectServer($virtualserver_id, 'serverId', true))) {
$node->setName("xx");
$response = $node->clientDbList();
} else {
$response = false;
}
} else {
$response = false;
}
} else {
$response = false;
}
If i put in it params like $node->clientDbList(0, 5, false) the function works.
hi there,
some long time ago #33 had some suggestions and there was even a discussion #3
lets get it on
in case class is used for a bot in daemon mode (runs infinite in the backbround doing his assigned tasks)
did you know, that this line if(empty($data))
d9f7d46#diff-6d8bfb1cf539d16b81e45de812c980cbR4285
will never get evaluated if the socket dies (server restart, server stop, crash)?
the loop will stuck in a endless fgets, cpu core will go 100%, i metioned this issue allrady here #33
but it got ignored, and surprisingly nothing changed since then.
you cant read any data if there is no resource socket, its a blackhole endless loop.
if you dont belive, try it out, use this and turn the server off after 10 sec, and watch your bots/scripts CPU load and watch your console.
<?PHP
$ts3_ip = '127.0.0.1';
$ts3_queryport = 10011;
$ts3_user = 'serveradmin';
$ts3_pass = 'password';
$ts3_port = 9987;
require("../lib/ts3admin.class.php");
$tsAdmin = new ts3admin($ts3_ip, $ts3_queryport);
if($tsAdmin->getElement('success', $tsAdmin->connect())) {
$tsAdmin->login($ts3_user, $ts3_pass);
$tsAdmin->selectServer($ts3_port);
while(1){
print_r($tsAdmin->version());
sleep(2);
}
}else{
echo 'Connection could not be established.';
}
?>on server "crash" we should see in the console
but as you see, we see nothing, only our CPU goes crazy.
my solution below:
do {
if(is_resource( $this->runtime['socket'] ) === false || @feof( $this->runtime['socket'] ) === true){
if(is_resource( $this->runtime['socket'] ) === true){
@fclose($this->runtime['socket']);
}
$this->runtime['socket'] = $this->runtime['bot_clid'] = '';
$this->addDebugLog('Socket closed.', $tracert[1]['function'], $tracert[0]['line']);
return $this->generateOutput(false, array('Socket closed.'), false);
}
$data .= @fgets($this->runtime['socket'], 4096);
if(strpos($data, 'error id=3329 msg=connection') !== false) {
$this->runtime['socket'] = $this->runtime['bot_clid'] = '';
$this->addDebugLog('You got banned from server. Socket closed.', $tracert[1]['function'], $tracert[0]['line']);
return $this->generateOutput(false, array('You got banned from server. Connection closed.'), false);
}
} while(strpos($data, 'msg=') === false or strpos($data, 'error id=') === false);check if the socket is still alive and not at its end of "life" before we use fgets, so you can safely fetch data, and i repeat again if the socket dies we should get this output:
honestly, we get nothing but a blackhole loop, no output, no errors and a 100% cpu load.
so i hope you can eval this issue to see that i dont talk rubbish.
kind regards, stefano
edit: this post's code can be ignored because i came up with new updates, see the posts below.
Hi, I noticed that the mytsid element is missing, in documentation, I will try to release pulls.
Hey,
ich versuche verzweifelt, ein erstelltes Object der ts3admin class zu serializieren bzw. zu deserializieren.
Mein Ansatz ist der:
` require_once("../ts3admin.class.php");
$tsAdmin = new ts3admin('85.214.197.205', 10011);
if($tsAdmin->getElement('success', $tsAdmin->connect()))
{
// Im Teamspeak Einloggen
$tsAdmin->login('serveradmin', '{ZENSIERT}');
// Server Select
$tsAdmin->selectServer(33, 'serverId', true);
// Server Info Daten abfragen
$server = $tsAdmin->serverInfo();
};
//print_r($tsAdmin);
echo serialize($tsAdmin);
echo "<br/><br/>".unserialize($tsAdmin);
`
Leider ist unserialize($tsAdmin) immer leer. Gibt es dafür eine Lösung?
Hello Dear Staff,
Can you introduce and update Query console via protocol SSH please for 10022 port thank you, we would like add this class for checking online servers via query ssh and for query bots scripts, thank you.
Compile Error: Cannot use TeamSpeak3\Helper\String as String because 'String' is a special class name
ts3admin not working for php 7 cause "String" class name is occupied in base PHP 7.
Can you make it compatible ?
Hello, i can't set the channel icon via channelcreate().
$channel['data'] = array(
'channel_name' =>"example"
'channel_flag_maxclients_unlimited' => 0,
'channel_flag_maxfamilyclients_unlimited' => 1,
'channel_maxclients' => $limit,
'channel_flag_permanent' => 1,
'channel_codec_quality' => 10,
//'channel_icon_id' => 500, <- example ID.
'cpid' => 334
);
}
$ts->channelCreate($channel['data']);
var_dump:
array(3) {
["success"]=>
bool(false)
["errors"]=>
array(1) {
[0]=>
string(42) "ErrorID: 1538 | Message: invalid parameter"
}
["data"]=>
bool(false)
}
I don't know what I'm doing wrong. :x
how would I call the values for online clients and max clients?
How to use a specific Identity to join the server?
The title says ^^
Actually i'm a bit lost.
Is there any way to get teamspeak icons with their own id and image ? (base64 or direct file, i don't care)
As per https://forum.teamspeak.com/threads/137292-Release-TeamSpeak-3-Server-3-4-0
Could we make use of
"1. Now you can give your query client a nickname before you select a server and the users on server will no longer see the default user name with current IP. The parameter is optional and without it you get the default nickname when you select a server."
in ts3admin class?
Thanks
Hello,
How are options defined in the serverList() function?
We want to return a single server, based on it's uid.
I have attempted several methods, but it only returns all.
Please advise?
Thank you
Hello. With this code:
#print clients to browser
foreach($clients['data'] as $client) {
$iconid = $client['client_icon_id'];
echo '<img width="16" height="16" alt="test" src="/ts3-status/icons/icon_' . $iconid . '">';
echo $client['client_nickname'] . '<br>';
}
at the one player I get the correctly icon, at the other not: https://redstoneworld.de/ts3-status/tsstatus.php . Then I get a icon ID e.g. "-421249225" ... This icon is not in "/home/teamspeak3/TeamSpeak3-Server/files/virtualserver_12/internal/icons" , but the player have the correctly icon in teamspeak. Must I restart the ts3? Is this a cached icon or what is the problem, please?
Hey ich bins nochmal :D,
ich habe mittlerweile von mehreren Nutzern meine Interfaces die Meldung bekommen, dass nicht alle Datenbankbenutzer angezeigt werden. Wo ich es nun selbst getestet habe, stimmt das leider.
Ich verwende folgende funktion:
http://ts3admin.info/manual/classts3admin.html#a84896e1a06dffa43811751079dcc04ed
Im Quelltext frage ich diese ab und gebe sie mit einer einfachen foreach schleife aus. Allerdings sind nicht alle vorhanden. Selbst wenn ich auf dem Teamspeak online bin, werde ich in der Liste nicht angezeigt. Gibt es schon andere Meldungen derart?
Hier gab es schon mal solch ein Post, allerdings sehe ich daraus keine Lösung..:
#24
the documentation on http://ts3admin.info is offline!
Durch fehlenden Namespace in der ts3admin.class.php kann die API nicht via use eingebunden werden.
Nachdem ich namespace Par0noid; nachgetragen habe ging es dann.
Hi, i'm trying to setup an API for getting clientAvatar but, when i'm running this file, it does an infinite loop.
That's my code:
$node = new ts3admin($data->ip, $data->sq_port);
if($node->getElement('success', $node->connect())) {
if ($node->getElement('success', $node->login($data->sq_username, $data->sq_password))) {
if($node->getElement('success', $node->selectServer($virtualserver_id, 'serverId', true))) {
$response = $node->clientAvatar($client);
} else {
$response = false;
}
} else {
$response = false;
}
} else {
$response = false;
}
Is this a bug or am i missing something? Thanks
Hi,
I have problem with connecting to few servers, and I don't know what's going on :/.
Warning: Invalid argument supplied for foreach() in /var/www/***.pl/public_html/***/ts3admin.class.php on line 3208
Code:
$tsAdmin = new ts3admin($config["ts3"]["ip"], $config["ts3"]["queryport"]); $tsAdmin->connect(); $tsAdmin->login($config["ts3"]["user"], $config["ts3"]["pass"]); $tsAdmin->selectServer($config["ts3"]["port"]);
Server:
51.254.11.77:9987
and
185.101.94.165:9987
Any suggestions?
Best regards,
Mariusz W.
czerwony03
private function loadQueryData()
{
$whoAmI = $this->getElement('data', $this->whoAmI());
$this->runtime['bot_name'] = $whoAmI['client_nickname'];
$clients = $this->clientList();
foreach($clients['data'] as $client) // Here is the line
{
if(strstr($this->runtime['bot_name'], $client['client_nickname']))
{
$this->runtime['bot_clid'] = $client['clid'];
break;
}
}
}
Hello,
There is no support if the socket is closed: the while loops becomes an infinite loop here: https://github.com/par0noid/ts3admin.class/blob/master/lib/ts3admin.class.php#L4211
What about adding basic support for detecting dead sockets?
Thx! :)
In the code below, the variable $tracert is used in both calls of $this->addDebugLog(), but is never initialized in this context. Therefore, a PHP notice will be thrown if readChatMessage() is called with a invalid $type parameter or if there is no active connection.
public function readChatMessage($type = 'textchannel', $keepalive = false, $cid = -1)
{
$availTypes = array('textserver', 'textchannel', 'textprivate');
$rtnData = array('success' => 0, 'data' => array('invokerid' => '', 'invokeruid' => '', 'invokername' => '', 'msg' => '', 'targetmode' => ''));
if(!$this->isConnected()) {
$this->addDebugLog('script isn\'t connected to server', $tracert[1]['function'], $tracert[0]['line']);
return $rtnData;
}
if(!in_array($type, $availTypes)) {
$this->addDebugLog('Invalid passed read type', $tracert[1]['function'], $tracert[0]['line']);
return $rtnData;
}
...
Hello,
I've got a problem with a readChatMessage function.
Here is my code:
" $ts3->readChatMessage("textchannel",false,'1') ".
This code should read the message from channel with id 1 but it's not working properly. It reads message only from default channel. How to fix it?
I'd really appreciate your help.
Best regards,
Kuba Nowacki
Hello,
i need help with this error:
[Mon Jan 06 21:53:02.995198 2020] [php7:error] [pid 19692] [client xxx.xxx.xxx.xxx:00000] PHP Fatal error: Uncaught Error: Class 'ts3admin' not found in /var/www/_[EGU]Seiten/serverinterface/teamspeak/verification/de/index.php:9\nStack trace:\n#0 {main}\n thrown in /var/www/[EGU]_Seiten/serverinterface/teamspeak/verification/de/index.php on line 9
any idea? use the latest version.
greetings, Killer0561 (Sascha)
Hi, im trying to build a web project for school in wich im going to allow people to create teamspeak 3 servers using your ts3admin class. The problem im having is that i can create the server and it works but i can't retrieve the SA token thats automatically generated when the servers is creeated because $tsAdmin->serverCreate($data); is not outputing anything. Can you please help? Thanks in advance.
Hi, from code L596 to L601 there is uncommented code which is causing some problems.
/**
* channelEdit
*
* Changes a channels configuration using given properties. Note that this command accepts multiple properties which means that you're able to change all settings of the channel specified with cid at once.
*
* <b>Input-Array like this:</b>
<pre>
$data = array();
$data['setting'] = 'value';
$data['setting'] = 'value';
</pre>
*
* <b>Possible properties:</b> Take a look at channelCreate function
*
* @author Stefan Zehnpfennig
* @param integer $cid $channelID
* @param array $data edited settings
* @return boolean success
*/
How do I handle the bot as a normal user that you can see connecting and disconnecting from the server?
Hey,
connection_packetloss_total is calculated incorrectly...
Server: 0,26%
API: 0,0026%
That's a big difference.
Hello. I have not the big PHP skill and would like know, why I can't get the server status with my PHP code:
if($tsAdmin->getElement('success', $tsAdmin->connect())) {
#login as serveradmin
$tsAdmin->login($ts3_user, $ts3_pass);
#select teamspeakserver
$tsAdmin->selectServer($ts3_port);
#get clientlist
$clients = $tsAdmin->clientList();
#get status (!!!!)
$status = $tsAdmin->serverInfo();
#print client count
echo count($clients['data']) . ' clients on selected server<br><br>';
#print server status (!!!!)
echo $status['virtualserver_status'];
#print clients to browser
foreach($clients['data'] as $client) {
echo $client['client_nickname'] . '<br>';
}
}else{
echo 'Connection could not be established.';
}
The server-status request and the echo are not correctly. I don't why. I inspired my of the other code-lines.
[virtualserver_status] under the serverInfo array get the server satus.
Hey,
wenn ich folgendes tue....
$test = $tsAdmin->getElement('data', $tsAdmin->readChatMessage('textserver'));
dann wird die Seite solange nicht geladen, bis jemand was im Server schreibt. Ich habe im Quelltext nicht den Grund gefunden warum das so ist. Gibt es eine Möglichkeit zu prüfen, ob was geschrieben wurde und wenn ja das zurückzugeben und wenn nicht ein leeres Resultat zurückzugeben?
Hello,
I was playing around with the framework and I had issues with serverInfo(), I'd like some help
For example:
...
if($tsAdmin->getElement('success', $tsAdmin->connect())) {
$tsAdmin->login($ts3_user, $ts3_pass);
$servers = $tsAdmin->serverList();
foreach($servers['data'] as $server) {
echo $server['virtualserver_name'];
}
$tsAdmin->logout();
}
Output as expected
Perfect!
But using serverInfo() + selectServer() :
...
if($tsAdmin->getElement('success', $tsAdmin->connect())) {
$tsAdmin->login($ts3_user, $ts3_pass);
$tsAdmin->selectServer($ts3_port);
$servers = $tsAdmin->serverInfo();
foreach($servers['data'] as $server) {
echo $server['virtualserver_name'];
}
$tsAdmin->logout();
}
Output
Warning: Illegal string offset 'virtualserver_name' in /xxx/www/serverlist.php on line XX
Am I missing something?
"Fatal error: Call to undefined function serverGroupCopy()"
I just noticed a small mistake in the documentation. In the list of possible properties in channelCreate($data), there is a property called CHANNEL CODEC, but it lacks an underscore (CHANNEL_CODEC).
And maybe it should be documented in lowercases or transformed to it by default, because the query doesn't accept them in other forms than lowercase.
Could you please create a composer.json file. I want to work with your class in some project where I need to use composer (for updates etc.).
Regards
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
Django
The Web framework for perfectionists with deadlines.
Laravel
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft
Open source projects and samples from Microsoft.
Google
Google ❤️ Open Source for everyone.
Alibaba
Alibaba Open Source for everyone
D3
Data-Driven Documents codes.
Tencent
China tencent open source team.