counter_culture
為您的 Rails 應用程式提供增壓版計數快取。
counter_culture 是什麼?
為您的 Rails 應用程式提供增壓版計數快取。。注意:原文 summary 與 tagline 相同,但根據要求保留原意。
counter_culture 概覽
這是什麼
counter_culture 是一個 Ruby gem,為 Rails 應用程式提供高效能的計數快取(counter cache)。它改進了 Rails 標準的計數快取:當值變更時更新快取(不僅在建立或刪除時)、支援多層關聯的計數快取、動態欄位名稱、以及執行計數或總和。此 gem 已在 Ruby 3.0 至 4.0 以及 Rails 6.0 至 8.1 上測試。與 Rails 內建的計數快取不同,counter_culture 不會改變 ActiveRecord 關聯中 .size 方法的行為;若要讀取快取值而不進行資料庫查詢,請直接使用包含計數快取的屬性名稱(例如 product.categories_count 而非 product.categories.size)。
主要功能
- 當值變更時更新計數快取,不僅限於建立或刪除記錄時。
- 支援多層關聯的計數快取(例如透過子類別到類別)。
- 支援動態欄位名稱,可為不同類型的物件拆分計數快取。
- 可執行計數或總和(使用
:delta_column選項)。 - 支援條件式計數快取(例如僅計算符合條件的記錄)。
- 可透過
Review.skip_counter_culture_updates暫時跳過計數快取更新。 - 支援 delta 幅度(靜態或動態乘數)來改變計數值。
使用情境
counter_culture 用於需要跨複雜關聯保持準確、即時計數快取的 Rails 應用程式。常見使用情境包括:
- 在類別中保持產品計數,並在產品類別變更時更新。
- 透過中介資料表(多對多)維護群組中的成員計數。
- 在父模型中追蹤執行總和(例如產品重量總和)。
- 根據動態屬性拆分計數快取(例如僅分別計算「很棒」的產品)。
- 更新多層階層中的計數(例如子類別和類別)。
快速開始
將 counter_culture 加入 Gemfile:rubygem 'counter_culture', '~> 3.2'然後執行 bundle install。使用產生器建立必要的欄位:rails generate counter_culture Category products_count這會產生類似以下的遷移:rubyadd_column :categories, :products_count, :integer, null: false, default: 0注意:欄位必須為 NOT NULL 且預設值為零。
授權與價格
counter_culture 採用 MIT 授權條款。它是開放原始碼且免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。