PHPackages                             sahablibya/laravel-sharepoint-filesystem - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. sahablibya/laravel-sharepoint-filesystem

ActiveLibrary[File & Storage](/categories/file-storage)

sahablibya/laravel-sharepoint-filesystem
========================================

SharePoint/OneDrive filesystem driver for Laravel using Microsoft Graph API with client credentials authentication

v1.0.1(7mo ago)23.5k↓25%4[1 PRs](https://github.com/SahabLibya/laravel-sharepoint-filesystem/pulls)MITPHPPHP ^8.1|^8.2|^8.3|^8.4

Since Oct 11Pushed 7mo agoCompare

[ Source](https://github.com/SahabLibya/laravel-sharepoint-filesystem)[ Packagist](https://packagist.org/packages/sahablibya/laravel-sharepoint-filesystem)[ RSS](/packages/sahablibya-laravel-sharepoint-filesystem/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (8)Versions (3)Used By (0)

Laravel SharePoint/OneDrive Filesystem Driver
=============================================

[](#laravel-sharepointonedrive-filesystem-driver)

[![Latest Version on Packagist](https://camo.githubusercontent.com/4e30f472dfdfc9bba204a49393882418114b063ae48a775165d271caa6fc9d43/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73616861626c696279612f6c61726176656c2d7368617265706f696e742d66696c6573797374656d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sahablibya/laravel-sharepoint-filesystem)[![Total Downloads](https://camo.githubusercontent.com/a27dce486e91a4c01abab357f1b6fc1a765e83394f28ad2153fb875b153b785b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73616861626c696279612f6c61726176656c2d7368617265706f696e742d66696c6573797374656d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sahablibya/laravel-sharepoint-filesystem)[![License](https://camo.githubusercontent.com/1638f12d707567cd16485fbddbca62107662570c896ea7e593f784e6bbc3f44a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f73616861626c696279612f6c61726176656c2d7368617265706f696e742d66696c6573797374656d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sahablibya/laravel-sharepoint-filesystem)

A Laravel filesystem driver for SharePoint and OneDrive using Microsoft Graph API with **client credentials authentication**. No manual OAuth flows required - perfect for server-side applications and automated backups.

✨ Features
----------

[](#-features)

- ✅ **Zero-configuration OAuth** - Automatic token management with client credentials flow
- ✅ **SharePoint Document Libraries** - Direct access to your SharePoint sites
- ✅ **OneDrive for Business** - Full OneDrive integration
- ✅ **Automatic Token Refresh** - Handles token expiry seamlessly with smart caching
- ✅ **Laravel 10, 11, 12** - Compatible with modern Laravel versions
- ✅ **Flysystem v3** - Built on the latest Flysystem architecture
- ✅ **Large File Support** - Optimized for files up to 250MB
- ✅ **Production Ready** - Battle-tested in real-world applications
- ✅ **Spatie Backup Compatible** - Perfect for automated backups to SharePoint

📋 Requirements
--------------

[](#-requirements)

- PHP 8.1 or higher
- Laravel 10.x, 11.x, or 12.x
- Microsoft Azure app registration with appropriate permissions

📦 Installation
--------------

[](#-installation)

Install via Composer:

```
composer require sahablibya/laravel-sharepoint-filesystem
```

The service provider will be automatically registered via Laravel's package discovery.

⚙️ Configuration
----------------

[](#️-configuration)

### Step 1: Azure App Registration

[](#step-1-azure-app-registration)

1. Go to [Azure Portal](https://portal.azure.com/)
2. Navigate to **Azure Active Directory** → **App registrations**
3. Click **New registration**
4. Enter a name (e.g., "Laravel SharePoint Integration")
5. Click **Register**
6. Note your **Application (client) ID** and **Directory (tenant) ID**

### Step 2: Create Client Secret

[](#step-2-create-client-secret)

1. In your app registration, go to **Certificates & secrets**
2. Click **New client secret**
3. Add a description and set expiration
4. Click **Add**
5. **⚠️ Copy the secret value immediately** (you won't see it again!)

### Step 3: Grant API Permissions

[](#step-3-grant-api-permissions)

1. Go to **API permissions**
2. Click **Add a permission** → **Microsoft Graph** → **Application permissions**
3. Add these permissions:
    - `Files.ReadWrite.All` - Read and write files in all site collections
    - `Sites.ReadWrite.All` - Read and write items in all site collections
4. Click **Grant admin consent** (requires admin privileges)
5. Wait 2-5 minutes for permissions to propagate

### Step 4: Get SharePoint Drive ID (Optional)

[](#step-4-get-sharepoint-drive-id-optional)

To use a specific SharePoint document library, you need the drive ID:

#### Option A: Using Microsoft Graph Explorer

[](#option-a-using-microsoft-graph-explorer)

1. Go to [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer)
2. Sign in with your account
3. Find your site: `GET https://graph.microsoft.com/v1.0/sites?search=YourSiteName`
4. Get drives for that site: `GET https://graph.microsoft.com/v1.0/sites/{site-id}/drives`
5. Copy the `id` of your desired document library

#### Option B: Using PowerShell

[](#option-b-using-powershell)

```
Connect-PnPOnline -Url "https://yourtenant.sharepoint.com/sites/yoursite"
Get-PnPList | Where-Object {$_.BaseTemplate -eq 101}
```

### Step 5: Environment Configuration

[](#step-5-environment-configuration)

Add these variables to your `.env` file:

```
GRAPH_CLIENT_ID=your-application-client-id
GRAPH_CLIENT_SECRET=your-client-secret-value
GRAPH_TENANT_ID=your-tenant-id

# Optional: Specify a SharePoint document library
SHAREPOINT_DRIVE_ID=your-drive-id

# Optional: Prefix path within the drive
SHAREPOINT_PREFIX=backups
```

### Step 6: Register Filesystem Disk

[](#step-6-register-filesystem-disk)

Add the SharePoint disk to your `config/filesystems.php`:

```
'disks' => [
    // ... other disks

    'sharepoint' => [
        'driver' => 'sharepoint',
        'client_id' => env('GRAPH_CLIENT_ID'),
        'client_secret' => env('GRAPH_CLIENT_SECRET'),
        'tenant_id' => env('GRAPH_TENANT_ID', 'common'),
        'drive_id' => env('SHAREPOINT_DRIVE_ID'), // Optional
        'prefix' => env('SHAREPOINT_PREFIX', ''), // Optional
        'throw' => false,
    ],
],
```

🚀 Usage
-------

[](#-usage)

### Basic Operations

[](#basic-operations)

```
use Illuminate\Support\Facades\Storage;

// Write a file
Storage::disk('sharepoint')->put('documents/report.pdf', $contents);

// Write from a stream (memory efficient for large files)
$stream = fopen('/path/to/large-file.zip', 'r');
Storage::disk('sharepoint')->writeStream('backups/large-file.zip', $stream);

// Read a file
$contents = Storage::disk('sharepoint')->get('documents/report.pdf');

// Read as stream
$stream = Storage::disk('sharepoint')->readStream('documents/report.pdf');

// Check if file exists
if (Storage::disk('sharepoint')->exists('documents/report.pdf')) {
    // File exists
}

// Delete a file
Storage::disk('sharepoint')->delete('documents/report.pdf');

// Delete multiple files
Storage::disk('sharepoint')->delete(['file1.pdf', 'file2.pdf']);

// Copy a file
Storage::disk('sharepoint')->copy('old.pdf', 'new.pdf');

// Move a file
Storage::disk('sharepoint')->move('old-location.pdf', 'new-location.pdf');
```

### Directory Operations

[](#directory-operations)

```
// Create a directory
Storage::disk('sharepoint')->makeDirectory('documents/2024');

// List files in a directory
$files = Storage::disk('sharepoint')->files('documents');

// List all files recursively
$files = Storage::disk('sharepoint')->allFiles('documents');

// List directories
$directories = Storage::disk('sharepoint')->directories('documents');

// List all directories recursively
$directories = Storage::disk('sharepoint')->allDirectories('documents');

// Delete a directory
Storage::disk('sharepoint')->deleteDirectory('old-documents');
```

### File Metadata

[](#file-metadata)

```
// Get file size
$size = Storage::disk('sharepoint')->size('documents/report.pdf');

// Get last modified time
$timestamp = Storage::disk('sharepoint')->lastModified('documents/report.pdf');

// Get MIME type
$mimeType = Storage::disk('sharepoint')->mimeType('documents/report.pdf');
```

### URLs & Downloads

[](#urls--downloads)

```
// Store an uploaded file
$path = $request->file('document')->store('uploads', 'sharepoint');

// Download a file
return Storage::disk('sharepoint')->download('documents/report.pdf');

// Download with custom name
return Storage::disk('sharepoint')->download('documents/report.pdf', 'custom-name.pdf');
```

🔄 Using with Spatie Laravel Backup
----------------------------------

[](#-using-with-spatie-laravel-backup)

Perfect integration with [Spatie Laravel Backup](https://github.com/spatie/laravel-backup):

```
// config/backup.php

'destination' => [
    'disks' => [
        'local',
        'sharepoint',  // Add SharePoint as backup destination
    ],
],
```

Run backups:

```
# Full backup (database + files)
php artisan backup:run

# Database only
php artisan backup:run --only-db

# List backups
php artisan backup:list

# Clean old backups
php artisan backup:clean
```

🔧 Advanced Configuration
------------------------

[](#-advanced-configuration)

### Multiple SharePoint Sites

[](#multiple-sharepoint-sites)

```
'disks' => [
    'sharepoint-hr' => [
        'driver' => 'sharepoint',
        'client_id' => env('GRAPH_CLIENT_ID'),
        'client_secret' => env('GRAPH_CLIENT_SECRET'),
        'tenant_id' => env('GRAPH_TENANT_ID'),
        'drive_id' => 'hr-drive-id',
        'prefix' => 'employee-files',
    ],

    'sharepoint-finance' => [
        'driver' => 'sharepoint',
        'client_id' => env('GRAPH_CLIENT_ID'),
        'client_secret' => env('GRAPH_CLIENT_SECRET'),
        'tenant_id' => env('GRAPH_TENANT_ID'),
        'drive_id' => 'finance-drive-id',
        'prefix' => 'reports',
    ],
],
```

### Using OneDrive

[](#using-onedrive)

The package also supports OneDrive for Business. Use the `onedrive` driver:

```
'onedrive' => [
    'driver' => 'onedrive',
    'client_id' => env('GRAPH_CLIENT_ID'),
    'client_secret' => env('GRAPH_CLIENT_SECRET'),
    'tenant_id' => env('GRAPH_TENANT_ID'),
    'prefix' => env('ONEDRIVE_PREFIX', ''),
],
```

### Token Caching

[](#token-caching)

Access tokens are automatically cached for 58 minutes (tokens typically expire in 60 minutes). The cache key is unique per disk configuration, allowing multiple SharePoint/OneDrive connections with independent token management.

🐛 Troubleshooting
-----------------

[](#-troubleshooting)

### Permission Errors

[](#permission-errors)

**Error:** "Access denied" or "403 Forbidden"

**Solutions:**

1. Verify `Files.ReadWrite.All` and `Sites.ReadWrite.All` permissions are added
2. Ensure **admin consent is granted** (look for green checkmarks in Azure Portal)
3. Wait 2-5 minutes after granting consent for changes to propagate
4. Clear Laravel cache: `php artisan cache:clear`

### Authentication Errors

[](#authentication-errors)

**Error:** "Failed to obtain access token" or "invalid\_client"

**Solutions:**

1. Verify `GRAPH_CLIENT_ID` matches your app registration's Application ID
2. Verify `GRAPH_CLIENT_SECRET` is correct (they expire!)
3. Check `GRAPH_TENANT_ID` matches your Directory (tenant) ID
4. Ensure no extra spaces in your `.env` file

### Drive Not Found

[](#drive-not-found)

**Error:** "itemNotFound" or "Resource not found"

**Solutions:**

1. Verify `SHAREPOINT_DRIVE_ID` is correct
2. Try removing `drive_id` to use the default OneDrive
3. Ensure the app has access to the specified drive
4. Check the drive exists and hasn't been deleted

### Timeout Issues

[](#timeout-issues)

**Error:** Timeouts when uploading large files

**Solutions:**

- The package automatically sets a 5-minute timeout for file operations
- For files > 250MB, consider using Microsoft's resumable upload API
- Check your PHP `max_execution_time` and `memory_limit` settings

### Clear Token Cache

[](#clear-token-cache)

If you're experiencing authentication issues:

```
php artisan cache:clear
```

Or clear specific SharePoint tokens:

```
php artisan cache:forget sharepoint_access_token_*
```

🧪 Testing Connection
--------------------

[](#-testing-connection)

Test your SharePoint connection:

```
use Illuminate\Support\Facades\Storage;

Route::get('/test-sharepoint', function () {
    try {
        // Create a test file
        $testContent = 'Test file created at ' . now();
        Storage::disk('sharepoint')->put('test.txt', $testContent);

        // Verify it exists
        if (!Storage::disk('sharepoint')->exists('test.txt')) {
            return 'File creation failed!';
        }

        // Read it back
        $content = Storage::disk('sharepoint')->get('test.txt');

        // Clean up
        Storage::disk('sharepoint')->delete('test.txt');

        return 'SharePoint connection successful! Content: ' . $content;

    } catch (\Exception $e) {
        return 'Connection failed: ' . $e->getMessage();
    }
});
```

🔐 Security Best Practices
-------------------------

[](#-security-best-practices)

1. **Never commit credentials** - Keep `.env` in `.gitignore`
2. **Use environment-specific apps** - Separate Azure apps for dev/staging/production
3. **Rotate secrets regularly** - Set expiration dates on client secrets in Azure
4. **Monitor access logs** - Review app activity in Azure Portal regularly
5. **Principle of least privilege** - Only grant necessary permissions
6. **Secure your `.env`** - Restrict file permissions: `chmod 600 .env`

📚 API Reference
---------------

[](#-api-reference)

### Supported Flysystem Operations

[](#supported-flysystem-operations)

MethodSupportedNotes`write()`✅Write file contents`writeStream()`✅Write from stream (memory efficient)`read()`✅Read file contents`readStream()`✅Read as stream`delete()`✅Delete file`deleteDirectory()`✅Delete directory and contents`createDirectory()`✅Create directory`fileExists()`✅Check if file exists`directoryExists()`✅Check if directory exists`listContents()`✅List directory contents`move()`✅Move/rename file`copy()`✅Copy file`lastModified()`✅Get last modified timestamp`fileSize()`✅Get file size`mimeType()`✅Get MIME type`visibility()`❌Not supported by SharePoint/OneDrive`setVisibility()`❌Not supported by SharePoint/OneDrive🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

### Development Setup

[](#development-setup)

```
# Clone the repository
git clone https://github.com/sahablibya/laravel-sharepoint-filesystem.git
cd laravel-sharepoint-filesystem

# Install dependencies
composer install

# Run tests
composer test
```

📝 Changelog
-----------

[](#-changelog)

Please see [CHANGELOG.md](CHANGELOG.md) for recent changes.

📄 License
---------

[](#-license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

💡 Credits
---------

[](#-credits)

- Developed by [SahabLibya Development Team](https://github.com/sahablibya)
- Built on [Flysystem](https://flysystem.thephpleague.com/) by Frank de Jonge
- Powered by [Microsoft Graph API](https://docs.microsoft.com/en-us/graph/)

🙏 Acknowledgments
-----------------

[](#-acknowledgments)

Special thanks to:

- The Laravel community for inspiration and best practices
- Microsoft for the comprehensive Graph API
- All contributors who help improve this package

📞 Support
---------

[](#-support)

- **Issues**: [GitHub Issues](https://github.com/sahablibya/laravel-sharepoint-filesystem/issues)
- **Discussions**: [GitHub Discussions](https://github.com/sahablibya/laravel-sharepoint-filesystem/discussions)
- **Email**:

---

**Made with ❤️ by SahabLibya Development Team**

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance64

Regular maintenance activity

Popularity29

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

219d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e6829c9daca0b81de1100d4fe7179da3c066e951a1b681ec0cf9ac5ade3a0cca?d=identicon)[SahabLibya](/maintainers/SahabLibya)

---

Top Contributors

[![MAbughrara](https://avatars.githubusercontent.com/u/25200422?v=4)](https://github.com/MAbughrara "MAbughrara (1 commits)")

---

Tags

filesystemFlysystemlaravelstorageOneDrivesharepointMicrosoft graphlaravel-filesystemmicrosoft-365

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/sahablibya-laravel-sharepoint-filesystem/health.svg)

```
[![Health](https://phpackages.com/badges/sahablibya-laravel-sharepoint-filesystem/health.svg)](https://phpackages.com/packages/sahablibya-laravel-sharepoint-filesystem)
```

###  Alternatives

[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.3M74](/packages/unisharp-laravel-filemanager)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[zing/laravel-flysystem-obs

Flysystem Adapter for OBS

1211.2k](/packages/zing-laravel-flysystem-obs)[sausin/laravel-ovh

OVH Object Storage driver for laravel

40153.5k](/packages/sausin-laravel-ovh)[nimbusoft/flysystem-openstack-swift

Flysystem adapter for OpenStack Swift

44774.4k6](/packages/nimbusoft-flysystem-openstack-swift)[yoelpc4/laravel-cloudinary

Laravel Cloudinary filesystem cloud driver.

3343.0k](/packages/yoelpc4-laravel-cloudinary)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)