mikey179/vfsstream

This is a maintenance release adding support for PHP 8.1.

• Fix PHP 8.1 deprecation warnings affecting the following (#258, #259):
  • vfsStreamContainerIterator::current()
  • vfsStreamContainerIterator::next()
  • vfsStreamContainerIterator::key()
  • vfsStreamContainerIterator::rewind()
  • vfsStreamDirectory::getIterator()
  • vfsStreamPrintVisitor::printContent()

• Fix deprecation warning on StringBasedFileContent for PHP 8.1 (#252)
• Fix return type for FileContent::write(), SeekableFileContent::write(), and vfsStreamFile::write() to fix static analysis tools

• Fix StringBasedFileContent::doRead to always return a string (#204)

• fix PHP 7.4 deprecation warnings (backported #189 from master)

• backported #174 from master, original PR provided by @localheinz

• fixed #157 seeking before beginning of file should fail, reported and fixed by @merijnvdk
• structure array in vfsStream::create() and vfsStream::setup() now can contain instances of org\bovigo\vfs\content\FileContent and org\bovigo\vfs\vfsStreamFile, patch provided by Joshua Smith (@jsmitty12)

• fixed #134 type safe directory names, reported and fixed by Sebastian Hopfe

• fixed #131 recursive mkdir() fails if the last dirname is '0'

• fixed #128 duplicate "valid" files/directories and incorrect file names

• vfsStream::url() didn't urlencode single path parts while vfsStream::path() did urldecode them
  • fixed #120, #122: create directory with trailing slash results in "Uninitialized string offset: 0"

• added vfsStreamWrapper::unregister(), provided by @malkusch with #114
  • fixed #115: incorrect handling of .. in root directory on PHP 5.5, fix provided by @acoulton with #116

• implemented #91: vfsStream::copyFromFileSystem() should create large file instances
  • implemented #92: vfsStream::copyFromFileSystem() should respect block devices
  • fixed #107: touch() does not respect file permissions
  • fixed #105: vfs directory structure is not reset after each test
  • fixed #104: vfsStream can't handle url encoded pathes

• implemented #85: Added support for emulating block devices in the virtual filesystem, feature provided by Harris Borawski
  • fixed #68: Unlink a non-existing file now triggers a PHP warning

• implemented #79: possibility to mock large files without large memory footprint, see https://github.com/mikey179/vfsStream/wiki/MockingLargeFiles
  • implemented #67: added partial support for text-mode translation flag (i.e., no actual translation of line endings takes place) so it no longer throws an exception (provided by Anthon Pang)
  • fixed issue #74: issue with trailing windows path separators (provided by Sebastian Krüger)
  • fixed issue #50: difference between real file system and vfs with RecursiveDirectoryIterator
  • fixed issue #80: touch with no arguments for modification and access time behave incorrect
  • deprecated org\bovigo\vfs\vfsStreamFile::readUntilEnd()
  • deprecated org\bovigo\vfs\vfsStreamFile::getBytesRead()

• implemented issue #34: provide url() method on all vfsStreamContent instances
  • added org\bovigo\vfs\vfsStreamContent::url()
  • added org\bovigo\vfs\vfsStreamContent::path()
  • fixed issue #40: flock implementation doesn't work correctly, patch provided by Kamil Dziedzic
  • fixed issue #49: call to member function on a non-object when trying to delete a file one above root where a file with same name in root exists
  • fixed issue #51: unlink() must consider permissions of directory where file is inside, not of the file to unlink itself
  • fixed issue #52: chmod(), chown() and chgrp() must consider permissions of directory where file/directory is inside
  • fixed issue #53: chmod(), chown() and chgrp() must consider current user and current owner of file/directoy to change

• implemented issue #11: add support for streamWrapper::stream_metadata() vfsStream now supports touch(), chown(), chgrp() and chmod()
  • implemented issue #33: add support for stream_truncate() (provided by https://github.com/nikcorg)
  • implemented issue #35: size limit (quota) for VFS

• raised requirement for PHP version to 5.3.0
  • migrated codebase to use namespaces
  • changed distribution from PEAR to Composer
  • implemented issue #30: support "c" mode for fopen()
  • fixed issue #31: prohibit aquiring locks when already locked / release lock on fclose()
  • fixed issue #32: problems when subfolder has same name as folder
  • fixed issue #36: vfsStreamWrapper::stream_open() should return false while trying to open existing non-writable file, patch provided by Alexander Peresypkin