Users of 3.x should be able to update to 4.x without code changes unless their application did one of the following:

• Defined a custom File implementation
• Initialized ParallelFilesystemDriver with a custom worker count.

Breaking Changes

This release adds a lock(), tryLock(), and unlock() to the File interface. These methods provide a non-blocking means of locking and unlocking a file.

• File::lock(): Non-blocking method to obtain a shared or exclusive lock on the file. This method must only return once the lock has been obtained.
• File::tryLock(): Makes a single non-blocking attempt to obtain a shared or exclusive lock on the file. Returns true if the lock was obtained, otherwise false.
• File::unlock(): Unlocks the file if the lock is currently held.

In 3.x, the constructor of ParallelFilesystemDriver accepted an optional WorkerPool and a number of workers to use from that pool. In 4.x, instead the constructor now requires only an optional LimitedWorkerPool (a new pool is created if one is not provided). The number of workers used for opening files is determined by the value returned from LimitedWorkerPool::getWorkerLimit(). Use a DelegateWorkerPool if you wish to use an existing pool and limit the number of workers used from the pool to open files. In general, it is not necessary to customize the parallel filesystem driver.

Full Changelog: v3.2.0...v4.0.0

What's Changed

• The parallel driver no longer reuses the global worker pool if a specific instance is not provided to the constructor. Instead, a new worker pool is created.
• The $workerLimit parameter to the constructor of ParallelFilesystemDriver is now deprecated. Pass an instance of LimitedWorkerPool instead.

Full Changelog: v3.1.1...v3.2.0

What's Changed

• Add FileCache class by @Nadyita in #83
• Add KeyedFileMutex by @bwoebi in #62
• Made implicit nullable types explicit to avoid deprecation notice in PHP 8.4

New Contributors

• @Nadyita made their first contribution in #83

Full Changelog: v3.0.2...v3.1.0

What's Changed

• Fixed detecting if a file is writing from the file mode when r+ (or similar) is used as the mode. (#77)
• Fixed assertion failing during shutdown destruction of ParallelFilesystemDriver. (#81)

Full Changelog: v3.0.1...v3.0.2

What's Changed

• Fix touch() on non-existent files in ext-uv and ext-eio by @kelunik (#73)
• Fix write() truncation with ext-uv and ext-eio by @danog in (#76)

Full Changelog: v3.0.0...v3.0.1

Stable release compatible with AMPHP v3 and fibers! 🎉

As with other libraries compatible with AMPHP v3, most cases of parameters or returns of Promise<ResolutionType> have been replaced with ResolutionType.

• Renamed BlockingDriver to BlockingFilesystemDriver
• Renamed EioDriver to EioFilesystemDriver
• Renamed ParallelDriver to ParallelFilesystemDriver
• Renamed StatusCachingDriver to StatusCachingFilesystemDriver
• Renamed UvDriver to UvFilesystemDriver
• Renamed Amp\File\Sync\AsyncFileMutex to Amp\File\FileMutex
• Added ?Cancellation as first parameter of File::read()
• Added File::isSeekable()
• Removed File::SEEK_SET, File::SEEK_CUR, and File::SEEK_END
• Added Amp\File\Whence for seeking instead