myges's Introduction

MyGes API Client Library for PHP

This library allows students to obtain information about their schooling (agenda, grades, absences, teachers, classes, students) if their school is part of the GES organization.

NOTE This library is unofficial, if you find a bug please feel free to contribute with a PR.

Requirements

PHP 7.2 or higher

Installation

Composer

Execute the following command to install this library:

composer require tchenu/myges

Include the autoloader

require_once  'vendor/autoload.php';

How to connect

You can connect your account with the client-id of the Skolae application.

<?php

require_once  'vendor/autoload.php';

try {
    // client-id = skolae-app
    $client = new MyGes\Client('skolae-app', 'your-login', 'your-password');
} catch(MyGes\Exceptions\BadCredentialsException $e) {
    die($e->getMessage()); // bad credentials
}

Examples

Run the following command to start a web server with PHP.


$ composer run-script examples

And then browsing to http://localhost:1337/profile.php (or any example available in the examples folder).

Example

<?php

require_once  'vendor/autoload.php';

try {
    $client = new MyGes\Client('<client-id>', '<login>', '<password>');
} catch(MyGes\Exceptions\BadCredentialsException $e) {
    die($e->getMessage()); // bad credentials
}

$me = new MyGes\Me($client);

$profile = $me->getProfile();

echo  "<img src='". $profile->_links->photo->href ."'></br>";
echo  "Nom : ". $profile->name ."</br>";
echo  "Prenom : ". $profile->firstname ."</br>";