Skip to content

StanSoftBG/oauth2-firefly-iii

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Firefly-III Provider for OAuth 2.0 Client

Build Status

Provides Firefly-III OAuth 2.0 support as an implementation of PHP League's OAuth 2.0 Client

Covered APIs

  • About
  • Accounts
  • Attachments
  • Auto-complete
  • Available Budgets
  • Bills
  • Budgets
  • Charts
  • Categories
  • Configuration
  • Currencies
  • Import
  • Links
  • Piggy Banks
  • Preferences
  • Recurrences
  • Rules
  • Rule Groups
  • Search
  • Summary
  • Tags
  • Transactions
  • Users
  • Data

Installation

To install, use composer:

composer require stansoft/oauth2-firefly-iii

Usage

Usage is the same as The League's OAuth client, using \StanSoft\OAuth2\Client\Provider\FireflyIII as the provider.

Authorization Code Flow

<?php

require_once('./vendor/autoload.php');

use StanSoft\OAuth2\Client\Provider\FireflyIII;

session_start();

try {
	$provider = new FireflyIII([
		'fireflyUri' => 'https://REPLACE.WITH.YOUR.FIREFLY.INSTANCE.URL',
		'clientId' => 'REPLACE_WITH_CLIENT_ID',
		'clientSecret' => 'REPLACE_WITH_CLIENT_SECRET',
		'redirectUri' => 'http://REPLACE.WITH.YOUR.WEB.APP.URL'
	]);
} catch (Exception $e) {
	echo $e->getMessage();
	exit;
}


if (!isset($_GET['code'])) {
    // If we don't have an authorization code then get one
    $authUrl = $provider->getAuthorizationUrl();
    $_SESSION['oauth2state'] = $provider->getState();
    header('Location: ' . $authUrl);
    exit;
}

if (isset($_GET['code']) && !isset($_SESSION['token'])) {
    try {
        // Try to get an access token (using the authorization code grant)
        $token = $provider->getAccessToken('authorization_code', [
            'code' => $_GET['code']
        ]);
        $_SESSION['token'] = $token;

    } catch (Exception $e) {
        print($e->getMessage());
        exit;
    }
}
if (isset($_SESSION['token'])) {
	try {
		$user = $provider->getCurrentUser($_SESSION['token']);
		printf('Hello %d!', $user->getId());
	} catch (UnexpectedValueException $e) {
		echo $e->getMessage();
		exit;
	}
    return;
}

Testing

$ ./vendor/bin/phpunit

Credits