PHPackages netdudes/data-sourcery-bundle - 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. netdudes/data-sourcery-bundle AbandonedArchivedSymfony-bundle[Utility & Helpers](/categories/utility) netdudes/data-sourcery-bundle ============================= Netdudes DataSourceryBundle 27.2k1[2 issues](https://github.com/netdudes/DataSourceryBundle/issues)PHP Since May 31Pushed 8y ago5 watchersCompare [ Source](https://github.com/netdudes/DataSourceryBundle)[ Packagist](https://packagist.org/packages/netdudes/data-sourcery-bundle)[ RSS](/packages/netdudes-data-sourcery-bundle/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (4)Used By (0) ### \*\*\*\*\*\* WARNING: THIS PROJECT IS NO LONGER MAINTAINED!! \*\*\*\*\*\* [](#-warning-this-project-is-no-longer-maintained-) Netdudes\\DataSourceryBundle ============================ [](#netdudesdatasourcerybundle) [![Build Status](https://camo.githubusercontent.com/30eb4a331c2d60df08fe123d061396937e88c64b5bd0d27b82cca310cb6f73e6/68747470733a2f2f7472617669732d63692e6f72672f6e657464756465732f44617461536f75726365727942756e646c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/netdudes/DataSourceryBundle)[![Code Climate](https://camo.githubusercontent.com/76ae230213d83083933e98f39acdc733db77b6114b50effd72de2c7b500b766b/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f6e657464756465732f44617461536f75726365727942756e646c652f6261646765732f6770612e737667)](https://codeclimate.com/github/netdudes/DataSourceryBundle)[![SensioLabsInsight](https://camo.githubusercontent.com/f7ad71c754d8b1d280a6ba182a9103fc1b9effe40260653a87724d7a63bb6b03/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f30316162656666642d316134372d343763652d396537342d6563353737623763666662362f6d696e692e706e67)](https://insight.sensiolabs.com/projects/01abeffd-1a47-47ce-9e74-ec577b7cffb6)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/95031571ad1bf8186ae41f24d16adbeaae5023a4f3e2a29604f2e3ce5df69666/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6e657464756465732f44617461536f75726365727942756e646c652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/netdudes/DataSourceryBundle/?branch=master) [![Latest Stable Version](https://camo.githubusercontent.com/d21fd097460106090ed27499397e7646bfd80023bfcf0890af11347d9ea1b7d2/68747470733a2f2f706f7365722e707567782e6f72672f6e657464756465732f646174612d736f7572636572792d62756e646c652f762f737461626c652e737667)](https://packagist.org/packages/netdudes/data-sourcery-bundle) [![Total Downloads](https://camo.githubusercontent.com/f840ba976f7d1d04cb098c3f8e830df6ca7a64eb888a5dc7e4f917243b652cc5/68747470733a2f2f706f7365722e707567782e6f72672f6e657464756465732f646174612d736f7572636572792d62756e646c652f646f776e6c6f6164732e737667)](https://packagist.org/packages/netdudes/data-sourcery-bundle) [![Latest Unstable Version](https://camo.githubusercontent.com/a98d2f498c57769d90c67fbf43ffab04304d27e40a5e5cc3db7cc9b37ca20b85/68747470733a2f2f706f7365722e707567782e6f72672f6e657464756465732f646174612d736f7572636572792d62756e646c652f762f756e737461626c652e737667)](https://packagist.org/packages/netdudes/data-sourcery-bundle) [![License](https://camo.githubusercontent.com/8927d0041e2e3863a84e7eb8b8c748b35093c6bce4d4ee5445623ba6de053816/68747470733a2f2f706f7365722e707567782e6f72672f6e657464756465732f646174612d736f7572636572792d62756e646c652f6c6963656e73652e737667)](https://packagist.org/packages/netdudes/data-sourcery-bundle) DataSourceryBundle is a neat tool to handle building and performing complex queries on data sets, including support for natural-language queries and safe handling of user provided query parameters. Usage *(work in progress!)* --------------------------- [](#usage-work-in-progress) Assume we have one entity in our system managed by **Doctrine**, called `User`, that looks like this: ``` User { string username string nameFirst string nameLast \DateTime registered User bestFriend => OtM with another user User worstEnemy => OtM with another user } ``` You can get the building block of the library, the `DataSource`, from a builder. From here and now on we will assume you have a DI container (e.g. Symfony) where the needed services are registered. ``` $dataSourceBuilder = $container ->get('netdudes_data_sourcery.data_source.factory') ->createBuilder('My\Entities\User'); ``` With a builder is easy to create a `Datasource` ``` $dataSourceBuilder ->addField('username', 'string', 'username') ->addField('bestFriendUsername' 'string', 'bestFriend.username') ->addField('worstEnemyUsername', 'string', 'worstEnemy.username') ->addField('friendOfMyEnemyUsername', 'string', 'worstEnemy.bestFriend.username') ->addField('registered', 'date', 'registered'); $dataSource = $dataSourceBuilder->build(); ``` Alternatively, a data source can be generated from a configuration class, very similarly to how Symfony Forms are built. ``` class MyNiceDataSourceConfig implements DataSourceConfigurationInterface { public function getEntityClass() { return 'My\Entities\User'; } public function buildDataSource(DataSourceBuilderInterface $builder) { $builder ->addField('username', 'string', 'username') ->addField('bestFriendUsername', 'string', 'bestFriend.username') ->addField('worstEnemyUsername', 'string', 'worstEnemy.username') ->addField('friendOfMyEnemyUsername', 'string', 'worstEnemy.bestFriend.username') ->addField('registered', 'date', 'registered'); } } $dataSource = $container ->get('netdudes_data_sourcery.data_source.factory') ->createFromConfiguration(new MyNiceDataSourceConfig()); ``` In order to query you data source, you must have a `Query` object. Creating one manually is easy: ``` $query = new Query(); $query->setSelect(['username', 'bestFriendUsername', 'worstEnemyUsername', 'friendOfMyEnemyUsername', 'registered']); $filter = new Filter( [ new FilterCondition('username', FilterCondition::METHOD_STRING_EQ, 'admin') ] ); $query->setFilter($filter); ``` Alternatively you can use the built in parser for the system's language, UQL: ``` $uqlInterpreter = $container->get('netdudes_data_sourcery.uql.interpreter.factory')->create($dataSource); $filter = $uqlInterpreter->generateFilters('username != "admin"'); $query->setFilter($filter); ``` Finally, you can get your data from the data source ``` $data = $dataSource->getData($query); dump($data); ``` Giving ``` array:1 [ 0 => array:5 [ "username" => "admin" "bestFriendUsername" => "Max" "worstEnemyUsername" => "John" "friendOfMyEnemyUsername" => "Max" "registered" => DateTime {#124 +"date": "2014-02-01 00:00:00.000000" +"timezone_type": 3 +"timezone": "Europe/Berlin" } ] ] ``` ### Health Score 23 — LowBetter than 27% of packages Maintenance0 Infrequent updates — may be unmaintained Popularity22 Limited adoption so far Community16 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/d21ec9bace15829e28a288203f36a3adc133374c8e5f4e427c31a54495e060ea?d=identicon)[yakobe](/maintainers/yakobe) --- Top Contributors [![adlpz](https://avatars.githubusercontent.com/u/602379?v=4)](https://github.com/adlpz "adlpz (41 commits)")[![mkruk-u2](https://avatars.githubusercontent.com/u/13467160?v=4)](https://github.com/mkruk-u2 "mkruk-u2 (27 commits)")[![yakobe](https://avatars.githubusercontent.com/u/800592?v=4)](https://github.com/yakobe "yakobe (15 commits)")[![senaria](https://avatars.githubusercontent.com/u/5164586?v=4)](https://github.com/senaria "senaria (13 commits)")[![guill3m](https://avatars.githubusercontent.com/u/1526816?v=4)](https://github.com/guill3m "guill3m (9 commits)")[![DrososTasos](https://avatars.githubusercontent.com/u/12499205?v=4)](https://github.com/DrososTasos "DrososTasos (6 commits)") ### Embed Badge ![Health badge](/badges/netdudes-data-sourcery-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/netdudes-data-sourcery-bundle/health.svg)](https://phpackages.com/packages/netdudes-data-sourcery-bundle) ``` ### Alternatives [codebyray/laravel-review-rateable Review & Rating system for Laravel 10, 11 & 12 310351.9k](/packages/codebyray-laravel-review-rateable)[egeloen/google-map-bundle Provides a google map integration for your Symfony2 Project. 216716.3k3](/packages/egeloen-google-map-bundle)[torann/laravel-meta-tags A package to manage Header Meta Tags 65273.3k4](/packages/torann-laravel-meta-tags)[aura/html Provides HTML escapers and helpers, including form input helpers. 52270.5k21](/packages/aura-html)[leric/php-thrift Thrift client api for PHP(version sync with thrift) 38320.6k3](/packages/leric-php-thrift)[presseddigital/linkit One link field to rule them all. 28160.7k](/packages/presseddigital-linkit) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)