Download the PHP package nette/safe-stream without Composer
On this page you can find all versions of the php package nette/safe-stream. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nette/safe-stream
More information about nette/safe-stream
Files in nette/safe-stream
Package safe-stream
Short Description Nette SafeStream: provides isolation for thread safe manipulation with files via native PHP functions.
License BSD-3-Clause GPL-2.0-only GPL-3.0-only
Homepage https://nette.org
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package safe-stream
SafeStream: Safety for Files
Introduction
SafeStream guarantees that every read and write to a file is isolated. This means that no thread will start reading a file that is not yet fully written, or multiple threads will not overwrite the same file.
Installation:
What is it good for?
What are isolated operations actually good for? Let's start with a simple example that repeatedly writes to a file and then reads the same string from it:
It may seem that echo 'strings differ!' can never occur. The opposite is true. Try running this script in two browser tabs at the same time. The error will occur almost immediately.
One of the tabs will read the file at a time when the other hasn't had a chance to write it all, so the content will not be complete.
Therefore, the code is not safe if it is executed multiple times at the same time (i.e. in multiple threads). Which is not uncommon on the internet, often a server is responding to a large number of users at one time. So ensuring that your application works reliably even when executed in multiple threads (thread-safe) is very important. Otherwise, data will be lost and hard-to-detect errors will occur.
But as you can see, PHP's native file read and write functions are not isolated and atomic.
How to use SafeStream?
SafeStream creates a secure protocol to read and write files in isolation using standard PHP functions. All you need to do is to specify nette.safe:// before the file name:
SafeStream ensures that at most one thread can write to the file at a time. The other threads are waiting in the queue. If no thread is writing, any number of threads can read the file in parallel.
All common PHP functions can be used with the protocol, for example:
Documentation can be found on the website. If you like it, please make a donation now. Thank you!
