PHPackages                             ogsteam/ogspy - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. ogsteam/ogspy

ActiveToolbox[Utility &amp; Helpers](/categories/utility)

ogsteam/ogspy
=============

OGSpy collects data from a game and provide statistics to their players

4.0.3(2mo ago)102611[29 issues](https://github.com/OGSteam/ogspy/issues)[1 PRs](https://github.com/OGSteam/ogspy/pulls)GPL-2.0-onlyPHPPHP &gt;=8.1CI passing

Since Nov 19Pushed 1w ago3 watchersCompare

[ Source](https://github.com/OGSteam/ogspy)[ Packagist](https://packagist.org/packages/ogsteam/ogspy)[ Docs](https://github.com/ogsteam/ogspy)[ RSS](/packages/ogsteam-ogspy/feed)WikiDiscussions develop Synced today

READMEChangelog (10)Dependencies (12)Versions (68)Used By (0)

OGSpy
=====

[](#ogspy)

[![GitHub Issues](https://camo.githubusercontent.com/fa874efcfee6c172f1b38a2a76cbbf0d3549e39581fb825ebffa6e25a08ceadb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f4f47535465616d2f6f677370792e737667)](https://github.com/OGSTeam/ogspy/issues) [![Version Courante](https://camo.githubusercontent.com/c39e3ba59c48c668f097b0e6c7e7131ae844de76bf363e81f94707af7aff586f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d342e302e302d677265656e2e737667)](https://github.com/OGSTeam/ogspy) [![Demo](https://camo.githubusercontent.com/8706869f07cee94d82dd83de003dcc0e6ac49c2ae6c0affd1834b87370f4679b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64656d6f2d6f6e6c696e652d677265656e2e737667)](https://ogspy.fr/demo)

Le projet crée en 2006 est une aide pour un jeu de gestion de vaisseaux spatiaux. Le but de cet outil est de récupérer l'ensemble des informations du Jeu pour ensuite les regrouper et les exploiter.

Visitez notre forum [OGSteam.eu](https://forum.ogsteam.eu) pour en savoir plus.

---

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

[](#documentation)

Notre espace documentaire est construit par nos utilisateurs via notre wiki. Vous pouvez y trouver les descriptifs de nos applications ainsi que les procédures d'installation.

[Wiki OGSteam](https://wiki.ogsteam.eu)

Des tutoriels d'installation sont aussi disponibles sur notre chaine Youtube : [Youtube](https://www.youtube.com/playlist?list=PLF1RvCcSTS6M28sPpadlerKcuwhhTBtrQ)

### Fonctionnalités

[](#fonctionnalités)

- Enregistrement des Galaxies et des classements
- Recherches des emplacements joueurs
- Stockage des rapports d'espionnages et de combats
- Gestion des utilisateurs et groupes
- Comparaison de la progression des joueurs
- Simulation des productions
- Possibilité d'ajouter de nombreuses extensions

---

### Prérequis serveur

[](#prérequis-serveur)

Avant d'installer OGSpy, assurez-vous que votre serveur répond aux exigences suivantes :

#### PHP

[](#php)

ÉlémentVersion minimaleVersion recommandéePHP8.18.4#### Extensions PHP requises

[](#extensions-php-requises)

ExtensionRôle`mysqli`Connexion à la base de données`json`Encodage/décodage JSON`mbstring`Gestion des chaînes multi-octets`openssl`Chiffrement et tokens sécurisés`zlib`Compression`zip`Gestion des archives ZIP#### Extensions PHP recommandées (utilisées par certains mods)

[](#extensions-php-recommandées-utilisées-par-certains-mods)

ExtensionMod concernéRôle`curl``bthof`Test de connectivité HTTP (optionnel, vérifié à l'exécution)`simplexml``superapix`Lecture de fichiers XML#### Base de données

[](#base-de-données)

LogicielVersion minimaleVersion recommandéeMariaDB10.412.2> **Note :** MySQL 5.7+ est également compatible mais MariaDB est recommandé.

#### Serveur web

[](#serveur-web)

Apache 2.4+ ou Nginx 1.18+ avec support PHP-FPM.

#### Installation rapide (Ubuntu / Debian)

[](#installation-rapide-ubuntu--debian)

> **Ubuntu 26.04 LTS** : PHP 8.4 est disponible nativement, aucun PPA nécessaire.
> **Ubuntu 22.04 / 24.04** : PHP 8.4 nécessite le PPA `ondrej/php` :
>
> ```
> add-apt-repository ppa:ondrej/php -y && apt update
> ```

```
# Installer Apache, MariaDB et PHP avec les extensions requises
apt install -y mariadb-server apache2 libapache2-mod-php8.4 \
  php8.4 php8.4-mysql php8.4-mbstring php8.4-zip php8.4-xml php8.4-curl

systemctl restart apache2
```

Créer la base de données :

```
mysql -u root
CREATE DATABASE ogspy;
CREATE USER 'ogspy'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON ogspy.* TO 'ogspy'@'localhost';
FLUSH PRIVILEGES;
EXIT;
```

Télécharger et extraire la dernière release :

```
# Télécharger la dernière release depuis GitHub
LATEST_ZIP=$(curl -s https://api.github.com/repos/OGSteam/ogspy/releases/latest \
  | grep "browser_download_url.*\.zip" | cut -d '"' -f 4)
curl -L "$LATEST_ZIP" -o ogspy.zip
unzip ogspy.zip -d /var/www/html/
```

Puis lancer l'installation via la CLI :

```
cd /var/www/html
php install/upgrade_cli.php install localhost ogspy password ogspy admin admin123 admin@example.com ogspy_
```

Ou via l'interface web : `http://votre-serveur/install/`.

---

### Installation et usages

[](#installation-et-usages)

Vous trouverez sur le wiki le manuel d'installation d'OGSpy sur un serveur web. Mais il existe aussi des hébergeurs qui installent le site pour vous.

[Wiki de l'OGSteam](https://wiki.ogsteam.eu/doku.php)

### Démo

[](#démo)

Vous pouvez tester un serveur OGSpy, une démo est disponible :

- Serveur de test :
- Nom d'utilisateur : demo
- Mot de passe : ogsteam

---

Contribuer au projet
--------------------

[](#contribuer-au-projet)

Gestion des montées de version
------------------------------

[](#gestion-des-montées-de-version)

OGSpy dispose d'un système de migration automatisé qui gère les montées de version de manière transparente.

### Processus pour une nouvelle version

[](#processus-pour-une-nouvelle-version)

\*\*Montée de version simplifiée : il suffit de merger sur master. De build et de Retro Merge sur Develop. Le Github Actions insérera la nouvelle version à la création du package.

Il restera à publier la Release crée en daft.

#### Synchronisation automatique

[](#synchronisation-automatique)

Le système de migration détecte automatiquement les changements de version et synchronise la base de données :

- ✅ **Détection automatique** : Compare `$ogspy_version` avec la version en base
- ✅ **Synchronisation transparente** : Met à jour automatiquement si différente
- ✅ **Aucune migration requise** : Pas besoin de créer de fichier de migration pour une simple montée de version

#### Si nouvelles migrations nécessaires

[](#si-nouvelles-migrations-nécessaires)

Uniquement si la nouvelle version nécessite des modifications de schéma ou de données :

1. Créez les migrations correspondantes dans `install/migrations/`
2. La synchronisation de version reste automatique

### Avantages

[](#avantages)

- **Compatible CI/CD** : Fonctionne parfaitement avec les pipelines automatisés
- **Détection intelligente** : Compare automatiquement les versions et synchronise si nécessaire
- **Zéro maintenance** : Plus besoin de créer des migrations vides pour les montées de version
- **Historique propre** : Seules les vraies migrations (schéma/données) sont dans l'historique
- Vous pouvez nous aider sur le développement
- Nous avons besoins de vos idées pour améliorer l'outil
- Des volontaires pour la documentations dans toutes les langues connues
- Traductions

Vous pouvez nous poser toutes les questions nécessaires sur notre forum.

### Equipe projet

[](#equipe-projet)

Responsable équipe : [DarkNoon](https://github.com/darknoon29)

#### Développement

[](#développement)

- [Machine](https://github.com/machine62)
- [Jedinight](https://github.com/jedi-night)
- Superbox
- [Pitch314](https://github.com/pitch314)
- Shad
- Xaviernuma
- Ninety
- [Itori](https://github.com/Itori)
- [Mascotte](https://github.com/mascotte88)

#### Tests

[](#tests)

- [Roms0406](https://github.com/Roms0406)

#### Graphismes

[](#graphismes)

- Chris Alys

### Branches de travail

[](#branches-de-travail)

- master - Branche principale, utilisée uniquement pour publier les versions finales de nos outils.
- development - Branche qui contient les développements pour les futures versions.
- release-3.X.Y - Branche contenant les correctifs pour une future version.

License
-------

[](#license)

> Vous pouvez consulter la license [ici](https://github.com/OGSTeam/ogspy/blob/master/LICENSE)

Le projet est diffusé sous la license **GPLV2**.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance72

Regular maintenance activity

Popularity16

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity86

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 61.9% 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.

###  Release Activity

Cadence

Every ~74 days

Total

35

Last Release

77d ago

Major Versions

3.3.10 → 4.0.02025-08-30

PHP version history (5 changes)3.3.7-beta5PHP &gt;=7.0.0

3.3.8-beta1PHP &gt;=8.1

3.3.8-beta6PHP &gt;=7.4

3.3.10PHP &gt;=8.2

4.0.0PHP &gt;=8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/13015521?v=4)[Anthony](/maintainers/darknoon29)[@darknoon29](https://github.com/darknoon29)

---

Top Contributors

[![darknoon29](https://avatars.githubusercontent.com/u/13015521?v=4)](https://github.com/darknoon29 "darknoon29 (1108 commits)")[![machine62](https://avatars.githubusercontent.com/u/28401480?v=4)](https://github.com/machine62 "machine62 (207 commits)")[![pitch314](https://avatars.githubusercontent.com/u/8677243?v=4)](https://github.com/pitch314 "pitch314 (201 commits)")[![transifex-integration[bot]](https://avatars.githubusercontent.com/in/18568?v=4)](https://github.com/transifex-integration[bot] "transifex-integration[bot] (146 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (49 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (35 commits)")[![Itori](https://avatars.githubusercontent.com/u/4712142?v=4)](https://github.com/Itori "Itori (13 commits)")[![jedi-night](https://avatars.githubusercontent.com/u/13046802?v=4)](https://github.com/jedi-night "jedi-night (12 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (9 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (3 commits)")[![Choubakawa](https://avatars.githubusercontent.com/u/30017832?v=4)](https://github.com/Choubakawa "Choubakawa (2 commits)")[![PastisD](https://avatars.githubusercontent.com/u/442023?v=4)](https://github.com/PastisD "PastisD (2 commits)")[![Roms0406](https://avatars.githubusercontent.com/u/25012902?v=4)](https://github.com/Roms0406 "Roms0406 (1 commits)")[![juliogonzalez](https://avatars.githubusercontent.com/u/4226070?v=4)](https://github.com/juliogonzalez "juliogonzalez (1 commits)")[![Steffronte](https://avatars.githubusercontent.com/u/61603453?v=4)](https://github.com/Steffronte "Steffronte (1 commits)")[![binu5975](https://avatars.githubusercontent.com/u/63189165?v=4)](https://github.com/binu5975 "binu5975 (1 commits)")

---

Tags

gameplatformogspy

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ogsteam-ogspy/health.svg)

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

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.6k38.2k](/packages/matomo-matomo)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)[getkirby/cms

The Kirby core

1.5k567.4k438](/packages/getkirby-cms)

PHPackages © 2026

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