PHPackages                             ycdev/php-igc-inspector - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. ycdev/php-igc-inspector

ActiveLibrary[Parsing & Serialization](/categories/parsing)

ycdev/php-igc-inspector
=======================

Php library for manipulating IGC files

V0.1.0(4mo ago)00GPL-3.0-onlyPHPPHP >=7.4

Since Jan 12Pushed 4mo agoCompare

[ Source](https://github.com/CymDeveloppement/phpIgcInspector)[ Packagist](https://packagist.org/packages/ycdev/php-igc-inspector)[ Docs](https://github.com/CymDeveloppement/phpIgcInspector)[ RSS](/packages/ycdev-php-igc-inspector/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

phpIgcInspector
===============

[](#phpigcinspector)

Bibliothèque PHP pour lire et manipuler les fichiers IGC (International Gliding Commission).

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

[](#installation)

```
composer require ycdev/php-igc-inspector
```

Utilisation de base
-------------------

[](#utilisation-de-base)

```
use Ycdev\PhpIgcInspector\PhpIgcInspector;

// Créer une instance depuis un fichier
$inspector = PhpIgcInspector::fromFile('vol.igc');

// Valider et parser le fichier
$inspector->validate();

// Récupérer les données parsées
$flight = $inspector->getFlight();

// Exporter en JSON
$json = $inspector->toJson();
```

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

[](#documentation)

Consultez le dossier `doc/` pour les spécifications du format IGC.

Structure
---------

[](#structure)

```
phpIgcInspector/
├── src/
│   ├── PhpIgcInspector.php          # Classe principale
│   ├── PhpIgcUtils.php              # Fonctions utilitaires
│   ├── Exception/
│   │   └── InvalidIgcException.php  # Exception personnalisée
│   ├── Data/
│   │   ├── EventTypeCode.php        # Codes d'événements
│   │   └── ManufacturerCodesData.php # Codes fabricants IGC
│   └── RecordTypes/                 # Types d'enregistrements IGC
└── doc/                              # Documentation et spécifications IGC

```

API - Classe PhpIgcInspector
----------------------------

[](#api---classe-phpigcinspector)

### Constructeur

[](#constructeur)

```
public function __construct(string $content, bool $withRaw = false)
```

Crée une instance avec le contenu brut du fichier IGC.

**Paramètres :**

- `$content` : Contenu du fichier IGC
- `$withRaw` : Si `true`, ajoute le champ 'raw' dans les données parsées

**Exemple :**

```
$content = file_get_contents('vol.igc');
$inspector = new PhpIgcInspector($content);
```

### Méthodes statiques

[](#méthodes-statiques)

#### `fromFile()`

[](#fromfile)

```
public static function fromFile(string $filePath, bool $withRaw = false): self
```

Crée une instance depuis un fichier.

**Paramètres :**

- `$filePath` : Chemin vers le fichier IGC
- `$withRaw` : Si `true`, ajoute le champ 'raw' dans les données parsées

**Retour :** Instance de `PhpIgcInspector`

**Exemple :**

```
$inspector = PhpIgcInspector::fromFile('vol.igc');
```

#### `rawExtractFromFile()`

[](#rawextractfromfile)

```
public static function rawExtractFromFile(string $igcFilePath, string $outputDirectory, ?string $prefix = null): array
```

Extrait chaque type d'enregistrement depuis un fichier IGC dans des fichiers séparés.

**Paramètres :**

- `$igcFilePath` : Chemin vers le fichier IGC source
- `$outputDirectory` : Répertoire de sortie pour les fichiers extraits
- `$prefix` : Préfixe pour les noms de fichiers (optionnel)

**Retour :** Tableau associatif avec le type d'enregistrement comme clé et le chemin du fichier comme valeur

**Exemple :**

```
$files = PhpIgcInspector::rawExtractFromFile('vol.igc', './extracted', 'mon_vol');
// Retourne : ['A' => './extracted/mon_vol_record_A.igc', 'B' => './extracted/mon_vol_record_B.igc', ...]
```

### Méthodes d'instance

[](#méthodes-dinstance)

#### `validate()`

[](#validate)

```
public function validate(): bool
```

Valide et parse le contenu du fichier IGC.

**Retour :** `true` si le fichier est valide

**Lance :** `InvalidIgcException` si le fichier n'est pas valide

**Exemple :**

```
try {
    $inspector->validate();
    echo "Fichier valide !";
} catch (InvalidIgcException $e) {
    echo "Erreur : " . $e->getMessage();
}
```

#### `getFlight()`

[](#getflight)

```
public function getFlight(): ?object
```

Retourne l'objet flight parsé contenant toutes les données du fichier IGC.

**Retour :** Objet flight ou `null` si le fichier n'a pas été validé

**Exemple :**

```
$flight = $inspector->getFlight();
echo "Nombre de points GPS : " . count($flight->Fix);
echo "Pilote : " . $flight->OtherInformation->pilot;
```

#### `getMetadata()`

[](#getmetadata)

```
public function getMetadata(): ?object
```

Retourne uniquement les métadonnées du vol (records uniques uniquement, sans les tableaux de points GPS).

**Retour :** Objet contenant uniquement les métadonnées ou `null`

**Exemple :**

```
$metadata = $inspector->getMetadata();
// Contient : OtherInformation, Task, Manufacturer, etc.
// Ne contient PAS : Fix (tableau de points GPS)
```

#### `toJson()`

[](#tojson)

```
public function toJson(): ?string
```

Retourne l'objet flight au format JSON (avec formatage et caractères Unicode non échappés).

**Retour :** Représentation JSON de l'objet flight ou `null`

**Exemple :**

```
$json = $inspector->toJson();
file_put_contents('flight.json', $json);
```

#### `stringify()`

[](#stringify)

```
public function stringify(int $flags = JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE): ?string
```

Convertit l'objet flight en JSON avec des options personnalisées.

**Paramètres :**

- `$flags` : Options pour `json_encode()` (défaut: `JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE`)

**Retour :** Représentation JSON de l'objet flight ou `null`

**Exemple :**

```
// JSON compact
$json = $inspector->stringify(JSON_UNESCAPED_UNICODE);

// JSON avec options personnalisées
$json = $inspector->stringify(JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_NUMERIC_CHECK);
```

#### `validTurnPoint()`

[](#validturnpoint)

```
public function validTurnPoint(float $proximityRadius = 5000.0): bool
```

Valide les turnpoints en vérifiant la proximité des points GPS avec les waypoints de la tâche.

**Paramètres :**

- `$proximityRadius` : Distance en mètres pour valider la proximité d'un turnpoint (défaut: 5000 m)

**Retour :** `true` si tous les turnpoints sont validés dans l'ordre

**Exemple :**

```
if ($inspector->validTurnPoint(5000.0)) {
    echo "Tous les turnpoints sont validés !";
    $task = $inspector->getFlight()->Task;
    $validation = $task->turnPointValidation;
    echo "Points validés : " . $validation->validatedCount . " / " . $validation->totalWaypoints;
}
```

#### `rawExtract()`

[](#rawextract)

```
public function rawExtract(string $outputDirectory, ?string $prefix = null): array
```

Extrait chaque type d'enregistrement dans un fichier séparé.

**Paramètres :**

- `$outputDirectory` : Répertoire de sortie pour les fichiers extraits
- `$prefix` : Préfixe pour les noms de fichiers (optionnel)

**Retour :** Tableau associatif avec le type d'enregistrement comme clé et le chemin du fichier comme valeur

**Lance :** `\RuntimeException` si le répertoire ne peut pas être créé ou si l'écriture échoue

**Exemple :**

```
$files = $inspector->rawExtract('./extracted', 'mon_vol');
foreach ($files as $type => $filepath) {
    echo "Type $type extrait dans : $filepath\n";
}
```

API - Classe PhpIgcUtils
------------------------

[](#api---classe-phpigcutils)

Classe utilitaire contenant des fonctions statiques pour les opérations courantes sur les fichiers IGC.

### Calcul de distances GPS

[](#calcul-de-distances-gps)

#### `calculateDistance()`

[](#calculatedistance)

```
public static function calculateDistance(
    float $latitude1,
    float $longitude1,
    float $latitude2,
    float $longitude2
): float
```

Calcule la distance entre deux points GPS en utilisant la formule de Haversine.

**Paramètres :**

- `$latitude1`, `$longitude1` : Coordonnées du premier point (degrés décimaux)
- `$latitude2`, `$longitude2` : Coordonnées du deuxième point (degrés décimaux)

**Retour :** Distance en mètres

**Exemple :**

```
$distance = PhpIgcUtils::calculateDistance(51.1883, -1.0285, 51.2000, -1.0400);
echo "Distance : " . round($distance, 2) . " mètres";
```

#### `calculateProximity()`

[](#calculateproximity)

```
public static function calculateProximity(
    float $latitude1,
    float $longitude1,
    float $latitude2,
    float $longitude2
): float
```

Alias pour `calculateDistance()`.

### Conversions de coordonnées

[](#conversions-de-coordonnées)

#### `igcToDecimal()`

[](#igctodecimal)

```
public static function igcToDecimal(int $degrees, int $minutes, int $thousandths): float
```

Convertit des coordonnées IGC (DDMMmmm) en degrés décimaux.

**Paramètres :**

- `$degrees` : Degrés (DD ou DDD)
- `$minutes` : Minutes (MM)
- `$thousandths` : Millièmes de minute (mmm)

**Retour :** Coordonnée en degrés décimaux

**Exemple :**

```
// Latitude : 51° 11.299' = 5111299
$latitude = PhpIgcUtils::igcToDecimal(51, 11, 299);
// Retourne : 51.1883
```

#### `decimalToIgc()`

[](#decimaltoigc)

```
public static function decimalToIgc(float $decimalDegrees, bool $isLongitude = false): array
```

Convertit des degrés décimaux en format IGC (DDMMmmm).

**Paramètres :**

- `$decimalDegrees` : Coordonnée en degrés décimaux
- `$isLongitude` : `true` si c'est une longitude (DDDMMmmm), `false` pour latitude (DDMMmmm)

**Retour :** Tableau avec `degrees`, `minutes`, `thousandths`

**Exemple :**

```
$coords = PhpIgcUtils::decimalToIgc(51.1883, false);
// Retourne : ['degrees' => 51, 'minutes' => 11, 'thousandths' => 299]
```

### Conversions de temps

[](#conversions-de-temps)

#### `secondsToTime()`

[](#secondstotime)

```
public static function secondsToTime(int $seconds): string
```

Convertit des secondes en format hh:mm:ss.

**Paramètres :**

- `$seconds` : Nombre de secondes

**Retour :** Temps formaté (hh:mm:ss)

**Exemple :**

```
$time = PhpIgcUtils::secondsToTime(9332);
// Retourne : "02:35:32"
```

#### `timeToSeconds()`

[](#timetoseconds)

```
public static function timeToSeconds(string $timeString): int
```

Convertit un temps formaté (hh:mm:ss ou HHMMSS) en secondes.

**Paramètres :**

- `$timeString` : Temps au format hh:mm:ss ou HHMMSS

**Retour :** Nombre de secondes

**Exemple :**

```
$seconds = PhpIgcUtils::timeToSeconds("02:35:32");
// Retourne : 9332

$seconds = PhpIgcUtils::timeToSeconds("023532");
// Retourne : 9332
```

### Formatage

[](#formatage)

#### `formatDistance()`

[](#formatdistance)

```
public static function formatDistance(float $distance, int $decimals = 2): string
```

Formate une distance en mètres avec unité (m ou km).

**Paramètres :**

- `$distance` : Distance en mètres
- `$decimals` : Nombre de décimales (défaut: 2)

**Retour :** Distance formatée (ex: "125.43 km" ou "45.67 m")

**Exemple :**

```
$formatted = PhpIgcUtils::formatDistance(125430);
// Retourne : "125.43 km"

$formatted = PhpIgcUtils::formatDistance(456.7);
// Retourne : "456.70 m"
```

#### `formatSpeed()`

[](#formatspeed)

```
public static function formatSpeed(float $speed, int $decimals = 2): string
```

Formate une vitesse en km/h.

**Paramètres :**

- `$speed` : Vitesse en km/h
- `$decimals` : Nombre de décimales (défaut: 2)

**Retour :** Vitesse formatée (ex: "125.43 km/h")

**Exemple :**

```
$formatted = PhpIgcUtils::formatSpeed(125.5);
// Retourne : "125.50 km/h"
```

### Calculs

[](#calculs)

#### `calculateSpeed()`

[](#calculatespeed)

```
public static function calculateSpeed(
    float $latitude1,
    float $longitude1,
    int $timestamp1,
    float $latitude2,
    float $longitude2,
    int $timestamp2
): ?float
```

Calcule la vitesse entre deux points GPS.

**Paramètres :**

- `$latitude1`, `$longitude1` : Coordonnées du premier point
- `$timestamp1` : Timestamp du premier point
- `$latitude2`, `$longitude2` : Coordonnées du deuxième point
- `$timestamp2` : Timestamp du deuxième point

**Retour :** Vitesse en km/h, ou `null` si le temps est invalide

**Exemple :**

```
$speed = PhpIgcUtils::calculateSpeed(
    51.1883, -1.0285, 1659692972,
    51.2000, -1.0400, 1659693000
);
// Retourne la vitesse en km/h
```

#### `validatePointsProximity()`

[](#validatepointsproximity)

```
public static function validatePointsProximity(
    array $points,
    float $distance,
    string $igcContent,
    bool $includeIgcObject = false
): object
```

Valide une liste de points en vérifiant s'ils sont passés à proximité dans un fichier IGC.

**Paramètres :**

- `$points` : Liste de points à valider. Chaque point doit être un objet ou un tableau associatif contenant les clés `latitude` et `longitude` (en degrés décimaux)
- `$distance` : Distance maximale en mètres pour considérer qu'un point est validé
- `$igcContent` : Contenu du fichier IGC à analyser
- `$includeIgcObject` : Si `true`, inclut l'objet IGC parsé dans le résultat (défaut: `false`)

**Retour :** Objet contenant :

- `validatedPoints` : Tableau des points validés avec leurs détails
- `invalidatedPoints` : Tableau des points non validés
- `allValidated` : Booléen indiquant si tous les points sont validés
- `validatedCount` : Nombre de points validés
- `totalPoints` : Nombre total de points
- `distance` : Distance maximale utilisée pour la validation
- `igcObject` : Objet IGC parsé (uniquement si `$includeIgcObject` est `true`)

**Lance :** `\Exception` si le fichier IGC ne peut pas être parsé ou si les points sont invalides

**Exemple :**

```
$points = [
    ['latitude' => 51.1883, 'longitude' => -1.0285],
    ['latitude' => 51.2000, 'longitude' => -1.0400],
];

$igcContent = file_get_contents('vol.igc');
$result = PhpIgcUtils::validatePointsProximity($points, 5000.0, $igcContent);

if ($result->allValidated) {
    echo "Tous les points sont validés !\n";
} else {
    echo "Points validés : " . $result->validatedCount . " / " . $result->totalPoints . "\n";
    foreach ($result->invalidatedPoints as $point) {
        echo "Point non validé : " . $point->reason . "\n";
    }
}

// Avec l'objet IGC inclus
$result = PhpIgcUtils::validatePointsProximity($points, 5000.0, $igcContent, true);
$flight = $result->igcObject; // Objet flight complet
```

Exemples complets
-----------------

[](#exemples-complets)

### Exemple 1 : Lecture et validation d'un fichier IGC

[](#exemple-1--lecture-et-validation-dun-fichier-igc)

```
use Ycdev\PhpIgcInspector\PhpIgcInspector;
use Ycdev\PhpIgcInspector\Exception\InvalidIgcException;

try {
    $inspector = PhpIgcInspector::fromFile('vol.igc');
    $inspector->validate();

    $flight = $inspector->getFlight();

    echo "Pilote : " . $flight->OtherInformation->pilot . "\n";
    echo "Date : " . $flight->OtherInformation->date . "\n";
    echo "Nombre de points GPS : " . count($flight->Fix) . "\n";
    echo "Distance totale : " . $flight->OtherInformation->totalDistanceFormatted . "\n";
    echo "Durée : " . $flight->OtherInformation->flightDurationFormatted . "\n";

} catch (InvalidIgcException $e) {
    echo "Erreur de validation : " . $e->getMessage() . "\n";
}
```

### Exemple 2 : Validation des turnpoints

[](#exemple-2--validation-des-turnpoints)

```
$inspector = PhpIgcInspector::fromFile('vol.igc');
$inspector->validate();

if ($inspector->validTurnPoint(5000.0)) {
    $task = $inspector->getFlight()->Task;
    $validation = $task->turnPointValidation;

    echo "Tous les turnpoints sont validés !\n";
    echo "Points validés : " . $validation->validatedCount . " / " . $validation->totalWaypoints . "\n";

    foreach ($validation->validatedTurnPoints as $turnPoint) {
        echo sprintf(
            "Turnpoint %d (%s) validé à %s (distance: %.2f m)\n",
            $turnPoint->index,
            $turnPoint->type,
            $turnPoint->validatedAt,
            $turnPoint->distance
        );
    }
} else {
    echo "Certains turnpoints n'ont pas été validés.\n";
    foreach ($validation->missedTurnPoints as $missed) {
        echo "Turnpoint manqué : " . $missed->type . " (index " . $missed->index . ")\n";
    }
}
```

### Exemple 3 : Calcul de distance entre deux points

[](#exemple-3--calcul-de-distance-entre-deux-points)

```
use Ycdev\PhpIgcInspector\PhpIgcUtils;

$distance = PhpIgcUtils::calculateDistance(
    51.1883,  // Latitude point 1
    -1.0285,  // Longitude point 1
    51.2000,  // Latitude point 2
    -1.0400   // Longitude point 2
);

echo "Distance : " . PhpIgcUtils::formatDistance($distance) . "\n";
```

### Exemple 4 : Validation de points personnalisés

[](#exemple-4--validation-de-points-personnalisés)

```
use Ycdev\PhpIgcInspector\PhpIgcUtils;

// Liste de points à valider (waypoints personnalisés)
$waypoints = [
    ['latitude' => 51.1883, 'longitude' => -1.0285, 'name' => 'Départ'],
    ['latitude' => 51.2000, 'longitude' => -1.0400, 'name' => 'Turnpoint 1'],
    ['latitude' => 51.2100, 'longitude' => -1.0500, 'name' => 'Arrivée'],
];

$igcContent = file_get_contents('vol.igc');
$result = PhpIgcUtils::validatePointsProximity($waypoints, 5000.0, $igcContent);

echo "Résultats de validation :\n";
echo "Points validés : " . $result->validatedCount . " / " . $result->totalPoints . "\n";
echo "Distance maximale : " . PhpIgcUtils::formatDistance($result->distance) . "\n";

foreach ($result->validatedPoints as $point) {
    echo sprintf(
        "✓ Point validé (distance: %.2f m) à %s\n",
        $point->minDistance,
        $point->validatedAt ?? 'N/A'
    );
}

foreach ($result->invalidatedPoints as $point) {
    echo sprintf(
        "✗ Point non validé : %s (distance min: %s)\n",
        $point->reason,
        $point->minDistance !== null ? PhpIgcUtils::formatDistance($point->minDistance) : 'N/A'
    );
}
```

Développement
-------------

[](#développement)

- **Namespace** : `Ycdev\PhpIgcInspector`
- **License** : GPL-3.0-only
- **Version PHP requise** : >= 7.4

Auteur
------

[](#auteur)

Yann ()

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance77

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

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

Unknown

Total

1

Last Release

126d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/024570f0039cd21fa340520a3f616c617734a1634b92a2b5cd137c3954d4c2ec?d=identicon)[cymdev](/maintainers/cymdev)

---

Top Contributors

[![CymDeveloppement](https://avatars.githubusercontent.com/u/7532413?v=4)](https://github.com/CymDeveloppement "CymDeveloppement (8 commits)")

---

Tags

parserflightgpsaviationigcgliding soaring

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ycdev-php-igc-inspector/health.svg)

```
[![Health](https://phpackages.com/badges/ycdev-php-igc-inspector/health.svg)](https://phpackages.com/packages/ycdev-php-igc-inspector)
```

###  Alternatives

[nikic/php-parser

A PHP parser written in PHP

17.4k902.6M1.8k](/packages/nikic-php-parser)[doctrine/lexer

PHP Doctrine Lexer parser library that can be used in Top-Down, Recursive Descent Parsers.

11.2k910.8M118](/packages/doctrine-lexer)[erusev/parsedown

Parser for Markdown.

15.0k151.8M732](/packages/erusev-parsedown)[league/commonmark

Highly-extensible PHP Markdown parser which fully supports the CommonMark spec and GitHub-Flavored Markdown (GFM)

2.9k404.0M702](/packages/league-commonmark)[masterminds/html5

An HTML5 parser and serializer.

1.8k242.8M229](/packages/masterminds-html5)[sabberworm/php-css-parser

Parser for CSS Files written in PHP

1.8k191.2M65](/packages/sabberworm-php-css-parser)

PHPackages © 2026

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