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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/magnusvkcounter-culture.svg)](https://yunodb.com/tools/magnusvkcounter-culture?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/magnusvkcounter-culture?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/magnusvkcounter-culture.svg" alt="Featured on YunoDB" height="20"></a>