mrkriskrisu/db-wagenreihung-php

PHP library for DB Wagenreihung API

v0.5 2023-03-01 12:02 UTC

Requires

• php: ^8.1
• ext-json: *
• guzzlehttp/guzzle: ^7.3
• illuminate/support: ^9.0|^10.0
• nesbot/carbon: ^2.0

Requires (Dev)

• phpunit/phpunit: ^10.0

MIT

README

This repository provides a PHP package for fetching the current composition of a German train (Wagenreihung). The package uses the API provided by Deutsche Bahn.

⚠️ This library is just being developed and structured. With each version the structure will change. So use this library with care and specify an exact version in your composer.json (don't use ^0.x!) until it reaches version 1.

Installation

You can install the package via Composer:

composer require mrkriskrisu/db-wagenreihung-php

Usage

<?php declare(strict_types=1);

use Carbon\Carbon;
use K118\DB\Exceptions\TrainNotFoundException;
use K118\DB\Wagenreihung;

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

try {
    // Change this to a currently running train before executing
    $trainNumber = 73;
    $departure   = Carbon::create(2023, 3, 1, 13, 11);

    $vehicleGroups = Wagenreihung::fetch($trainNumber, $departure);

    foreach($vehicleGroups as $vehicleGroup) {
        foreach($vehicleGroup->vehicles as $vehicle) {
            echo $vehicleGroup->fahrzeuggruppebezeichnung . ': ';
            echo $vehicle->fahrzeugnummer . ' (Typ: ' . $vehicle->fahrzeugtyp . ') will be in section ' . $vehicle->fahrzeugsektor . PHP_EOL;
        }
    }
} catch(TrainNotFoundException $e) {
    echo 'Train not found' . PHP_EOL;
}