tishotm/eloquent-ci-relations

Eloquent case-insensitive relations

v1.3.0 2023-10-11 03:09 UTC

README

Build Status Version Total Downloads License

Using Eloquent out of the box on case-insensitive collation databases could potentially return incomplete collection of items if the foreign keys are set as strings and they differ in terms of uppercase vs lowercase. On eager loaded relations Eloquent builds a dictionary of the parent models and associates their related models by their keys. PHP is case-sensitive and therefore if the keys are different, then some of the related models will not be returned. This package simply normalizes the dictionary keys into lowercase.

Example:

Items table

uuid name
aaa First
bbb Second
ccc Third

Tags table

id label
1 tag 1
2 tag 2
3 tag 3

item_tag table

item_uuid tag_id
AAA 1
aaa 2
bbb 3

Item::with('tags')->find('aaa');

The related tags would include only the "tag 2" even if the the DB collation is case-insensitive and the returned query data includes "tag 1".

With case insensitive relations: The related tags would include both "tag 1" and "tag 2".

Requirements

  • illuminate/database 5.5.33 and up, 5.6.*, 5.7.*, 5.8.*, 6.20.26 and up, 7.30.4, 8.40.0 an up

Installation

composer require tishotm/eloquent-ci-relations

Usage

use Illuminate\Database\Eloquent\Model;

class Item extends Model
{
    use \TishoTM\Eloquent\Concerns\HasCiRelationships;

    // ... relations
}

License

MIT license.