最近在開發一個 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 IlluminateDatabaseEloquentModel;<br>use TishoTMEloquentConcernsHasCiRelationships;</p><p>class Item extends Model<br>{</p><pre class="brush:php;toolbar:false">use HasCiRelationships; // ... your model code ...
}
這樣，Eloquent 就會在構建關聯關系時，自動將鍵值轉換為小寫，從而避免大小寫不匹配導致的數據丟失問題。
例如，在我的項目中，使用了這個包之后，Item::with(‘tags’)->find(‘aaa’) 就能正確地返回所有關聯的標簽數據，包括 item_uuid 為 AAA 的記錄。
這個包不僅解決了我的問題，還極大地提升了代碼的可讀性和可維護性。它輕量級、易于使用，并且不會對現有代碼產生大的影響。 對于那些使用區分大小寫數據庫的 Laravel 項目，強烈推薦使用這個包來避免潛在的數據丟失問題。
總而言之，tishotm/eloquent-ci-relations 是一個非常實用的 Composer 包，它能夠有效地解決 Eloquent 關聯查詢中因大小寫問題導致的數據丟失問題，提高開發效率，確保數據完整性。 希望這篇文章能夠幫助到遇到類似問題的開發者們。
