{"id":15034616,"url":"https://github.com/topclaudy/compoships","last_synced_at":"2025-05-14T08:08:49.449Z","repository":{"id":38418922,"uuid":"128057872","full_name":"topclaudy/compoships","owner":"topclaudy","description":"Multi-columns relationships for Laravel's Eloquent ORM","archived":false,"fork":false,"pushed_at":"2024-06-14T13:46:49.000Z","size":257,"stargazers_count":1117,"open_issues_count":29,"forks_count":130,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-10-29T15:36:38.223Z","etag":null,"topics":["composite-keys","eloquent","laravel","multi-columns","multi-keys","relationships"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/topclaudy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://paypal.me/awobaz"]}},"created_at":"2018-04-04T12:18:39.000Z","updated_at":"2024-10-23T08:14:52.000Z","dependencies_parsed_at":"2022-07-09T13:30:36.536Z","dependency_job_id":"94b8b492-144a-44e0-9bf0-963441457157","html_url":"https://github.com/topclaudy/compoships","commit_stats":{"total_commits":167,"total_committers":25,"mean_commits":6.68,"dds":0.7604790419161677,"last_synced_commit":"404901e2ebd6794f70d2710a56edd4b0c500ce1f"},"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/topclaudy%2Fcompoships","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/topclaudy%2Fcompoships/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/topclaudy%2Fcompoships/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/topclaudy%2Fcompoships/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/topclaudy","download_url":"https://codeload.github.com/topclaudy/compoships/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247962605,"owners_count":21024871,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["composite-keys","eloquent","laravel","multi-columns","multi-keys","relationships"],"created_at":"2024-09-24T20:25:42.239Z","updated_at":"2025-04-09T02:17:48.466Z","avatar_url":"https://github.com/topclaudy.png","language":"PHP","funding_links":["https://paypal.me/awobaz","https://paypal.me/awobaz'"],"categories":[],"sub_categories":[],"readme":"Compoships\n==========\n\n**Compoships** offers the ability to specify relationships based on two (or more) columns in Laravel's Eloquent ORM. The need to match multiple columns in the definition of an Eloquent relationship often arises when working with third party or pre existing schema/database. \n\n## The problem\n\nEloquent doesn't support composite keys. As a consequence, there is no way to define a relationship from one model to another by matching more than one column. Trying to use `where clauses` (like in the example below) won't work when eager loading the relationship because at the time the relationship is processed **$this-\u003eteam_id** is null. \n\n```php\nnamespace App;\n\nuse Illuminate\\Database\\Eloquent\\Model;\n\nclass User extends Model\n{\n    public function tasks()\n    {\n        //WON'T WORK WITH EAGER LOADING!!!\n        return $this-\u003ehasMany(Task::class)-\u003ewhere('team_id', $this-\u003eteam_id);\n    }\n}\n```\n\n#### Related discussions:\n\n* [Relationship on multiple keys](https://laracasts.com/discuss/channels/eloquent/relationship-on-multiple-keys)\n* [Querying relations with extra conditions not working as expected](https://github.com/laravel/framework/issues/1272)\n* [Querying relations with extra conditions in Eager Loading not working](https://github.com/laravel/framework/issues/19488)\n* [BelongsTo relationship with 2 foreign keys](https://laravel.io/forum/08-02-2014-belongsto-relationship-with-2-foreign-keys)\n* [Laravel Eloquent: multiple foreign keys for relationship](https://stackoverflow.com/questions/48077890/laravel-eloquent-multiple-foreign-keys-for-relationship/49834070#49834070)\n* [Laravel hasMany association with multiple columns](https://stackoverflow.com/questions/32471084/laravel-hasmany-association-with-multiple-columns)\n\n## Installation\n\nThe recommended way to install **Compoships** is through [Composer](http://getcomposer.org/)\n\n```bash\n$ composer require awobaz/compoships\n```\n## Usage\n\n### Using the `Awobaz\\Compoships\\Database\\Eloquent\\Model` class\n\nSimply make your model class derive from the `Awobaz\\Compoships\\Database\\Eloquent\\Model` base class. The `Awobaz\\Compoships\\Database\\Eloquent\\Model` extends the `Eloquent` base class without changing its core functionality.\n\n### Using the `Awobaz\\Compoships\\Compoships` trait\n\nIf for some reason you can't derive your models from `Awobaz\\Compoships\\Database\\Eloquent\\Model`, you may take advantage of the `Awobaz\\Compoships\\Compoships` trait. Simply use the trait in your models.\n \n**Note:** To define a multi-columns relationship from a model *A* to another model *B*, **both models must either extend `Awobaz\\Compoships\\Database\\Eloquent\\Model` or use the `Awobaz\\Compoships\\Compoships` trait**\n\n### Syntax\n\n... and now we can define a relationship from a model *A* to another model *B* by matching two or more columns (by passing an array of columns instead of a string). \n\n```php\nnamespace App;\n\nuse Illuminate\\Database\\Eloquent\\Model;\n\nclass A extends Model\n{\n    use \\Awobaz\\Compoships\\Compoships;\n    \n    public function b()\n    {\n        return $this-\u003ehasMany('B', ['foreignKey1', 'foreignKey2'], ['localKey1', 'localKey2']);\n    }\n}\n```\n\nWe can use the same syntax to define the inverse of the relationship:\n\n```php\nnamespace App;\n\nuse Illuminate\\Database\\Eloquent\\Model;\n\nclass B extends Model\n{\n    use \\Awobaz\\Compoships\\Compoships;\n    \n    public function a()\n    {\n        return $this-\u003ebelongsTo('A', ['foreignKey1', 'foreignKey2'], ['ownerKey1', 'ownerKey2']);\n    }\n}\n```\n\n### Factories\n\nChances are that you may need factories for your Compoships models. If so, you will probably need to use\nFactory methods to create relationship models. For example, by using the -\u003ehas() method. Just use the\n``Awobaz\\Compoships\\Database\\Eloquent\\Factories\\ComposhipsFactory`` trait in your factory classes to be able\nto use relationships correctly.\n\n### Example\n\nAs an example, let's pretend we have a task list with categories, managed by several teams of users where:\n* a task belongs to a category\n* a task is assigned to a team\n* a team has many users\n* a user belongs to one team\n* a user is responsible for one category of tasks\n\nThe user responsible for a particular task is the user _currently_ in charge for the category inside the team.\n\n```php\nnamespace App;\n\nuse Illuminate\\Database\\Eloquent\\Model;\n\nclass User extends Model\n{\n    use \\Awobaz\\Compoships\\Compoships;\n    \n    public function tasks()\n    {\n        return $this-\u003ehasMany(Task::class, ['team_id', 'category_id'], ['team_id', 'category_id']);\n    }\n}\n```\n\nAgain, same syntax to define the inverse of the relationship:\n\n```php\nnamespace App;\n\nuse Illuminate\\Database\\Eloquent\\Model;\n\nclass Task extends Model\n{\n    use \\Awobaz\\Compoships\\Compoships;\n    \n    public function user()\n    {\n        return $this-\u003ebelongsTo(User::class, ['team_id', 'category_id'], ['team_id', 'category_id']);\n    }\n}\n```\n## Supported relationships\n\n**Compoships** only supports the following Laravel's Eloquent relationships:\n\n* hasOne\n* HasMany\n* belongsTo\n\nAlso please note that while **nullable columns are supported by Compoships**, relationships with only null values are not currently possible.\n\n## Support for nullable columns in 2.x\n\nVersion 2.x brings support for nullable columns. The results may now be different than on version 1.x when a column is null on a relationship, so we bumped the version to 2.x, as this might be a breaking change.\n\n## Disclaimer\n\n**Compoships** doesn't bring support for composite keys in Laravel's Eloquent. This package only offers the ability to specify relationships based on more than one column. In a Laravel project, it's recommended for all models' tables to have a single primary key. But there are situations where you'll need to match many columns in the definition of a relationship even when your models' tables have a single primary key.\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](https://github.com/topclaudy/compoships/blob/master/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests.\n\n\n[![](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/images/0)](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/links/0)\n[![](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/images/1)](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/links/1)\n[![](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/images/2)](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/links/2)\n[![](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/images/3)](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/links/3)\n[![](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/images/4)](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/links/4)\n[![](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/images/5)](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/links/5)\n[![](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/images/6)](https://sourcerer.io/fame/topclaudy/topclaudy/compoships/links/6)\n\n\n## Versioning\n\nWe use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/topclaudy/compoships/tags).\n\n## Unit Tests\n\nTo run unit tests you have to use PHPUnit\n\nInstall compoships repository\n```bash\ngit clone https://github.com/topclaudy/compoships.git\ncd compoships\ncomposer install\n```\nRun PHPUnit\n```bash\n./vendor/bin/phpunit\n```\n\n## Authors\n\n* [Claudin J. Daniel](https://github.com/topclaudy) - *Initial work*\n\n## Support This Project\n\n\u003ca href='https://paypal.me/awobaz' target='_blank'\u003e\u003cimg height='35' style='border:0px;height:46px;' src='https://az743702.vo.msecnd.net/cdn/kofi3.png?v=0' border='0' alt='Buy Me a Coffee via Paypal' /\u003e\n\n## License\n\n**Compoships** is licensed under the [MIT License](http://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftopclaudy%2Fcompoships","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftopclaudy%2Fcompoships","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftopclaudy%2Fcompoships/lists"}