PHPackages clean/repository - 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. [Utility & Helpers](/categories/utility) 4. / 5. clean/repository ActiveLibrary[Utility & Helpers](/categories/utility) clean/repository ================ 2.0.4(8y ago)748.7k2MITPHPPHP >=5.5.0 Since Aug 5Pushed 6y ago1 watchersCompare [ Source](https://github.com/clean/repository)[ Packagist](https://packagist.org/packages/clean/repository)[ RSS](/packages/clean-repository/feed)WikiDiscussions master Synced today READMEChangelogDependencies (7)Versions (10)Used By (0) Clean\\Repository ================= [](#cleanrepository) [![Build Status](https://camo.githubusercontent.com/12cb93d146801141b9fdb81211971818722b6632472dc13458fd8ae1767b093f/68747470733a2f2f7472617669732d63692e6f72672f636c65616e2f7265706f7369746f72792e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/clean/repository)[![Code Climate](https://camo.githubusercontent.com/1b6fd82a8868c128534a571a397ab0f00f45282a9fdc10f4e01fa1953ea00cb5/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f636c65616e2f7265706f7369746f72792f6261646765732f6770612e737667)](https://codeclimate.com/github/clean/repository)[![Test Coverage](https://camo.githubusercontent.com/332aba72d10a9121d13006b271c24e059ace0bfcc491d20e85c1971c8f6c31e9/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f636c65616e2f7265706f7369746f72792f6261646765732f636f7665726167652e737667)](https://codeclimate.com/github/clean/repository/coverage)[![Issue Count](https://camo.githubusercontent.com/7ef7db020f24a41e0622462a90ed7c18f9a4447044e077cab15c4b1e203ea9e7/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f636c65616e2f7265706f7369746f72792f6261646765732f69737375655f636f756e742e737667)](https://codeclimate.com/github/clean/repository)[![Latest Stable Version](https://camo.githubusercontent.com/a1ee2bfe5506c6abcc6f316a3b8957ebce1c0d38195e041998a4fca586e83830/68747470733a2f2f706f7365722e707567782e6f72672f636c65616e2f7265706f7369746f72792f762f737461626c65)](https://packagist.org/packages/clean/repository)[![Total Downloads](https://camo.githubusercontent.com/75c655329ee392497380e070bf68d67271898cb355f81c23e03464e13cb960a6/68747470733a2f2f706f7365722e707567782e6f72672f636c65616e2f7265706f7369746f72792f646f776e6c6f616473)](https://packagist.org/packages/clean/repository)[![License](https://camo.githubusercontent.com/d58a199a12af29156cdf1ca3ae29cbd06266528b70522821299cebf26329d022/68747470733a2f2f706f7365722e707567782e6f72672f636c65616e2f7265706f7369746f72792f6c6963656e7365)](https://packagist.org/packages/clean/repository) Use a repository to separate the logic that retrieves the data and maps it to the entity model from the business logic that acts on the model. The business logic should be agnostic to the type of data that comprises the data source layer. For example, the data source layer can be a database or a Web service. Objectives ---------- [](#objectives) - You access the data source from many locations and want to apply centrally managed, consistent access rules and logic. - You want to implement and centralize a caching strategy for the data source. - You want to improve the code's maintainability and readability by separating business logic from data or service access logic. Installation ------------ [](#installation) via [Composer](https://packagist.org/packages/clean/repository): ``` "require": { "clean/repository": "dev-master" } ``` Idea and Implementation ----------------------- [](#idea-and-implementation) Repository is and object that holds multiply criterias. Those criteria can represent query to database or GET request parameters or anything else that require creating some kind of request based on various parameters. The idea is to hide concrate implementation of generating queries or requests behind semantic layer e.g.: ``` /* get 4 'toyota' cars, not older than 10 year, only with diesel engine, with information about last 2 owners, include pictures of car */ $carRepository ->limit(4) ->filterByMark('toyota') ->notOlderThan(10) ->onlyDiesel() ->includeOwners([ 'getLatest' => 2, ]) ->includePictures() ->assemble(); ``` There are few rules worth to follow: - when you need to reduce result use `filter...`, or `only...` method - when you need to sort result use `sortBy...` method - when you need to extend result use `with...` method - when you need to include related entity use `include...` method - you can also define your own rules valid for your project like `notOlderThan` Working example: ---------------- [](#working-example) - [Chinook database repository example](example/chinook) ### Health Score 35 — LowBetter than 77% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity29 Limited adoption so far Community11 Small or concentrated contributor base Maturity64 Established project with proven stability Bus Factor1 Top contributor holds 66.7% 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 ~94 days Recently: every ~164 days Total 9 Last Release 3230d ago Major Versions 1.1.0 → 2.0.02015-11-10 ### Community Maintainers ![](https://www.gravatar.com/avatar/21d3fe3ceb74869ffa1dd2ca9aac14d6df3e9e4209cfa8ed9c602875d590959b?d=identicon)[romannowicki](/maintainers/romannowicki) --- Top Contributors [![krzysztof-magosa](https://avatars.githubusercontent.com/u/6112411?v=4)](https://github.com/krzysztof-magosa "krzysztof-magosa (2 commits)")[![peengle](https://avatars.githubusercontent.com/u/305179?v=4)](https://github.com/peengle "peengle (1 commits)") --- Tags repository pattern ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/clean-repository/health.svg) ``` [![Health](https://phpackages.com/badges/clean-repository/health.svg)](https://phpackages.com/packages/clean-repository) ``` ### Alternatives [kunstmaan/utilities-bundle The KunstmaanUtilitiesBundle makes your life easier by providing a couple of small but usefull helper services you can use and re-use in your applications. We already implemented an easy to use cipher service and a shell helper service for you but feel free to send in a pull request with your additions. The shell helper allows you to run apps in the background, see if a process is running and has a method to kill a running process. The cipher service allow you to encode and decode strings using the Rijndael 256 cipher 13152.7k6](/packages/kunstmaan-utilities-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)