TeamSpeak3_Helper_Convert Class Reference

Helper class for data conversion. More...

Static Public Member Functions
static	bytes ($bytes)
	Converts bytes to a human readable value. More...
static	codec ($codec)
	Converts a given codec ID to a human readable name. More...
static	groupType ($type)
	Converts a given group type ID to a human readable name. More...
static	iconId ($unsigned)
	Converts a specified 32-bit unsigned integer value to a signed 32-bit integer value. More...
static	imageMimeType ($binary)
	Tries to detect the type of an image by a given string and returns it. More...
static	logEntry ($entry)
	Converts a specified log entry string into an array containing the data. More...
static	logLevel ($level)
	Converts a given log level ID to a human readable name and vice versa. More...
static	password ($plain)
	Converts a given string to a ServerQuery password hash. More...
static	permissionCategory ($pcat)
	Converts a given permission category value to a human readable name. More...
static	permissionType ($type)
	Converts a given permission type ID to a human readable name. More...
static	seconds ($seconds, $is_ms=FALSE, $format="%dD %02d:%02d:%02d")
	Converts seconds/milliseconds to a human readable value. More...
static	version ($version, $format="Y-m-d h:i:s")
	Returns a client-like formatted version of the TeamSpeak 3 version string. More...
static	versionShort ($version)
	Returns a client-like short-formatted version of the TeamSpeak 3 version string. More...

Detailed Description

Helper class for data conversion.

Member Function Documentation

bytes()

static bytes (   $bytes )

static

Converts bytes to a human readable value.

Parameters

integer

$bytes

Returns

string

  {
    $kbytes = sprintf("%.02f", $bytes/1024);
    $mbytes = sprintf("%.02f", $kbytes/1024);
    $gbytes = sprintf("%.02f", $mbytes/1024);
    $tbytes = sprintf("%.02f", $gbytes/1024);

    if($tbytes >= 1)
      return $tbytes . " TB";
    if($gbytes >= 1)
      return $gbytes . " GB";
    if($mbytes >= 1)
      return $mbytes . " MB";
    if($kbytes >= 1)
      return $kbytes . " KB";

    return $bytes . " B";
  }

codec()

static codec (   $codec )

static

Converts a given codec ID to a human readable name.

Parameters

integer

$codec

Returns

string

  {
    if($codec == TeamSpeak3::CODEC_SPEEX_NARROWBAND)
      return "Speex Narrowband";
    if($codec == TeamSpeak3::CODEC_SPEEX_WIDEBAND)
      return "Speex Wideband";
    if($codec == TeamSpeak3::CODEC_SPEEX_ULTRAWIDEBAND)
      return "Speex Ultra-Wideband";
    if($codec == TeamSpeak3::CODEC_CELT_MONO)
      return "CELT Mono";
    if($codec == TeamSpeak3::CODEC_OPUS_VOICE)
      return "Opus Voice";
    if($codec == TeamSpeak3::CODEC_OPUS_MUSIC)
      return "Opus Music";

    return "Unknown";
  }

groupType()

static groupType (   $type )

static

Converts a given group type ID to a human readable name.

Parameters

integer

$type

Returns

string

  {
    if($type == TeamSpeak3::GROUP_DBTYPE_TEMPLATE)
      return "Template";
    if($type == TeamSpeak3::GROUP_DBTYPE_REGULAR)
      return "Regular";
    if($type == TeamSpeak3::GROUP_DBTYPE_SERVERQUERY)
      return "ServerQuery";

    return "Unknown";
  }

iconId()

static iconId (   $unsigned )

static

Converts a specified 32-bit unsigned integer value to a signed 32-bit integer value.

Parameters

integer

$unsigned

Returns

integer

  {
    $signed = (int) $unsigned;
    
    if(PHP_INT_SIZE > 4) // 64-bit
    {
      if($signed & 0x80000000) return $signed - 0x100000000;
    }
    
    return $signed;
  }

imageMimeType()

static imageMimeType (   $binary )

static

Tries to detect the type of an image by a given string and returns it.

Parameters

string

$binary

Returns

