[Utilitário] samp-query-php

[Calasans]

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!

• Repositório: samp-query-php
  
• Desenvolvido por: Calasans