Balkan SA:MP

<?php/*********************************************** SA-MP Query Server Version 0.3** This class provides you with an easy to use interface to query* your SA-MP 0.2 servers. Usage is simple, but has changed a bit* since the last version, so be sure to check out the examples* that come along with this script. It is updated with some of* the new SA-MP 0.2 query-techniques that can be used.** Author:  Peter Beverloo*          peter@dmx-network.com*          Ex SA-MP Developer** Updated: Wouter van Eekelen*          wouter.van.eekelen@serverffs.com*          SA-MP Betatester*********************************************/class QueryServer{    // Private variables used for the query-ing.    private $szServerIP;    private $iPort;    private $rSocketID;    private $bStatus;    // The __construct function gets called automatically    // by PHP once the class gets initialized.    function __construct( $szServerIP, $iPort )    {            $this->szServerIP = $this->VerifyAddress( $szServerIP );            $this->iPort = $iPort;            if (empty( $this->szServerIP ) || !is_numeric( $iPort )) {                    throw new QueryServerException( 'Either the ip-address or the port isn\'t filled in correctly.' );            }            $this->rSocketID = @fsockopen( 'udp://' . $this->szServerIP, $iPort, $iErrorNo, $szErrorStr, 5 );            if (!$this->rSocketID) {                    throw new QueryServerException( 'Cannot connect to the server: ' . $szErrorStr );            }            socket_set_timeout( $this->rSocketID, 0, 500000 );            $this->bStatus = true;    }    // The VerifyAddress function verifies the given hostname/    // IP address and returns the actual IP Address.    function VerifyAddress( $szServerIP )    {            if (ip2long( $szServerIP ) !== false &&                 long2ip( ip2long( $szServerIP ) ) == $szServerIP ) {                    return $szServerIP;            }            $szAddress = gethostbyname( $szServerIP );            if ($szAddress == $szServerIP) {                    return "";            }            return $szAddress;    }    // The SendPacket function sends a packet to the server which    // requests information, based on the type of packet send.    function SendPacket( $cPacket )    {            $szPacket = 'SAMP';            $aIpChunks = explode( '.', $this->szServerIP );            foreach( $aIpChunks as $szChunk ) {                    $szPacket .= chr( $szChunk );            }            $szPacket .= chr( $this->iPort & 0xFF );            $szPacket .= chr( $this->iPort >> 8 & 0xFF );            $szPacket .= $cPacket;            return fwrite( $this->rSocketID, $szPacket, strlen( $szPacket ) );    }    // The GetPacket() function returns a specific number of bytes    // read from the socket. This uses a special way of getting stuff.    function GetPacket( $iBytes )    {            $iResponse = fread( $this->rSocketID, $iBytes );            if ($iResponse === false) {                    throw new QueryServerException( 'Connection to ' . $this->szServerIP . ' failed or has dropped.' );            }            $iLength = ord( $iResponse );            if ($iLength > 0)                    return fread( $this->rSocketID, $iLength );            return "";    }    // After we're done, the connection needs to be closed using    // the Close() function. Otherwise stuff might go wrong.    function Close( )    {            if ($this->rSocketID !== false) {                    fclose( $this->rSocketID );            }    }    // A little function that's needed to properly convert the    // four bytes we're recieving to integers to an actual PHP    // integer. ord() can't handle value's higher then 255.    function toInteger( $szData )    {            $iInteger = 0;            $iInteger += ( ord( @$szData[ 0 ] ) );            $iInteger += ( ord( @$szData[ 1 ] ) << 8 );            $iInteger += ( ord( @$szData[ 2 ] ) << 16 );            $iInteger += ( ord( @$szData[ 3 ] ) << 24 );            if( $iInteger >= 4294967294 )                    $iInteger -= 4294967296;            return $iInteger;    }    // The GetInfo() function returns basic information about the    // server, like the hostname, number of players online etc.    function GetInfo( )    {            if ($this->SendPacket('i') === false) {                    throw new QueryServerException( 'Connection to ' . $this->szServerIP . ' failed or has dropped.' );            }            $szFirstData = fread( $this->rSocketID, 4 );            if (empty( $szFirstData ) || $szFirstData != 'SAMP') {                    throw new QueryServerException( 'The server at ' . $this->szServerIP . ' is not an SA-MP Server.' );            }            // Pop the first seven characters returned.            fread( $this->rSocketID, 7 );            return array (                    'Password'   =>   ord( fread( $this->rSocketID, 1 ) ),                    'Players'    =>   $this->toInteger( fread( $this->rSocketID, 2 ) ),                    'MaxPlayers' =>   $this->toInteger( fread( $this->rSocketID, 2 ) ),                    'Hostname'   =>   $this->GetPacket( 4 ),                    'Gamemode'   =>   $this->GetPacket( 4 ),                    'Map'        =>   $this->GetPacket( 4 )            );    }    // The GetRules() function returns the rules which are set    // on the server, e.g. the gravity, version etcetera.    function GetRules( )    {            if ($this->SendPacket('r') === false) {                    throw new QueryServerException( 'Connection to ' . $this->szServerIP . ' failed or has dropped.' );            }            // Pop the first 11 bytes from the response;            fread( $this->rSocketID, 11 );            $iRuleCount = ord( fread( $this->rSocketID, 2 ) );            $aReturnArray = array( );            for( $i = 0; $i < $iRuleCount; $i ++ ) {                    $szRuleName = $this->GetPacket( 1 );                    $aReturnArray[ $szRuleName ] = $this->GetPacket( 1 );            }            return $aReturnArray;    }    // The GetPlayers() function is pretty much simelar to the    // detailed function, but faster and contains less information.    function GetPlayers( )    {            if ($this->SendPacket('c') === false) {                    throw new QueryServerException( 'Connection to ' . $this->szServerIP . ' failed or has dropped.' );            }            // Again, pop the first eleven bytes send;            fread( $this->rSocketID, 11 );            $iPlayerCount = ord( fread( $this->rSocketID, 2 ) );            $aReturnArray = array( );            for( $i = 0; $i < $iPlayerCount; $i ++ )            {                    $aReturnArray[ ] = array (                            'Nickname' => $this->GetPacket( 1 ),                            'Score'    => $this->toInteger( fread( $this->rSocketID, 4 ) )                    );            }            return $aReturnArray;    }    // The GetDetailedPlayers() function returns the player list,    // but in a detailed form inclusing the score and the ping.    function GetDetailedPlayers( )    {            if ($this->SendPacket('d') === false) {                    throw new QueryServerException( 'Connection to ' . $this->szServerIP . ' failed or has dropped.' );            }            // Skip the first 11 bytes of the response;            fread( $this->rSocketID, 11 );            $iPlayerCount = ord( fread( $this->rSocketID, 2 ) );            $aReturnArray = array( );            for( $i = 0; $i < $iPlayerCount; $i ++ ) {                    $aReturnArray[ ] = array(                            'PlayerID'   =>  $this->toInteger( fread( $this->rSocketID, 1 ) ),                            'Nickname'   =>  $this->GetPacket( 1 ),                            'Score'      =>  $this->toInteger( fread( $this->rSocketID, 4 ) ),                            'Ping'       =>  $this->toInteger( fread( $this->rSocketID, 4 ) )                    );            }            return $aReturnArray;    }function RCON($rcon, $command)    {            echo 'Password '.$rcon.' with '.$command;            if ($this->SendPacket('x '.$rcon.' '.$command) === false) {                    throw new QueryServerException( 'Connection to ' . $this->szServerIP . ' failed or has dropped.' );            }            // Pop the first 11 bytes from the response;            $aReturnArray = fread( $this->rSocketID, 11 );            echo fread( $this->rSocketID, 11 );            return $aReturnArray;    }}/*********************************************** The QueryServerException is used to throw errors when querying* a specific server. That way we force the user to use proper* error-handling, and preferably even a try-/catch statement.***********************************************/class QueryServerException extends Exception{    // The actual error message is stored in this variable.    private $szMessage;    // Again, the __construct function gets called as soon    // as the exception is being thrown, in here we copy the message.    function __construct( $szMessage )    {            $this->szMessage = $szMessage;    }    // In order to read the exception being thrown, we have    // a .NET-like toString() function, which returns the message.    function toString( )    {            return $this->szMessage;    }}?>