PHPackages aimeos/ai-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. aimeos/ai-filesystem ActiveAimeos-extension[File & Storage](/categories/file-storage) aimeos/ai-filesystem ==================== Aimeos file system layer extension 2025.10.1(7mo ago)1029.9k↓27.8%21LGPL-3.0-or-laterPHPPHP ^8.0.11 Since Feb 18Pushed 4mo ago5 watchersCompare [ Source](https://github.com/aimeos/ai-filesystem)[ Packagist](https://packagist.org/packages/aimeos/ai-filesystem)[ Docs](https://aimeos.org/)[ RSS](/packages/aimeos-ai-filesystem/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (3)Versions (88)Used By (1) [ ![Aimeos logo](https://camo.githubusercontent.com/e55b7a8426f14ba6040d604746b03b7e096af41ede8fead0ea817cbb8d60f998/68747470733a2f2f61696d656f732e6f72672f66696c6561646d696e2f74656d706c6174652f69636f6e732f6c6f676f2e706e67 "Aimeos")](https://aimeos.org/)Aimeos file system extension ============================ [](#aimeos-file-system-extension) [![Build Status](https://camo.githubusercontent.com/1a952a336329bfb9a0b698f36c30174caaf6cecbcd11f22f1595379d47bd9492/68747470733a2f2f636972636c6563692e636f6d2f67682f61696d656f732f61692d66696c6573797374656d2e7376673f7374796c653d736869656c64)](https://circleci.com/gh/aimeos/ai-filesystem)[![Coverage Status](https://camo.githubusercontent.com/e1f0b285841a0f5e8241b667c6b467d20ce8524b884758bc712726dc36e00298/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f61696d656f732f61692d66696c6573797374656d2f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/r/aimeos/ai-filesystem?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/4cf285aef03745bc966dd62eb44f68fd18ece54adab3d3c9c1deceabeff43908/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f61696d656f732f61692d66696c6573797374656d2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/aimeos/ai-filesystem/?branch=master)[![License](https://camo.githubusercontent.com/fb5bad6a9512d54046240e0650ea3c1c57231a8b615e14355c421c5de3a7ae8e/68747470733a2f2f706f7365722e707567782e6f72672f61696d656f732f61692d66696c6573797374656d2f6c6963656e73652e737667)](https://packagist.org/packages/aimeos/ai-filesystem) The Aimeos file system extension contains adapter for storing files in the cloud, on remote servers or other storage facilities. Table of contents ----------------- [](#table-of-contents) - [Installation](#installation) - [Configuration](#configuration) - [License](#license) - [Links](#links) Installation ------------ [](#installation) As every Aimeos extension, the easiest way is to install it via [composer](https://getcomposer.org/). If you don't have composer installed yet, you can execute this string on the command line to download it: ``` php -r "readfile('https://getcomposer.org/installer');" | php -- --filename=composer ``` Then, install the extension using composer: ``` composer req aimeos/ai-filesystem ``` Configuration ------------- [](#configuration) All file system adapter are configured below the `resource/fs` configuration key, e.g. in the resource section of your config file: ``` 'resource' => [ 'fs' => [ // file system adapter specific configuration ], ], ``` ### Amazon S3 [](#amazon-s3) Required adapter: ``` composer req league/flysystem-aws-s3-v3 ``` Configuration: ``` 'fs' => [ 'adapter' => 'FlyAwsS3', 'credentials' => [ 'key' => 'your-key', 'secret' => 'your-secret', ], 'region' => 'your-region', 'version' => 'latest|api-version', 'bucket' => 'your-bucket-name', 'prefix' => 'your-prefix', // optional 'baseurl' => 'https://your-s3-endpoint' // 'https://bucket-name.s3.us-east-2.amazonaws.com' ], ``` ### Azure [](#azure) Required adapter (PHP 8.x only): ``` composer req azure-oss/storage-blob-flysystem ``` Configuration: ``` 'fs' => [ 'adapter' => 'FlyAzure', 'endpoint' => 'DefaultEndpointsProtocol=https;AccountName=your-account;AccountKey=your-api-key', 'container' => 'your-container', 'prefix' => 'your-prefix', // optional ], ``` ### Dropbox [](#dropbox) Required adapter: ``` composer req spatie/flysystem-dropbox ``` Configuration: ``` 'fs' => [ 'adapter' => 'FlyDropbox', 'accesstoken' => 'your-access-token' ], ``` ### FTP [](#ftp) Required adapter: ``` composer req league/flysystem-ftp ``` Configuration: ``` 'fs' => [ 'adapter' => 'FlyFtp', 'host' => 'your-hostname-or-ipaddress', 'username' => 'your-username', 'password' => 'your-password', 'root' => '/path/to/basedir', 'port' => 21, // optional 'passive' => true, // optional 'ssl' => true, // optional 'timeout' => 30, // optional 'utf8' => false, // optional 'transferMode' => FTP_BINARY, // optional 'systemType' => null, // 'windows' or 'unix' 'ignorePassiveAddress' => null, // true or false 'timestampsOnUnixListingsEnabled' => false, // true or false 'recurseManually' => true // true ], ``` ### Google Cloud [](#google-cloud) Required adapter: ``` composer req league/flysystem-google-cloud-storage ``` Configuration: ``` 'fs' => [ 'adapter' => 'FlyGoogleCloud', 'keyFile' => json_decode(file_get_contents('/path/to/keyfile.json'), true), // alternative 'keyFilePath' => '/path/to/keyfile.json', // alternative 'projectId' => 'myProject', // alternative 'prefix' => 'your-prefix' // optional ], ``` For authentication details, have a look at the [Google Cloud client documentation](https://github.com/googleapis/google-cloud-php/blob/main/AUTHENTICATION.md). ### Local [](#local) Configuration: ``` 'fs' => [ 'adapter' => 'FlyLocal', 'basedir' => 'your-basedir-path', ], ``` ### Memory [](#memory) Required adapter: ``` composer req league/flysystem-memory ``` Configuration: ``` 'fs' => [ 'adapter' => 'FlyMemory', ], ``` ### SFTP [](#sftp) Required adapter: ``` composer req league/flysystem-sftp ``` Configuration: ``` 'fs' => [ 'adapter' => 'FlySftp', 'host' => 'your-hostname-or-ipaddress', 'port' => 22, // optional 'username' => 'your-username', // optional 'password' => 'your-password', // optional 'privateKey' => 'path/to/or/contents/of/private/key', // optional 'passphrase' => 'passphrase-for-the-private-key', // optional 'fingerprint' => 'fingerprint-string', // optional 'timeout' => 10, // optional 'retry' => 4, // optional 'agent' => true // optional ], ``` ### WebDAV [](#webdav) Required adapter (PHP 8.x only): ``` composer req league/flysystem-webdav ``` Configuration: ``` 'fs' => [ 'adapter' => 'FlyWebdav', 'baseUri' => 'your-webdav-uri', 'proxy' => 'your-proxy', // optional 'userName' => 'your-username', // optional 'password' => 'your-password', // optional 'authType' => 'authentication-type', // optional, 1=Basic, 2=Digest, 4=NTLM 'encoding' => 'encoding-type', // optional, 1=None, 2=Deflate, 4=Gzip, 7=All 'prefix' => 'your-prefix', // optional ], ``` ### Zip archive [](#zip-archive) Required adapter: ``` composer req league/flysystem-ziparchive ``` Configuration: ``` 'fs' => [ 'adapter' => 'FlyZip', 'filepath' => '/path/to/zipfile', ], ``` License ------- [](#license) The Aimeos filesystem extension is licensed under the terms of the LGPLv3 Open Source license and is available for free. Links ----- [](#links) - [Web site](https://aimeos.org/) - [Documentation](https://aimeos.org/docs) - [Help](https://aimeos.org/help) - [Issue tracker](https://github.com/aimeos/ai-filesystem/issues) - [Source code](https://github.com/aimeos/ai-filesystem) ### Health Score 56 — FairBetter than 98% of packages Maintenance71 Regular maintenance activity Popularity35 Limited adoption so far Community16 Small or concentrated contributor base Maturity84 Battle-tested with a long release history Bus Factor1 Top contributor holds 97.1% 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 ~41 days Recently: every ~47 days Total 86 Last Release 222d ago Major Versions 2021.10.2 → 2022.04.12022-04-05 2022.10.x-dev → 2023.01.x-dev2023-01-03 2023.10.1 → 2024.01.x-dev2024-01-03 2023.10.2 → 2024.10.x-dev2025-03-08 2024.10.x-dev → 2025.04.12025-04-03 PHP version history (5 changes)2016.01.x-devPHP >=5.3.3 2019.01.1PHP >=5.5.0 2020.01.1PHP ~7.1 2020.10.2PHP ~7.1||~8.0 2023.04.1PHP ^8.0.11 ### Community Maintainers ![](https://www.gravatar.com/avatar/ccdc84033584516c77fb6aa7f85dc7048f2fbcd08867fc6abf115d094bab5eef?d=identicon)[aimeos](/maintainers/aimeos) --- Top Contributors [![aimeos](https://avatars.githubusercontent.com/u/8647429?v=4)](https://github.com/aimeos "aimeos (101 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (2 commits)")[![Alababdiy](https://avatars.githubusercontent.com/u/30894733?v=4)](https://github.com/Alababdiy "Alababdiy (1 commits)") --- Tags Flysystemextensionaimeosfile system ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/aimeos-ai-filesystem/health.svg) ``` [![Health](https://phpackages.com/badges/aimeos-ai-filesystem/health.svg)](https://phpackages.com/packages/aimeos-ai-filesystem) ``` ### 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)[league/flysystem-webdav WebDAV filesystem adapter for Flysystem. 762.3M56](/packages/league-flysystem-webdav)[mhetreramesh/flysystem-backblaze Backblaze adapter for the flysystem filesystem abstraction library 62146.8k9](/packages/mhetreramesh-flysystem-backblaze)[jerodev/flysystem-v3-smb-adapter SMB adapter for Flysystem v3 1289.9k1](/packages/jerodev-flysystem-v3-smb-adapter)[danhunsaker/laravel-flysystem-others Automatically registers every third-party Flysystem adapter it recognizes as a Laravel Filesystem Driver. 2332.5k](/packages/danhunsaker-laravel-flysystem-others) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)