Compare commits

..

No commits in common. "main" and "1.0.1" have entirely different histories.
main ... 1.0.1

2 changed files with 71 additions and 119 deletions

View file

@ -22,8 +22,4 @@ var_dump(
var_dump( var_dump(
$master->getErrors() $master->getErrors()
); );
``` ```
## Projects
* [HLState](https://github.com/YGGverse/HLState) - Web Monitor for Half-Life Servers

View file

@ -4,124 +4,77 @@ declare(strict_types=1);
namespace Yggverse\Hl\Xash3D; namespace Yggverse\Hl\Xash3D;
enum Family: int {
case IPv4 = 4;
case IPv6 = 16;
}
enum Region: string {
case USEastCoast = "0x00";
case USWestCoast = "0x01";
case SouthAmerica = "0x02";
case Europe = "0x03";
case Asia = "0x04";
case Australia = "0x05";
case MiddleEast = "0x06";
case Africa = "0x07";
case World = "0xff";
}
enum Game: string {
case Valve = "valve";
}
class Master class Master
{ {
private string $_host; private $_socket;
private int $_port; private $_errors = [];
private int $_timeout;
private array $_errors = [];
public function __construct( public function __construct(
string $host, string $host,
int $port = 27010, int $port,
int $timeout = 5 int $timeout = 5
) )
{ {
$this->_host = $host; $this->_socket = fsockopen(
$this->_port = $port; "udp://{$host}",
$this->_timeout = $timeout; $port,
}
private function _fclose(
mixed $socket
)
{
if (true === is_resource($socket))
{
fclose(
$socket
);
}
}
// Legacy protocol implementation does not support mixed address families
// in the binary master socket response, use separated method for IPv4 servers.
public function getServers(
int $limit = 100,
string $host = "0.0.0.0",
int $port = 0,
Game $game = Game::Valve,
Region $region = Region::World
): ?array
{
$family = filter_var($host, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) ? Family::IPv4 : Family::IPv6;
// Init connection
$socket = fsockopen(
"udp://{$this->_host}",
$this->_port,
$code, $code,
$message, $message,
$this->_timeout $timeout
); );
$master = "{$this->_host}:{$this->_port}"; if (is_resource($this->_socket))
// Is connected
if (true === is_resource($socket))
{ {
stream_set_timeout( stream_set_timeout(
$socket, $this->_socket,
$this->_timeout $timeout
); );
} }
else else
{ {
$this->_errors[] = sprintf( $this->_errors[] = sprintf(
_("Connection error for $master: %s"), _('Connection error: %s'),
$message $message
); );
}
}
$this->_fclose( public function __destruct()
$socket {
); fclose(
$this->_socket
);
}
public function getServersIPv6(
int $limit = 100,
string $region = "\xFF",
string $host = "0.0.0.0:0",
int $port = 0,
string $gamedir = "valve"
): ?array
{
// Is connected
if (false === is_resource($this->_socket))
{
$this->_errors[] = _('Socket connection error');
return null; return null;
} }
// Filter query // Filter query
if (false === fwrite($socket, "1{$region->value}{$host}:{$port}\0\\gamedir\\{$game->value}\0")) if (false === fwrite($this->_socket, "1{$region}{$host}:{$port}\0\gamedir\t{$gamedir}\0"))
{ {
$this->_errors[] = _("Could not send socket query for $master"); $this->_errors[] = _('Could not send socket query');
$this->_fclose(
$socket
);
return null; return null;
} }
// Skip header // Skip header
if (false === fread($socket, 6)) if (false === fread($this->_socket, 6))
{ {
$this->_errors[] = _("Could not init packet header for $master"); $this->_errors[] = _('Could not init packet header');
$this->_fclose(
$socket
);
return null; return null;
} }
@ -131,59 +84,62 @@ class Master
for ($i = 0; $i < $limit; $i++) for ($i = 0; $i < $limit; $i++)
{ {
// Get host bytes // Get host
if (false === $host = fread($socket, $family->value)) if (false === $host = fread($this->_socket, 16))
{
$this->_errors[] = _("Invalid `host` fragment in packet at $i for $master");
break;
}
// End of packet
if (true === str_ends_with(bin2hex($host), bin2hex("\0\0\0\0\0\0")))
{ {
break; break;
} }
// Get host string // Is end of packet
if (true === str_starts_with($host, (string) 0))
{
break;
}
// Skip invalid host value
if (false === $host = inet_ntop($host)) if (false === $host = inet_ntop($host))
{ {
$this->_errors[] = _("Invalid `host` value in packet at $i for $master"); // Shift port bytes
break; fread($this->_socket, 2);
continue;
} }
// Get port bytes // Decode first byte for port
if (false === $p = fread($socket, 2)) if (false === $byte1 = fread($this->_socket, 1))
{ {
$this->_errors[] = _("Invalid `port` fragment in packet at $i for $master"); // Shift port byte
break; fread($this->_socket, 1);
continue;
} }
// Get port value // Decode second byte for port
if (false === $p = unpack('nport', $p)) if (false === $byte2 = fread($this->_socket, 1))
{ {
$this->_errors[] = _("Invalid `port` value in packet at $i for $master"); continue;
break;
} }
// Validate result // Calculate port value
if (false === filter_var($host, FILTER_VALIDATE_IP, $family == Family::IPv6 ? FILTER_FLAG_IPV6 $port = ord($byte1) * 256 + ord($byte2);
: FILTER_FLAG_IPV4) || empty($p['port']))
// Validate IPv6 result
if (
false !== strpos($host, '.') || // filter_var not always works with mixed IPv6
false === filter_var($host, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6) ||
false === filter_var($port, FILTER_VALIDATE_INT)
)
{ {
$this->_errors[] = _("Invalid socket address in packet at $i for $master"); continue;
break;
} }
$servers["{$host}{$p['port']}"] = // keep unique $servers["[{$host}]:{$port}"] = // keep unique
[ [
'host' => $host, 'host' => $host,
'port' => $p['port'] 'port' => $port
]; ];
} }
$this->_fclose(
$socket
);
return $servers; return $servers;
} }