PHPackages                             clansuite/serverquery - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. clansuite/serverquery

ActiveLibrary[HTTP & Networking](/categories/http)

clansuite/serverquery
=====================

A PHP library to query game and voice servers for their status and player information (e.g. CSGO, Quake3, TeamSpeak).

11PHPCI passing

Since Jun 25Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/Clansuite/ServerQuery)[ Packagist](https://packagist.org/packages/clansuite/serverquery)[ RSS](/packages/clansuite-serverquery/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (3)Used By (0)

Clansuite Server Query
======================

[](#clansuite-server-query)

Clansuite Server Query is a PHP library that allows you to query game and voice servers.

See the [list of supported servers](/docs/protocols.md).

This library is a complete rewrite of the deprecated gsQuery by Jeremias Reith. It is also inspired by projects such as hlsw, kquery, squery, GameQ, and phgstats.

Requirements
------------

[](#requirements)

- PHP 8.2+

Installation
------------

[](#installation)

`composer require clansuite/ServerQuery`

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

```
require_once 'vendor/autoload.php';

$factory = new Clansuite\ServerQuery\CSQuery();
$server = $factory->createInstance('Quake3a', '172.104.253.108', 27980);

if ($server->query_server()) {
    // Get JSON output
    $json = $server->toJson();

    // Get HTML table output
    $html = $server->toHtml();

    echo $html; // Display in browser
}
```

### Web Interface

[](#web-interface)

Use the included web interface:

```
# JSON output (default)
curl "http://localhost/serializer.php?protocol=Quake3a&host=172.104.253.108&queryport=27980"

# HTML output
curl "http://localhost/serializer.php?protocol=Quake3a&host=172.104.253.108&queryport=27980&format=html"
```

The HTML output provides a styled table view of server information, players, and server rules.

### Capture Tool

[](#capture-tool)

To capture network packets for testing fixtures:

```
php bin/capture 192.168.1.10 27015 source
```

This saves fixtures in `/tests/fixtures/` for reliable testing without external dependencies.

Configuration is in `/config/capture_config.php`.

Testing
-------

[](#testing)

Testing a server query library requires validating its ability to communicate with real game or voice servers and correctly parse their responses.

To ensure reliability and compatibility across different server implementations, it’s helpful to cross-reference results with established server monitoring and listing platforms, such as:

-
-
-
-

These services provide up-to-date server status, player counts, and metadata, making them valuable benchmarks for verifying the accuracy and robustness of a server query protocol implementation.

Documentation
-------------

[](#documentation)

- [User Manual](docs/user-manual/) - Installation, usage, and troubleshooting.
- [Developer Manual](docs/developer-manual/) - Architecture, API, and contribution guide.
- [API Documentation](https://api.clansuite.com) - Generated API documentation.

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance56

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 Bus Factor1

Top contributor holds 89.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/3a4ac38be149d29b9cd37b203a37d3f1684a6aeeb28779105c86f358e226a7f4?d=identicon)[jakoch](/maintainers/jakoch)

---

Top Contributors

[![jakoch](https://avatars.githubusercontent.com/u/85608?v=4)](https://github.com/jakoch "jakoch (57 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)")

---

Tags

game-serverphpqueryservervoice-server

### Embed Badge

![Health badge](/badges/clansuite-serverquery/health.svg)

```
[![Health](https://phpackages.com/badges/clansuite-serverquery/health.svg)](https://phpackages.com/packages/clansuite-serverquery)
```

###  Alternatives

[php-http/cache-plugin

PSR-6 Cache plugin for HTTPlug

25126.1M82](/packages/php-http-cache-plugin)[illuminate/http

The Illuminate Http package.

11937.9M6.9k](/packages/illuminate-http)[rdkafka/rdkafka

A PHP extension for Kafka

2.2k24.3k1](/packages/rdkafka-rdkafka)[httpsoft/http-message

Strict and fast implementation of PSR-7 and PSR-17

87965.9k114](/packages/httpsoft-http-message)[mezzio/mezzio-router

Router subcomponent for Mezzio

265.4M92](/packages/mezzio-mezzio-router)[serpapi/google-search-results-php

Get Google, Bing, Baidu, Ebay, Yahoo, Yandex, Home depot, Naver, Apple, Duckduckgo, Youtube search results via SerpApi.com

69127.2k](/packages/serpapi-google-search-results-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)