PHPackages                             jerodev/flysystem-v3-smb-adapter - 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. jerodev/flysystem-v3-smb-adapter

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

jerodev/flysystem-v3-smb-adapter
================================

SMB adapter for Flysystem v3

1.2.1(3mo ago)1299.0k↓45.5%8[2 PRs](https://github.com/jerodev/flysystem-v3-smb-adapter/pulls)1MITPHPPHP >=8.0.2CI passing

Since Feb 15Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/jerodev/flysystem-v3-smb-adapter)[ Packagist](https://packagist.org/packages/jerodev/flysystem-v3-smb-adapter)[ RSS](/packages/jerodev-flysystem-v3-smb-adapter/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (4)Dependencies (18)Versions (6)Used By (1)

SMB adapter for Flysystem v3
============================

[](#smb-adapter-for-flysystem-v3)

[![run-tests](https://github.com/jerodev/flysystem-v3-smb-adapter/actions/workflows/run-tests.yml/badge.svg)](https://github.com/jerodev/flysystem-v3-smb-adapter/actions/workflows/run-tests.yml) [![Latest Stable Version](https://camo.githubusercontent.com/18b631e9f9cfdb9880bec0250d2e1b4129f8d8c444019d682192c5c3365a0967/687474703a2f2f706f7365722e707567782e6f72672f6a65726f6465762f666c7973797374656d2d76332d736d622d616461707465722f76)](https://packagist.org/packages/jerodev/flysystem-v3-smb-adapter)

This package enables you to communicate with SMB shares through [Flysystem v3](https://github.com/thephpleague/flysystem).

Installation
------------

[](#installation)

```
composer require jerodev/flysystem-v3-smb-adapter

```

Usage
-----

[](#usage)

The adapter uses the [Icewind SMB](https://github.com/icewind1991/SMB) package to communicate with the share.
To use the flysystem adapter, you have to pass it an instance of [`\Icewind\SMB\IShare`](https://github.com/icewind1991/SMB/blob/master/src/IShare.php). Below is an example of how to create a share instance using the factory provided by Icewind SMB.

```
$server = (new \Icewind\SMB\ServerFactory())->createServer(
    $config->host,
    new \Icewind\SMB\BasicAuth(
        $config->user,
        'test',
        $config->password
    )
);
$share = $server->getShare($config->share);

return new \Jerodev\Flysystem\Smb\SmbAdapter($share, '');
```

Laravel Filesystem
------------------

[](#laravel-filesystem)

The package also ships with a Laravel service provider that automatically registers a driver for you. Laravel will discover this provider for you when installing this package. All you have to do is configure the share in your `config/filesystems.php` similar to the example below.

```
'disks' => [
    'smb_share' => [
        'driver' => 'smb',
        'workgroup' => 'WORKGROUP',
        'host' => \env('SMB_HOST', '127.0.0.1'),
        'path' => \env('SMB_PATH', 'test'),
        'username' => \env('SMB_USERNAME', ''),
        'password' => \env('SMB_PASSWORD', ''),

        // Optional Icewind SMB options
        'smb_version_min' => \Icewind\SMB\IOptions::PROTOCOL_SMB2,
        'smb_version_max' => \Icewind\SMB\IOptions::PROTOCOL_SMB2_24,
        'timeout' => 20,
    ],
],
```

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance81

Actively maintained with recent releases

Popularity41

Moderate usage in the ecosystem

Community15

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96.6% 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 ~499 days

Total

4

Last Release

103d ago

PHP version history (2 changes)1.0.0PHP ^8.0

1.1.0PHP >=8.0.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3493941?v=4)[Jeroen Deviaene](/maintainers/jerodev)[@jerodev](https://github.com/jerodev)

---

Top Contributors

[![jerodev](https://avatars.githubusercontent.com/u/3493941?v=4)](https://github.com/jerodev "jerodev (28 commits)")[![khorsky](https://avatars.githubusercontent.com/u/160295?v=4)](https://github.com/khorsky "khorsky (1 commits)")

---

Tags

flysystemlaravelsmbfilesystemFlysystemlaravelsambasmb

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/jerodev-flysystem-v3-smb-adapter/health.svg)

```
[![Health](https://phpackages.com/badges/jerodev-flysystem-v3-smb-adapter/health.svg)](https://phpackages.com/packages/jerodev-flysystem-v3-smb-adapter)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.7k285.7M1.0k](/packages/league-flysystem-aws-s3-v3)[barryvdh/elfinder-flysystem-driver

A Flysystem Driver for elFinder

1865.1M41](/packages/barryvdh-elfinder-flysystem-driver)[masbug/flysystem-google-drive-ext

Flysystem adapter for Google Drive with seamless virtual<=>display path translation

2682.2M18](/packages/masbug-flysystem-google-drive-ext)[league/flysystem-sftp-v3

SFTP filesystem adapter for Flysystem.

6134.8M157](/packages/league-flysystem-sftp-v3)[robgridley/flysystem-smb

Flysystem adapter for Icewind SMB.

14311.0k](/packages/robgridley-flysystem-smb)[bringyourownideas/laravel-backblaze

Backblaze B2 Cloud Storage for Laravel 5. Original by Paul Olthof (@hpolthof) continued by @bringyourownideas

1238.5k](/packages/bringyourownideas-laravel-backblaze)

PHPackages © 2026

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