string

  {
    if(!preg_match('/\A(?:(\xff\xd8\xff)|(GIF8[79]a)|(\x89PNG\x0d\x0a)|(BM)|(\x49\x49(\x2a\x00|\x00\x4a))|(FORM.{4}ILBM))/', $binary, $matches))
    {
      return "image/svg+xml";
    }

    $type = array(
      1 => "image/jpeg",
      2 => "image/gif",
      3 => "image/png",
      4 => "image/x-windows-bmp",
      5 => "image/tiff",
      6 => "image/x-ilbm",
    );

    return $type[count($matches)-1];
  }

logEntry()

static logEntry (   $entry )

static

Converts a specified log entry string into an array containing the data.

Parameters

string

$entry

Returns

array

  {
    $parts = explode("|", $entry, 5);
    $array = array();

    if(count($parts) != 5)
    {
      $array["timestamp"] = 0;
      $array["level"]     = TeamSpeak3::LOGLEVEL_ERROR;
      $array["channel"]   = "ParamParser";
      $array["server_id"] = "";
      $array["msg"]       = TeamSpeak3_Helper_String::factory("convert error (" . trim($entry) . ")");
      $array["msg_plain"] = $entry;
      $array["malformed"] = TRUE;
    }
    else
    {
      $array["timestamp"] = strtotime(trim($parts[0]));
      $array["level"]     = self::logLevel(trim($parts[1]));
      $array["channel"]   = trim($parts[2]);
      $array["server_id"] = trim($parts[3]);
      $array["msg"]       = TeamSpeak3_Helper_String::factory(trim($parts[4]));
      $array["msg_plain"] = $entry;
      $array["malformed"] = FALSE;
    }

    return $array;
  }

logLevel()

static logLevel (   $level )

static

Converts a given log level ID to a human readable name and vice versa.

Parameters

mixed

$level

Returns

string

  {
    if(is_numeric($level))
    {
      if($level == TeamSpeak3::LOGLEVEL_CRITICAL)
        return "CRITICAL";
      if($level == TeamSpeak3::LOGLEVEL_ERROR)
        return "ERROR";
      if($level == TeamSpeak3::LOGLEVEL_DEBUG)
        return "DEBUG";
      if($level == TeamSpeak3::LOGLEVEL_WARNING)
        return "WARNING";
      if($level == TeamSpeak3::LOGLEVEL_INFO)
        return "INFO";

      return "DEVELOP";
    }
    else
    {
      if(strtoupper($level) == "CRITICAL")
        return TeamSpeak3::LOGLEVEL_CRITICAL;
      if(strtoupper($level) == "ERROR")
        return TeamSpeak3::LOGLEVEL_ERROR;
      if(strtoupper($level) == "DEBUG")
        return TeamSpeak3::LOGLEVEL_DEBUG;
      if(strtoupper($level) == "WARNING")
        return TeamSpeak3::LOGLEVEL_WARNING;
      if(strtoupper($level) == "INFO")
        return TeamSpeak3::LOGLEVEL_INFO;

      return TeamSpeak3::LOGLEVEL_DEVEL;
    }
  }

password()

static password (   $plain )

static

Converts a given string to a ServerQuery password hash.

Parameters

string

$plain

Returns

string

  {
    return base64_encode(sha1($plain, TRUE));
  }

permissionCategory()

static permissionCategory (   $pcat )

static

Converts a given permission category value to a human readable name.

Parameters

integer

$pcat

Returns

