Portal SAMP
[Utilitário] samp-query-php - Versão de Impressão

+- Portal SAMP (https://portalsamp.com)
+-- Fórum: SA-MP (https://portalsamp.com/forumdisplay.php?fid=5)
+--- Fórum: Lançamentos (https://portalsamp.com/forumdisplay.php?fid=26)
+---- Fórum: Utilitários (https://portalsamp.com/forumdisplay.php?fid=28)
+---- Tópico: [Utilitário] samp-query-php (/showthread.php?tid=4906)

samp-query-php - Calasans - 21/10/2024

samp-query-php
Introdução:
  • samp-query-php é uma API em PHP desenvolvida para consultar e obter informações de servidores SA-MP (San Andreas Multiplayer). Esta API permite que você verifique se um servidor está online, obtenha o ping, informações básicas e detalhadas sobre o servidor, jogadores conectados e regras do servidor. A API também inclui um sistema de tentativas automáticas para garantir que os dados sejam obtidos de forma confiável.

Características:
  1. Consulta rápida e eficiente de servidores SA-MP.
  2. Requisição de informações básicas e detalhadas do servidor.
  3. Possibilidade de obtenção de dados sobre jogadores e regras do servidor.
  4. Sistema de tentativas automático para garantir a obtenção dos dados.
  5. Configuração de timeouts para conexão e resposta.
  6. Fechamento automático do socket ao término da operação.
  7. Suporte a múltiplos idiomas para informações do servidor.
  8. Limitação personalizada para a exibição de jogadores.

Incluir no projeto:
  • Inclua o arquivo samp-query.php no seu projeto e instancie a classe samp_query passando o endereço IP e a porta do servidor SA-MP que deseja consultar.

Exemplos de uso

Exemplo de uso básico:
Código PHP:
require 'samp-query.php';

$server = new samp_query('127.0.0.1', 7777);

if ($server->Esta_Online()) {
    echo "Servidor está online!";
    echo "Ping: " . $server->Obter_Ping() . " ms";
    
    $info = $server->Obter_Informacoes();
    print_r($info);
    
    $jogadores = $server->Obter_Jogadores_0();
    print_r($jogadores);
    
    $regras = $server->Obter_Regras();
    print_r($regras);
} else {
    echo "Servidor está offline.";
} 

Exemplo com múltiplos servidores:
Código PHP:
require 'samp-query.php';

$servidores = [
    ['ip' => '127.0.0.1', 'porta' => 7777],
    ['ip' => '192.168.0.1', 'porta' => 7778],
];

foreach ($servidores as $dados) {
    $server = new samp_query($dados['ip'], $dados['porta']);
    
    if ($server->Esta_Online()) {
        echo "Servidor " . $dados['ip'] . ":" . $dados['porta'] . " está online!";
        echo "Ping: " . $server->Obter_Ping() . " ms\n";
    } else {
        echo "Servidor " . $dados['ip'] . ":" . $dados['porta'] . " está offline.\n";
    }
} 

Leia o repositório disponibilizado no GitHub para saber mais!