最近在开发一个 laravel 项目时，遇到了一个令人头疼的 bug。我的数据库使用了区分大小写的字符集，而 item_tag 表中的 item_uuid 字段存储的是字符串类型的 uuid。 item 模型和 tag 模型之间存在多对多关系。当我使用 item::with('tags')->find('aaa') 进行关联查询时，只返回了部分关联的标签数据。这是因为数据库虽然不区分大小写，但 eloquent 在构建关联关系时，默认使用 php 的大小写敏感特性来匹配键值，导致 aaa 和 aaa 被认为是不同的键，从而丢失了部分数据。
我尝试了多种方法，例如修改数据库字符集、修改模型代码等，但效果都不理想，并且修改数据库字符集可能会影响其他部分的功能。在一番搜索后，我找到了 tishotm/eloquent-ci-relations 这个 Composer 包，它完美地解决了我的问题。
安装这个包非常简单，只需要在你的 Laravel 项目中运行以下命令：
composer require tishotm/eloquent-ci-relations
安装完成后，只需要在你的 Eloquent 模型中使用 HasCiRelationships trait 即可：
use Illuminate\Database\Eloquent\Model;
use TishoTM\Eloquent\Concerns\HasCiRelationships;class Item extends Model
{use HasCiRelationships; // ... your model code ...}
这样，Eloquent 就会在构建关联关系时，自动将键值转换为小写，从而避免大小写不匹配导致的数据丢失问题。
例如，在我的项目中，使用了这个包之后，
Item::with('tags')->find('aaa')就能正确地返回所有关联的标签数据，包括item_uuid为AAA的记录。这个包不仅解决了我的问题，还极大地提升了代码的可读性和可维护性。它轻量级、易于使用，并且不会对现有代码产生大的影响。 对于那些使用区分大小写数据库的 Laravel 项目，强烈推荐使用这个包来避免潜在的数据丢失问题。
总而言之，
tishotm/eloquent-ci-relations是一个非常实用的 Composer 包，它能够有效地解决 Eloquent 关联查询中因大小写问题导致的数据丢失问题，提高开发效率，确保数据完整性。 希望这篇文章能够帮助到遇到类似问题的开发者们。