string

  {
    if($pcat == TeamSpeak3::PERM_CAT_GLOBAL)
      return "Global";
    if($pcat == TeamSpeak3::PERM_CAT_GLOBAL_INFORMATION)
      return "Global / Information";
    if($pcat == TeamSpeak3::PERM_CAT_GLOBAL_SERVER_MGMT)
      return "Global / Virtual Server Management";
    if($pcat == TeamSpeak3::PERM_CAT_GLOBAL_ADM_ACTIONS)
      return "Global / Administration";
    if($pcat == TeamSpeak3::PERM_CAT_GLOBAL_SETTINGS)
      return "Global / Settings";
    if($pcat == TeamSpeak3::PERM_CAT_SERVER)
      return "Virtual Server";
    if($pcat == TeamSpeak3::PERM_CAT_SERVER_INFORMATION)
      return "Virtual Server / Information";
    if($pcat == TeamSpeak3::PERM_CAT_SERVER_ADM_ACTIONS)
      return "Virtual Server / Administration";
    if($pcat == TeamSpeak3::PERM_CAT_SERVER_SETTINGS)
      return "Virtual Server / Settings";
    if($pcat == TeamSpeak3::PERM_CAT_CHANNEL)
      return "Channel";
    if($pcat == TeamSpeak3::PERM_CAT_CHANNEL_INFORMATION)
      return "Channel / Information";
    if($pcat == TeamSpeak3::PERM_CAT_CHANNEL_CREATE)
      return "Channel / Create";
    if($pcat == TeamSpeak3::PERM_CAT_CHANNEL_MODIFY)
      return "Channel / Modify";
    if($pcat == TeamSpeak3::PERM_CAT_CHANNEL_DELETE)
      return "Channel / Delete";
    if($pcat == TeamSpeak3::PERM_CAT_CHANNEL_ACCESS)
      return "Channel / Access";
    if($pcat == TeamSpeak3::PERM_CAT_GROUP)
      return "Group";
    if($pcat == TeamSpeak3::PERM_CAT_GROUP_INFORMATION)
      return "Group / Information";
    if($pcat == TeamSpeak3::PERM_CAT_GROUP_CREATE)
      return "Group / Create";
    if($pcat == TeamSpeak3::PERM_CAT_GROUP_MODIFY)
      return "Group / Modify";
    if($pcat == TeamSpeak3::PERM_CAT_GROUP_DELETE)
      return "Group / Delete";
    if($pcat == TeamSpeak3::PERM_CAT_CLIENT)
      return "Client";
    if($pcat == TeamSpeak3::PERM_CAT_CLIENT_INFORMATION)
      return "Client / Information";
    if($pcat == TeamSpeak3::PERM_CAT_CLIENT_ADM_ACTIONS)
      return "Client / Admin";
    if($pcat == TeamSpeak3::PERM_CAT_CLIENT_BASICS)
      return "Client / Basics";
    if($pcat == TeamSpeak3::PERM_CAT_CLIENT_MODIFY)
      return "Client / Modify";
    if($pcat == TeamSpeak3::PERM_CAT_FILETRANSFER)
      return "File Transfer";
    if($pcat == TeamSpeak3::PERM_CAT_NEEDED_MODIFY_POWER)
      return "Grant";

    return "Unknown";
  }

permissionType()

static permissionType (   $type )

static

Converts a given permission type ID to a human readable name.

Parameters

integer

$type

Returns

string

  {
    if($type == TeamSpeak3::PERM_TYPE_SERVERGROUP)
      return "Server Group";
    if($type == TeamSpeak3::PERM_TYPE_CLIENT)
      return "Client";
    if($type == TeamSpeak3::PERM_TYPE_CHANNEL)
      return "Channel";
    if($type == TeamSpeak3::PERM_TYPE_CHANNELGROUP)
      return "Channel Group";
    if($type == TeamSpeak3::PERM_TYPE_CHANNELCLIENT)
      return "Channel Client";

    return "Unknown";
  }

seconds()

static seconds (   $seconds,   $is_ms = FALSE,   $format = "%dD %02d:%02d:%02d"  )

static

Converts seconds/milliseconds to a human readable value.

Parameters

integer	$seconds
boolean	$is_ms
string	$format

Returns

string

                                                                              :%02d:%02d")
  {
    if($is_ms) $seconds = $seconds/1000;

    return sprintf($format, $seconds/60/60/24, ($seconds/60/60)%24, ($seconds/60)%60, $seconds%60);
  }

version()

static version (   $version,   $format = "Y-m-d h:i:s"  )

static

Returns a client-like formatted version of the TeamSpeak 3 version string.

Parameters

string	$version
string	$format

Returns

string

                                                             :i:s")
  {
    if(!$version instanceof TeamSpeak3_Helper_String)
    {
      $version = new TeamSpeak3_Helper_String($version);
    }

    $buildno = $version->section("[", 1)->filterDigits()->toInt();

    return ($buildno <= 15001) ? $version : $version->section("[")->append("(" . date($format, $buildno) . ")");
  }

versionShort()

static versionShort (   $version )

static

Returns a client-like short-formatted version of the TeamSpeak 3 version string.

Parameters

string

$version

Returns

string

  {
    if(!$version instanceof TeamSpeak3_Helper_String)
    {
      $version = new TeamSpeak3_Helper_String($version);
    }
    
    return $version->section(" ", 0);
  }

---

The documentation for this class was generated from the following file:

• /Volumes/home/Repositories/planetteamspeak/ts3phpframework/libraries/TeamSpeak3/Helper/Convert.php