PHPackages                             royvoetman/flysystem-gitlab-storage - 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 &amp; Storage](/categories/file-storage)
4. /
5. royvoetman/flysystem-gitlab-storage

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

royvoetman/flysystem-gitlab-storage
===================================

Flysystem Adapter for the Gitlab Repository files API v4

v3.1.1(1y ago)1123.3k↓31.1%94MITPHPPHP ^8.1

Since Aug 2Pushed 1y ago1 watchersCompare

[ Source](https://github.com/RoyVoetman/Flysystem-Gitlab-storage)[ Packagist](https://packagist.org/packages/royvoetman/flysystem-gitlab-storage)[ RSS](/packages/royvoetman-flysystem-gitlab-storage/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (19)Used By (4)

[![](https://camo.githubusercontent.com/d9df671baee09822b0925dfdfde6e143c06e787afaa3863aef3e4251bb57037b/68747470733a2f2f7777772e63732d6c6962726172792e636f6d2f696d616765732f7061636b616765732f6769746c61622e737667)](https://camo.githubusercontent.com/d9df671baee09822b0925dfdfde6e143c06e787afaa3863aef3e4251bb57037b/68747470733a2f2f7777772e63732d6c6962726172792e636f6d2f696d616765732f7061636b616765732f6769746c61622e737667)

A Gitlab Storage filesystem for [Flysystem](https://flysystem.thephpleague.com/docs/).

[![Latest Version](https://camo.githubusercontent.com/dd6ceb530dee29c88e2f59a0d3de1f124ce11b989fc905425c6ba2ff60cd64b0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726f79766f65746d616e2f666c7973797374656d2d6769746c61622d73746f726167652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/royvoetman/flysystem-gitlab-storage)[![MIT Licensed](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Total Downloads](https://camo.githubusercontent.com/99710692e1e45cca79199c52d348bb679edae7e68259df636c054f6725d4789b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726f79766f65746d616e2f666c7973797374656d2d6769746c61622d73746f726167652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/royvoetman/flysystem-gitlab-storage)

This package contains a Flysystem adapter for Gitlab. Under the hood, Gitlab's [Repository (files) API](https://docs.gitlab.com/ee/api/repository_files.html) v4 is used.

> For Flysystem 2 (PHP 7.4) [use version 2.0.4](https://github.com/RoyVoetman/flysystem-gitlab-storage/tree/v2.0.4)

> For Flysystem 1 (PHP 7.1) [use version 1.1.0](https://github.com/RoyVoetman/flysystem-gitlab-storage/tree/v1.1.0)

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

[](#installation)

```
composer require royvoetman/flysystem-gitlab-storage
```

Integrations
------------

[](#integrations)

- Laravel -

Usage
-----

[](#usage)

```
// Create a Gitlab Client to talk with the API
$client = new Client('project-id', 'branch', 'base-url', 'personal-access-token');

// Create the Adapter that implements Flysystems AdapterInterface
$adapter = new GitlabAdapter(
    // Gitlab API Client
    $client,
    // Optional path prefix
    'path/prefix',
);

// The FilesystemOperator
$filesystem = new League\Flysystem\Filesystem($adapter);

// see http://flysystem.thephpleague.com/api/ for full list of available functionality
```

### Project ID

[](#project-id)

Every project in Gitlab has its own Project ID. It can be found at to top of the frontpage of your repository. [See](https://stackoverflow.com/questions/39559689/where-do-i-find-the-project-id-for-the-gitlab-api#answer-53126068)

### Base URL

[](#base-url)

This will be the URL where you host your gitlab server (e.g. )

### Access token (required for private projects)

[](#access-token-required-for-private-projects)

Gitlab supports server side API authentication with Personal Access tokens

For more information on how to create your own Personal Access token: [Gitlab Docs](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Contributions are **welcome** and will be fully **credited**. We accept contributions via Pull Requests on [Github](https://github.com/RoyVoetman/flysystem-gitlab-storage).

### Pull Requests

[](#pull-requests)

- **[PSR-2 Coding Standard](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)** - The easiest way to apply the conventions is to install [PHP Code Sniffer](http://pear.php.net/package/PHP_CodeSniffer).
- **Document any change in behaviour** - Make sure the `README.md` and any other relevant documentation are kept up-to-date.
- **Create feature branches** - Don't ask us to pull from your master branch.
- **One pull request per feature** - If you want to do more than one thing, send multiple pull requests.

License
-------

[](#license)

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

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance49

Moderate activity, may be stable

Popularity36

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor1

Top contributor holds 89% 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 ~124 days

Recently: every ~402 days

Total

18

Last Release

372d ago

Major Versions

v0.0.1 → v1.0.02019-08-03

v1.1.0 → v2.0.02020-11-30

v2.0.4 → v3.0.02022-01-27

PHP version history (6 changes)v0.0.1PHP ^7.0

v1.1.0PHP ^7.1

v2.0.0PHP ^7.4

v2.0.1PHP ^7.4 || ^8.0

v3.0.0PHP ^8.0

v3.1.0PHP ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/23026444?v=4)[Roy Voetman](/maintainers/RoyVoetman)[@RoyVoetman](https://github.com/RoyVoetman)

---

Top Contributors

[![RoyVoetman](https://avatars.githubusercontent.com/u/23026444?v=4)](https://github.com/RoyVoetman "RoyVoetman (65 commits)")[![ElGigi](https://avatars.githubusercontent.com/u/18268216?v=4)](https://github.com/ElGigi "ElGigi (7 commits)")[![Chris8934](https://avatars.githubusercontent.com/u/44963939?v=4)](https://github.com/Chris8934 "Chris8934 (1 commits)")

---

Tags

apiFlysystemgitlabv4laravel-storageroyvoetmanflysystem-gitlab

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/royvoetman-flysystem-gitlab-storage/health.svg)

```
[![Health](https://phpackages.com/badges/royvoetman-flysystem-gitlab-storage/health.svg)](https://phpackages.com/packages/royvoetman-flysystem-gitlab-storage)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[spatie/flysystem-dropbox

Flysystem Adapter for the Dropbox v2 API

3644.6M68](/packages/spatie-flysystem-dropbox)[mhetreramesh/flysystem-backblaze

Backblaze adapter for the flysystem filesystem abstraction library

62146.8k9](/packages/mhetreramesh-flysystem-backblaze)[justus/flysystem-onedrive

A flysystem driver for OneDrive that uses the Microsoft Graph API

48104.4k](/packages/justus-flysystem-onedrive)[jacekbarecki/flysystem-onedrive

OneDrive adapter for the flysystem filesystem abstraction library

2429.9k](/packages/jacekbarecki-flysystem-onedrive)[taffovelikoff/imagekit-adapter

Flysystem adapter for ImageKit.

1421.0k](/packages/taffovelikoff-imagekit-adapter)

PHPackages © 2026

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