FIT

A PHP (>= PHP 8) decoder for FIT files created by Garmin devices.

Install via Composer

You can install sportlog/FIT using Composer.

$ composer require sportlog/fit

Minimum PHP version required is 8.

How to use

<?php

require 'vendor/autoload.php';

use Sportlog\FIT\Decoder;
use Sportlog\FIT\Profile\Message\RecordMessage;

$decoder = new Decoder();
// Decoding the FIT file returns a set of messages
$messageList = $decoder->read('yourfile.fit');

echo "File type: " . $messageList->getFileType();

// You can either traverse all messages, in this case grouped by type.
// You also simply iterate over the $messageList
foreach ($messageList->getMessageTypes() as $messageTyp) {
   $messages = $messageList->getMessages($messageTyp);
   echo sprintf('%s: %s', $messageType, count($messages));
}

// You can also grab specific messages and access any data you need
$recordMessages = $messageList->getMessages(RecordMessage::class);
if (count($recordMessages) > 0) {
   /** @var RecordMessage $lastRecordMessage */
   $lastRecordMessage = $recMessages[count($recMessages)-1];
   // get the distance using the properties on the message,
   // for example the distance
   echo "Total distance (m): " . $lastRecordMessage->getDistance();
}