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

Since Feb 15Pushed 1mo 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 1mo 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

54

—

FairBetter than 97% of packages

Maintenance89

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

55d ago

PHP version history (2 changes)1.0.0PHP ^8.0

1.1.0PHP >=8.0.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/de99d8fde875ca88a6b812d7b4ab34f0e4a198cd1a7443ca09df33f943c02379?d=identicon)[jerodev](/maintainers/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.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[league/flysystem-sftp-v3

SFTP filesystem adapter for Flysystem.

6129.6M91](/packages/league-flysystem-sftp-v3)[robgridley/flysystem-smb

Flysystem adapter for Icewind SMB.

14297.0k](/packages/robgridley-flysystem-smb)[gliterd/laravel-backblaze-b2

Backblaze B2 Cloud Storage for Laravel 5

5341.6k](/packages/gliterd-laravel-backblaze-b2)[bringyourownideas/laravel-backblaze

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

1237.8k](/packages/bringyourownideas-laravel-backblaze)[hpolthof/laravel-backblaze

Backblaze B2 Cloud Storage for Laravel 5

1220.3k](/packages/hpolthof-laravel-backblaze)

PHPackages © 2026

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