PHPackages                             mphpmaster/model-query-selector - 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. [Database & ORM](/categories/database)
4. /
5. mphpmaster/model-query-selector

ActiveLibrary[Database & ORM](/categories/database)

mphpmaster/model-query-selector
===============================

Laravel ModelQuerySelector - SQL Column Selection Utility

1.2.2(2y ago)012MITPHPPHP >=8.1

Since Apr 20Pushed 2y ago1 watchersCompare

[ Source](https://github.com/mPhpMaster/model-query-selector)[ Packagist](https://packagist.org/packages/mphpmaster/model-query-selector)[ RSS](/packages/mphpmaster-model-query-selector/feed)WikiDiscussions main Synced today

READMEChangelog (5)Dependencies (3)Versions (6)Used By (0)

Laravel ModelQuerySelector - SQL Column Selection Utility
=========================================================

[](#laravel-modelqueryselector---sql-column-selection-utility)

Laravel ModelQuerySelector is a powerful package designed to simplify the construction of SQL select queries in Laravel applications. It offers a fluent interface for building column selections and table aliases, streamlining the creation of complex queries.

Features
--------

[](#features)

- **Fluent Interface**: Easily construct SQL select queries using a fluent and intuitive syntax.
- **Column Selections**: Efficiently specify columns to be selected in the query.
- **Table Aliases**: Define table aliases for improved query readability and clarity.
- **Dynamic and Static Methods**: Use both static and dynamic method calls to create queries.

Dependencies:
-------------

[](#dependencies)

- php >=8.1 **REQUIRED IN YOUR PROJECT**
- laravel >=8 **REQUIRED IN YOUR PROJECT**
- illuminate/support >=8 *composer will install it automaticly*
- laravel/helpers ^1.5 *composer will install it automaticly*

Installation
------------

[](#installation)

You can install the Laravel ModelQuerySelector package via Composer. Run the following command in your terminal:

```
composer require mphpmaster/model-query-selector
```

The package will automatically register its service provider.

Usage
-----

[](#usage)

### Helper Function

[](#helper-function)

You can use the `mqs` helper function to create an instance of `ModelQuerySelector`:

```
use MPhpMaster\ModelQuerySelector\ModelQuerySelector;

// Usage example
$querySelector = mqs(User::class, 'u');
dump($querySelector); // Outputs: "users as u"
```

### Manual Instantiation

[](#manual-instantiation)

You can also manually instantiate `ModelQuerySelector` as follows:

```
use MPhpMaster\ModelQuerySelector\ModelQuerySelector;
use App\Models\User;

// Static method call to qc()
$querySelector = ModelQuerySelector::qc(['column1', 'column2'], User::class);
dump($querySelector); // Outputs: "users.column1, users.column2"

// Static method call to table()
$querySelector = ModelQuerySelector::table(User::class, 'alias');
dump($querySelector); // Outputs: "users as alias"

// Dynamic method call to table()
$querySelector = new ModelQuerySelector();
$querySelector->table(User::class, 'alias');
dump($querySelector); // Outputs: "users as alias"

// Dynamic method call to qc()
$querySelector = new ModelQuerySelector(User::class);
$querySelector->qc(['column1', 'column2'], 'alias');
dump($querySelector); // Outputs: "alias.column1, alias.column2"
```

### `toString` Method

[](#tostring-method)

The `toString` method returns the string representation of the `ModelQuerySelector` instance:

```
use MPhpMaster\ModelQuerySelector\ModelQuerySelector;

$querySelector = mqs(User::class, 'u');
echo $querySelector->toString(); // Outputs: "users as u". same as: `echo trim($querySelector);`
```

License
-------

[](#license)

The Laravel ModelQuerySelector package is open-source software licensed under the [MIT license](https://opensource.org/licenses/MIT).

Contributing
------------

[](#contributing)

Contributions are welcome! Feel free to submit bug reports, feature requests, or pull requests on [GitHub](https://github.com/mPhpMaster/model-query-selector).

Support
-------

[](#support)

For any questions or issues, please [open an issue](https://github.com/mPhpMaster/model-query-selector/issues) on GitHub.

Credits
-------

[](#credits)

This package was created and is maintained by [hlaCk](https://github.com/mPhpMaster).

Acknowledgements
----------------

[](#acknowledgements)

Special thanks to the Laravel community for their continued support and contributions.

---

Stand with Palestine 🇵🇸 *\#FreePalestine*
-----------------------------------------

[](#stand-with-palestine--freepalestine)

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity54

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 ~0 days

Total

5

Last Release

803d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/59211285?v=4)[Moh. Php Master ..](/maintainers/mPhpMaster)[@mPhpMaster](https://github.com/mPhpMaster)

---

Top Contributors

[![mPhpMaster](https://avatars.githubusercontent.com/u/59211285?v=4)](https://github.com/mPhpMaster "mPhpMaster (6 commits)")

---

Tags

laravelutilitysqlqueryselectorcolumn selection

### Embed Badge

![Health badge](/badges/mphpmaster-model-query-selector/health.svg)

```
[![Health](https://phpackages.com/badges/mphpmaster-model-query-selector/health.svg)](https://phpackages.com/packages/mphpmaster-model-query-selector)
```

###  Alternatives

[illuminate/database

The Illuminate Database package.

2.8k54.9M11.5k](/packages/illuminate-database)[anourvalar/eloquent-serialize

Laravel Query Builder (Eloquent) serialization

11223.5M33](/packages/anourvalar-eloquent-serialize)[api-platform/laravel

API Platform support for Laravel

58170.4k13](/packages/api-platform-laravel)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.4k](/packages/tomshaw-electricgrid)[ramadan/easy-model

A Laravel package for enjoyably managing database queries.

111.6k](/packages/ramadan-easy-model)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)