thotam/flysystem-onedrive

A flysystem driver for OneDrive that uses the Microsoft Graph API

dev-master 2023-07-03 03:34 UTC

Requires

• php: ^8.0|^8.1
• illuminate/support: ^9.0|^10.0
• league/flysystem: ^3.8
• microsoft/microsoft-graph: ^1.101

Requires (Dev)

• orchestra/testbench: ^6.0|^7.0|^8.0
• phpunit/phpunit: ^9.3|^10.0

MIT

• Justus Donner

• api
• Flysystem
• OneDrive
• flysystem-onedrive

README

Flysystem adapter for Microsoft OneDrive

This package contains a Flysystem OneDrive adapter, which makes use of the Microsoft Graph API. The adapter is ready for the latest Laravel 9.x version.

You can use this package to access files stored in onedrive or sharepoint folders from your PHP or Laravel web applications.

1. Installation

Simply install the package using composer:

composer require justus/flysystem-onedrive

2. Usage

Laravel Usage

1. Add the following variables to your .env file

example for 'personal' OneDrive

ONEDRIVE_ROOT=me
ONEDRIVE_ACCESS_TOKEN=fd6s7a98...
ONEDRIVE_DIR_TYPE=drives

example for 'group shared' OneDrive

ONEDRIVE_ROOT="{group_id}/drive"
ONEDRIVE_ACCESS_TOKEN=fd6s7a98...
ONEDRIVE_DIR_TYPE=groups

1. In the file config/filesystems.php, please add the following code snippet to the disks section

'onedrive' => [
    'driver' => 'onedrive',
    'root' => env('ONEDRIVE_ROOT'),
    'access_token' => env('ONEDRIVE_ACCESS_TOKEN'), //optional if demanded
    'directory_type' => env('ONEDRIVE_DIR_TYPE')
],

1. Add the OneDriveAdapterServiceProvider in config/app.php

'providers' => [
    // ...
    Justus\FlysystemOneDrive\Providers\OneDriveAdapterServiceProvider::class,
    // ...
],

There are two established approaches of using the package

• On demand: Recommended if you use a dynamic graph access token. (usage e. g. session('graph_access_token'))

$disk = Storage::build([
    'driver' => config('filesystems.disks.onedrive.driver'),
    'root' => config('filesystems.disks.onedrive.root'),
    'directory_type' => config('filesystems.disks.onedrive.directory_type'),
    'access_token' => session('graph_access_token')
]);

$disk->makeDirectory('test');

• Default with Storage Facade: Recommended if you use a static graph access token.

Storage::disk('onedrive')->makeDirectory('test');

PHP Usage

Usage in php without Laravel framework

$options = [

];

$graph = new Graph();
$graph->setAccessToken('fd6s7a98...');

$adapter = new OneDriveAdapter($graph, 'root/path', $options);

$filesystem = new Filesystem($adapter);

$filesystem->createDirectory('test');

3. Changelog

Please see CHANGELOG for more information on recent changes.

4. Testing

$ composer test

5. Security

If you discover any security related issues, please write an email to [e-mail] instead of using the issue tracker.

6. License

The MIT License (MIT). Please see License File for more information.