PHPackages philiprehberger/safe-file-writer - 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. philiprehberger/safe-file-writer ActiveLibrary[File & Storage](/categories/file-storage) philiprehberger/safe-file-writer ================================ Atomic file writes with temp-file swap and file locking v1.0.1(1mo ago)11[2 PRs](https://github.com/philiprehberger/safe-file-writer/pulls)MITPHPPHP ^8.2CI passing Since Mar 13Pushed 1mo agoCompare [ Source](https://github.com/philiprehberger/safe-file-writer)[ Packagist](https://packagist.org/packages/philiprehberger/safe-file-writer)[ Docs](https://github.com/philiprehberger/safe-file-writer)[ RSS](/packages/philiprehberger-safe-file-writer/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (3)Versions (3)Used By (0) PHP Safe File Writer ==================== [](#php-safe-file-writer) [![Tests](https://github.com/philiprehberger/safe-file-writer/actions/workflows/tests.yml/badge.svg)](https://github.com/philiprehberger/safe-file-writer/actions/workflows/tests.yml)[![Latest Version on Packagist](https://camo.githubusercontent.com/3d3d2c0174d95af6f67e2cf53ab922468b9852c2cdf5ee2ae1d0fc330e22de65/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7068696c69707265686265726765722f736166652d66696c652d7772697465722e737667)](https://packagist.org/packages/philiprehberger/safe-file-writer)[![License](https://camo.githubusercontent.com/c3d93eae655093444630c719ab605ebc4781bd54c53b976b79ae5f7858de9813/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7068696c69707265686265726765722f736166652d66696c652d777269746572)](LICENSE) Atomic file writes with temp-file swap and file locking. Requirements ------------ [](#requirements) - PHP 8.2+ Installation ------------ [](#installation) ``` composer require philiprehberger/safe-file-writer ``` Usage ----- [](#usage) ### Write a file atomically [](#write-a-file-atomically) ``` use PhilipRehberger\SafeFileWriter\SafeFile; // Writes to a temp file first, then renames — atomic on POSIX systems SafeFile::write('/path/to/config.txt', 'key=value'); // Parent directories are created automatically SafeFile::write('/path/to/deep/nested/file.txt', 'content'); ``` ### Write JSON [](#write-json) ``` SafeFile::writeJson('/path/to/data.json', [ 'name' => 'Philip', 'scores' => [10, 20, 30], ]); // Writes pretty-printed JSON with a trailing newline // Custom JSON flags SafeFile::writeJson('/path/to/compact.json', $data, JSON_UNESCAPED_UNICODE); ``` ### Append to a file [](#append-to-a-file) ``` // Appends with exclusive lock; creates file if it doesn't exist SafeFile::append('/var/log/app.log', "[2026-03-13] Info: started\n"); SafeFile::append('/var/log/app.log', "[2026-03-13] Info: finished\n"); ``` ### Read a file [](#read-a-file) ``` // Reads with a shared lock $content = SafeFile::read('/path/to/config.txt'); ``` ### Read JSON [](#read-json) ``` $data = SafeFile::readJson('/path/to/data.json'); // Returns decoded array/object ``` ### Check existence [](#check-existence) ``` if (SafeFile::exists('/path/to/file.txt')) { // ... } ``` ### Delete a file [](#delete-a-file) ``` $deleted = SafeFile::delete('/path/to/file.txt'); // Returns true if deleted, false if file didn't exist ``` API --- [](#api) MethodDescriptionReturns`SafeFile::write(string $path, string $content)`Atomic write via temp-file + rename`void``SafeFile::writeJson(string $path, mixed $data, int $flags = ...)`Atomic JSON write`void``SafeFile::append(string $path, string $content)`Append with exclusive lock`void``SafeFile::read(string $path)`Read with shared lock`string``SafeFile::readJson(string $path)`Read and decode JSON`mixed``SafeFile::exists(string $path)`Check if file exists`bool``SafeFile::delete(string $path)`Delete file if it exists`bool``FileWriteException`Directory creation, temp-file creation, write, or rename failure—`FileReadException`File not found, open failure, lock failure, or read failure—`\JsonException`Invalid JSON on `writeJson()` or `readJson()`—Development ----------- [](#development) ``` composer install vendor/bin/phpunit vendor/bin/pint --test vendor/bin/phpstan analyse ``` License ------- [](#license) MIT ### Health Score 38 — LowBetter than 85% of packages Maintenance89 Actively maintained with recent releases Popularity4 Limited adoption so far Community6 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~7 days Total 2 Last Release 53d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/cfd7d24cbbf32400fa13ce0bbe7a31edd2d66a6d4488eafdb3d64c5337bf0435?d=identicon)[philiprehberger](/maintainers/philiprehberger) --- Top Contributors [![philiprehberger](https://avatars.githubusercontent.com/u/8218077?v=4)](https://github.com/philiprehberger "philiprehberger (10 commits)") --- Tags safefilewritelockatomic ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/philiprehberger-safe-file-writer/health.svg) ``` [![Health](https://phpackages.com/badges/philiprehberger-safe-file-writer/health.svg)](https://phpackages.com/packages/philiprehberger-safe-file-writer) ``` ### Alternatives [league/flysystem File storage abstraction for PHP 13.6k639.1M2.2k](/packages/league-flysystem)[league/flysystem-aws-s3-v3 AWS S3 filesystem adapter for Flysystem. 1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[knplabs/gaufrette PHP library that provides a filesystem abstraction layer 2.5k39.8M123](/packages/knplabs-gaufrette)[knplabs/knp-gaufrette-bundle Allows to easily use the Gaufrette library in a Symfony project 72528.6M91](/packages/knplabs-knp-gaufrette-bundle)[league/flysystem-local Local filesystem adapter for Flysystem. 226231.8M39](/packages/league-flysystem-local)[nette/safe-stream Nette SafeStream: provides isolation for thread safe manipulation with files via native PHP functions. 1174.9M140](/packages/nette-safe-stream) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)