Virtual File System
Go to file
Andrew Lawson 610649d759 Merge pull request #18 from igrizzli/develop
Readdir infinity reading fix
2016-04-22 08:46:29 +01:00
example Add eval example 2014-09-06 15:33:24 +01:00
src Fix directory reading. Return FALSE on directory end instead empty string for avoiding infinity readdir cycles. 2016-04-21 19:51:54 +00:00
test Fix directory reading. Return FALSE on directory end instead empty string for avoiding infinity readdir cycles. 2016-04-21 19:51:54 +00:00
.gitignore Add windows support. 2016-02-20 03:49:02 +05:00
.travis.yml Update composer on travis install 2015-07-22 13:25:29 +01:00
LICENSE Update license year to 2015 2015-07-21 15:17:00 +01:00 Add mount to README example 2015-07-22 16:10:55 +01:00
composer.json Set verbose flag on phpunit 2015-07-24 17:15:17 +01:00
phpunit.xml.dist Add `file_get_contents` acceptance tests 2014-09-06 14:24:45 +01:00

VFS (Virtual File System)

Virtual File System

Master branch build status Published version PHP ~5.4 MIT Licensed

VFS is a virtual file system for PHP built using the stream wrapper API. Streams are exposed just as typical file:// or http:// streams are to PHP's built-in functions and keywords like fopen and require. This implementation attempts to stay true to the typical streams, including triggering warnings and handling edge cases appropriately.

It can be installed in whichever way you prefer, but I recommend Composer.

    "require": {
        "adlawson/vfs": "*"


After creating and mounting the file system, you have the option of manipulating the virtual file system either via PHP's built-in functions, the VFS interfaces, or interfaces provided by another file system library.

use Vfs\FileSystem;
use Vfs\Node\Directory;
use Vfs\Node\File;

// Create and mount the file system
$fs = FileSystem::factory('vfs://');

// Add `/foo` and `/foo/bar.txt`
$foo = new Directory(['bar.txt' => new File('Hello, World!')]);
$fs->get('/')->add('foo', $foo);

// Get contents of `/foo/bar.txt`
$fs->get('/foo/bar.txt')->getContent(); // Hello, World!
file_get_contents('vfs://foo/bar.txt'); // Hello, World!

// Add `/foo/bar` and `/foo/bar/baz.php`
file_put_contents('vfs://foo/bar.php', '<?php echo "Hello, World!";');

// Require `/foo/bar.php`
require 'vfs://foo/baz.php';

// Works with any other file system library too
$symfony = new Symfony\Component\Filesystem\Filesystem();
$laravel = new Illuminate\Filesystem();
$laravel->isDirectory('vfs://foo/bar/baz'); //true

// Triggers PHP warnings on error just like typical streams
rename('vfs://path/to/nowhere', 'vfs://path/to/somewhere');
// PHP Warning: rename(vfs://path/to/nowhere,vfs://path/to/somewhere): No such file or directory in /srv/index.php on line 1; triggered in /srv/src/Logger/PhpErrorLogger.php on line 32

Example use cases

If you need to ask what you'd use a virtual file system for, you probably don't need one, but just in case, I've compiled a small list of examples:

  • Testing file system libraries without writing to disc
  • Runtime evaluation without eval (via write and require)
  • ...we need some more!


Current tasks are listed on the github issues page, but some are listed here for reference:

  • Symlinks
  • File locks
  • Permissions/ACL


Contributions are accepted via Pull Request, but passing unit tests must be included before it will be considered for merge.

$ curl -O
$ vagrant up
$ vagrant ssh

$ cd /srv
$ composer install
$ vendor/bin/phpunit


The content of this library is released under the MIT License by Andrew Lawson.
You can find a copy of this license in LICENSE or at