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(4mo ago)13102.6k↓40.5%8[2 PRs](https://github.com/jerodev/flysystem-v3-smb-adapter/pulls)1MITPHPPHP >=8.0.2CI passing

Since Feb 15Pushed 4mo 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 2w 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

51

—

FairBetter than 95% of packages

Maintenance74

Regular maintenance activity

Popularity41

Moderate usage in the ecosystem

Community15

Small or concentrated contributor base

Maturity59

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

148d 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.7k293.8M1.2k](/packages/league-flysystem-aws-s3-v3)[robgridley/flysystem-smb

Flysystem adapter for Icewind SMB.

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

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

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

PHPackages © 2026

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