PHPackages diamond-dove/simple-json - 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. diamond-dove/simple-json ActiveLibrary diamond-dove/simple-json ======================== Read and write big JSON files v2.0.0(10mo ago)311↓100%1[2 issues](https://github.com/diamond-dove/simple-json/issues)MITPHPPHP ^8.4 Since Feb 12Pushed 10mo ago1 watchersCompare [ Source](https://github.com/diamond-dove/simple-json)[ Packagist](https://packagist.org/packages/diamond-dove/simple-json)[ Docs](https://github.com/diamond-dove/simple-json)[ RSS](/packages/diamond-dove-simple-json/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)Dependencies (5)Versions (5)Used By (0) Simple JSON File Reader and Writer ================================== [](#simple-json-file-reader-and-writer) This package makes it easy to read and write simple JSON files. It uses generators to minimize memory usage, even when dealing with large files. Here is an example of how to read a JSON file: ``` use DiamondDove\SimpleJson\SimpleJsonReader; SimpleJsonReader::create('users.json')->get() ->each(function(array $user) { // process the row }); ``` Installation ============ [](#installation) You can install the package using composer: ``` composer require diamon-dove/simple-json ``` Usage ===== [](#usage) Reading a JSON -------------- [](#reading-a-json) Suppose you have a JSON file with the following content: ``` [ {"email": "john@example.com", "first_name": "John"}, {"email": "jane@example.com", "first_name": "jane"} ] ``` To read this file in PHP, you can do the following: ``` use DiamondDove\SimpleJson\SimpleJsonReader; // $records is an instance of Illuminate\Support\LazyCollection $records = SimpleJsonReader::create($pathToJson)->get(); $records->each(function(array $user) { // in the first pass $user will contain // ['email' => 'john@example.com', 'first_name' => 'john'] }); ``` ### Working with LazyCollections [](#working-with-lazycollections) `get` will return an instance of `Illuminate\Support\LazyCollection`. This class is part of the Laravel framework. Behind the scenes generators are used, so memory usage will be low, even for large files. You'll find a list of methods you can use on a `LazyCollection` [in the Laravel documentation.](https://laravel.com/docs/master/collections#the-enumerable-contract) Here's a quick, silly example where we only want to process rows that have a first\_name that contains more than 5 characters. You'll find a list of methods you can use on a LazyCollection in the Laravel documentation. Here's a quick, silly example where we only want to process elements that have a first\_name that contains more than 5 characters. ``` SimpleJsonReader::create($pathToJson)->get() ->filter(function(array $user) { return strlen($user['first_name']) > 5; }) ->each(function(array $user) { // processing user }); ``` Writing files ------------- [](#writing-files) To write a JSON file, you can use the following code: use DiamondDove\\SimpleJson\\SimpleJsonWriter; ``` $writer = SimpleJsonWriter::create($pathToJson) ->push([[ 'first_name' => 'John', 'last_name' => 'Doe', ], [ 'first_name' => 'Jane', 'last_name' => 'Doe', ] ]); ``` The file at pathToJson will contain: ``` [ {"first_name": "John", "last_name": "Doe"}, {"first_name": "Jane", "last_name": "Doe"} ] ``` You can also use: ``` SimpleJsonWriter::create($this->pathToJson) ->push([ 'name' => 'Thomas', 'state' => 'Nigeria', 'age' => 22, ]) ->push([ 'name' => 'Luis', 'state' => 'Nigeria', 'age' => 32, ]); ``` Testing ======= [](#testing) ``` composer test ``` Contributing ============ [](#contributing) Please see [CONTRIBUTING](https://github.com/diamond-dove/simple-json/blob/main/CONTRIBUTING.md) for details. Security ======== [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ======= [](#credits) - [Fermin Perdomo](https://github.com/masterfermin02) - [All Contributors](../../contributors) License ======= [](#license) The MIT License [(MIT)](LICENSE.md). Please see License File for more information. ### Health Score 36 — LowBetter than 81% of packages Maintenance43 Moderate activity, may be stable Popularity11 Limited adoption so far Community10 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor1 Top contributor holds 88.9% 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 ~409 days Total 4 Last Release 319d ago Major Versions v1.0.2 → v2.0.02025-06-24 PHP version history (3 changes)v1.0.0PHP ^8.0|^8.1 v1.0.1PHP ^8.0 v2.0.0PHP ^8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/17c416be607cbb47c55e76e115e3c35c3d74906ff422e808e4bba3be1dfb5cd6?d=identicon)[masterfermin02](/maintainers/masterfermin02) --- Top Contributors [![masterfermin02](https://avatars.githubusercontent.com/u/4625540?v=4)](https://github.com/masterfermin02 "masterfermin02 (8 commits)")[![elminson](https://avatars.githubusercontent.com/u/2476286?v=4)](https://github.com/elminson "elminson (1 commits)") --- Tags diamond-dovesimple-json ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/diamond-dove-simple-json/health.svg) ``` [![Health](https://phpackages.com/badges/diamond-dove-simple-json/health.svg)](https://phpackages.com/packages/diamond-dove-simple-json) ``` ### Alternatives [spatie/laravel-backup A Laravel package to backup your application 6.0k21.8M186](/packages/spatie-laravel-backup)[spatie/laravel-health Monitor the health of a Laravel application 85810.0M83](/packages/spatie-laravel-health)[spatie/laravel-db-snapshots Quickly dump and load databases 1.2k2.8M20](/packages/spatie-laravel-db-snapshots)[fumeapp/modeltyper Generate TypeScript interfaces from Laravel Models 196277.9k](/packages/fumeapp-modeltyper)[outerweb/image-library Store and link files to your models 1113.0k2](/packages/outerweb-image-library) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)