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.
Eloquent 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->team_id is null.
namespace App;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
public function tasks()
{
//WON'T WORK WITH EAGER LOADING!!!
return $this->hasMany(Task::class)->where('team_id', $this->team_id);
}
}
The recommended way to install Compoships is through Composer
$ composer require awobaz/compoships
Awobaz\Compoships\Database\Eloquent\Model
classSimply 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.
Awobaz\Compoships\Compoships
traitIf for some reasons 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.
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
... 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).
namespace App;
use Illuminate\Database\Eloquent\Model;
class A extends Model
{
use \Awobaz\Compoships\Compoships;
public function b()
{
return $this->hasMany('B', ['foreignKey1', 'foreignKey2'], ['localKey1', 'localKey2']);
}
}
We can use the same syntax to define the inverse of the relationship:
namespace App;
use Illuminate\Database\Eloquent\Model;
class B extends Model
{
use \Awobaz\Compoships\Compoships;
public function a()
{
return $this->belongsTo('A', ['foreignKey1', 'foreignKey2'], ['localKey1', 'localKey2']);
}
}
As an example, let's pretend we have a task list with categories, managed by several teams of users where:
The user responsible for a particular task is the user currently in charge for the category inside the team.
namespace App;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
use \Awobaz\Compoships\Compoships;
public function tasks()
{
return $this->hasMany(Task::class, ['team_id', 'category_id'], ['team_id', 'category_id']);
}
}
Again, same syntax to define the inverse of the relationship:
namespace App;
use Illuminate\Database\Eloquent\Model;
class Task extends Model
{
use \Awobaz\Compoships\Compoships;
public function user()
{
return $this->belongsTo(User::class, ['team_id', 'category_id'], ['team_id', 'category_id']);
}
}
Compoships only supports the following Laravel's Eloquent relationships:
Also please note that while nullable columns are supported by Compoships, relationships with only null values are not currently possible.
Version 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.
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.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests.
We use SemVer for versioning. For the versions available, see the tags on this repository.
To run unit tests you have to obtain manually proper version of PHPUnit
Example
wget -O phpunit https://phar.phpunit.de/phpunit-8.phar
chmod +x phpunit
./phpunit
Compoships is licensed under the MIT License.