Class: ThinkingSphinx::Configuration
- Inherits:
-
Object
- Object
- ThinkingSphinx::Configuration
- Includes:
- Singleton
- Defined in:
- lib/thinking_sphinx/configuration.rb
Overview
This class both keeps track of the configuration settings for Sphinx and also generates the resulting file for Sphinx to use.
Here are the default settings, relative to RAILS_ROOT where relevant:
- config file
-
config/#Configuration.environment.sphinx.conf
- searchd log file
-
log/searchd.log
- query log file
-
log/searchd.query.log
- pid file
-
log/searchd.#Configuration.environment.pid
- searchd files
-
db/sphinx/#Configuration.environment/
- address
-
127.0.0.1
- port
-
9312
- allow star
-
false
- min prefix length
-
1
- min infix length
-
1
- mem limit
-
64M
- max matches
-
1000
- morphology
-
nil
- charset type
-
utf-8
- charset table
-
nil
- ignore chars
-
nil
- html strip
-
false
- html remove elements
-
”
- searchd_binary_name
-
searchd
- indexer_binary_name
-
indexer
If you want to change these settings, create a YAML file at config/sphinx.yml with settings for each environment, in a similar fashion to database.yml - using the following keys: config_file, searchd_log_file, query_log_file, pid_file, searchd_file_path, port, allow_star, enable_star, min_prefix_len, min_infix_len, mem_limit, max_matches, morphology, charset_type, charset_table, ignore_chars, html_strip, html_remove_elements, delayed_job_priority, searchd_binary_name, indexer_binary_name.
I think you’ve got the idea.
Each setting in the YAML file is optional - so only put in the ones you want to change.
Keep in mind, if for some particular reason you’re using a version of Sphinx older than 0.9.8 r871 (that’s prior to the proper 0.9.8 release), don’t set allow_star to true.
Constant Summary collapse
- SourceOptions =
%w( mysql_connect_flags mysql_ssl_cert mysql_ssl_key mysql_ssl_ca sql_range_step sql_query_pre sql_query_post sql_query_killlist sql_ranged_throttle sql_query_post_index unpack_zlib unpack_mysqlcompress unpack_mysqlcompress_maxsize )
- IndexOptions =
%w( charset_table charset_type charset_dictpath docinfo enable_star exceptions html_index_attrs html_remove_elements html_strip index_exact_words ignore_chars inplace_docinfo_gap inplace_enable inplace_hit_gap inplace_reloc_factor inplace_write_factor min_infix_len min_prefix_len min_stemming_len min_word_len mlock morphology ngram_chars ngram_len ondisk_dict overshort_step phrase_boundary phrase_boundary_step preopen stopwords stopwords_step wordforms )
- CustomOptions =
%w( disable_range )
Instance Attribute Summary collapse
-
#allow_star ⇒ Object
Returns the value of attribute allow_star.
-
#app_root ⇒ Object
Returns the value of attribute app_root.
-
#configuration ⇒ Object
readonly
Returns the value of attribute configuration.
-
#controller ⇒ Object
readonly
Returns the value of attribute controller.
-
#database_yml_file ⇒ Object
Returns the value of attribute database_yml_file.
-
#delayed_job_priority ⇒ Object
Returns the value of attribute delayed_job_priority.
-
#environment ⇒ Object
readonly
Returns the value of attribute environment.
-
#index_options ⇒ Object
Returns the value of attribute index_options.
-
#model_directories ⇒ Object
Returns the value of attribute model_directories.
-
#searchd_file_path ⇒ Object
Returns the value of attribute searchd_file_path.
-
#source_options ⇒ Object
Returns the value of attribute source_options.
Class Method Summary collapse
Instance Method Summary collapse
- #address ⇒ Object
- #address=(address) ⇒ Object
- #bin_path ⇒ Object
- #bin_path=(path) ⇒ Object
-
#build(file_path = nil) ⇒ Object
Generate the config file for Sphinx by using all the settings defined and looping through all the models with indexes to build the relevant indexer and searchd configuration, and sources and indexes details.
- #client ⇒ Object
- #config_file ⇒ Object
- #config_file=(file) ⇒ Object
- #indexer_binary_name ⇒ Object
- #indexer_binary_name=(name) ⇒ Object
-
#initialize(app_root = Dir.pwd) ⇒ Configuration
constructor
Load in the configuration settings - this will look for config/sphinx.yml and parse it according to the current environment.
- #models_by_crc ⇒ Object
- #pid_file ⇒ Object
- #pid_file=(pid_file) ⇒ Object
- #port ⇒ Object
- #port=(port) ⇒ Object
- #query_log_file ⇒ Object
- #query_log_file=(file) ⇒ Object
- #reset(custom_app_root = nil) ⇒ Object
- #searchd_binary_name ⇒ Object
- #searchd_binary_name=(name) ⇒ Object
- #searchd_log_file ⇒ Object
- #searchd_log_file=(file) ⇒ Object
Constructor Details
#initialize(app_root = Dir.pwd) ⇒ Configuration
Load in the configuration settings - this will look for config/sphinx.yml and parse it according to the current environment.
77 78 79 |
# File 'lib/thinking_sphinx/configuration.rb', line 77 def initialize(app_root = Dir.pwd) self.reset end |
Instance Attribute Details
#allow_star ⇒ Object
Returns the value of attribute allow_star.
67 68 69 |
# File 'lib/thinking_sphinx/configuration.rb', line 67 def allow_star @allow_star end |
#app_root ⇒ Object
Returns the value of attribute app_root.
67 68 69 |
# File 'lib/thinking_sphinx/configuration.rb', line 67 def app_root @app_root end |
#configuration ⇒ Object (readonly)
Returns the value of attribute configuration.
72 73 74 |
# File 'lib/thinking_sphinx/configuration.rb', line 72 def configuration @configuration end |
#controller ⇒ Object (readonly)
Returns the value of attribute controller.
72 73 74 |
# File 'lib/thinking_sphinx/configuration.rb', line 72 def controller @controller end |
#database_yml_file ⇒ Object
Returns the value of attribute database_yml_file.
67 68 69 |
# File 'lib/thinking_sphinx/configuration.rb', line 67 def database_yml_file @database_yml_file end |
#delayed_job_priority ⇒ Object
Returns the value of attribute delayed_job_priority.
67 68 69 |
# File 'lib/thinking_sphinx/configuration.rb', line 67 def delayed_job_priority @delayed_job_priority end |
#environment ⇒ Object (readonly)
Returns the value of attribute environment.
72 73 74 |
# File 'lib/thinking_sphinx/configuration.rb', line 72 def environment @environment end |
#index_options ⇒ Object
Returns the value of attribute index_options.
70 71 72 |
# File 'lib/thinking_sphinx/configuration.rb', line 70 def @index_options end |
#model_directories ⇒ Object
Returns the value of attribute model_directories.
67 68 69 |
# File 'lib/thinking_sphinx/configuration.rb', line 67 def model_directories @model_directories end |
#searchd_file_path ⇒ Object
Returns the value of attribute searchd_file_path.
67 68 69 |
# File 'lib/thinking_sphinx/configuration.rb', line 67 def searchd_file_path @searchd_file_path end |
#source_options ⇒ Object
Returns the value of attribute source_options.
70 71 72 |
# File 'lib/thinking_sphinx/configuration.rb', line 70 def @source_options end |
Class Method Details
.configure {|instance| ... } ⇒ Object
81 82 83 84 |
# File 'lib/thinking_sphinx/configuration.rb', line 81 def self.configure(&block) yield instance instance.reset(instance.app_root) end |
.environment ⇒ Object
122 123 124 125 126 |
# File 'lib/thinking_sphinx/configuration.rb', line 122 def self.environment Thread.current[:thinking_sphinx_environment] ||= ( defined?(Merb) ? Merb.environment : ENV['RAILS_ENV'] ) || "development" end |
Instance Method Details
#address ⇒ Object
152 153 154 |
# File 'lib/thinking_sphinx/configuration.rb', line 152 def address @configuration.searchd.address end |
#address=(address) ⇒ Object
156 157 158 |
# File 'lib/thinking_sphinx/configuration.rb', line 156 def address=(address) @configuration.searchd.address = address end |
#bin_path ⇒ Object
200 201 202 |
# File 'lib/thinking_sphinx/configuration.rb', line 200 def bin_path @controller.bin_path end |
#bin_path=(path) ⇒ Object
204 205 206 |
# File 'lib/thinking_sphinx/configuration.rb', line 204 def bin_path=(path) @controller.bin_path = path end |
#build(file_path = nil) ⇒ Object
Generate the config file for Sphinx by using all the settings defined and looping through all the models with indexes to build the relevant indexer and searchd configuration, and sources and indexes details.
136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 |
# File 'lib/thinking_sphinx/configuration.rb', line 136 def build(file_path=nil) file_path ||= "#{self.config_file}" @configuration.indexes.clear ThinkingSphinx.context.indexed_models.each do |model| model = model.constantize model.define_indexes @configuration.indexes.concat model.to_riddle end open(file_path, "w") do |file| file.write @configuration.render end end |
#client ⇒ Object
224 225 226 227 228 |
# File 'lib/thinking_sphinx/configuration.rb', line 224 def client client = Riddle::Client.new address, port client.max_matches = configuration.searchd.max_matches || 1000 client end |
#config_file ⇒ Object
192 193 194 |
# File 'lib/thinking_sphinx/configuration.rb', line 192 def config_file @controller.path end |
#config_file=(file) ⇒ Object
196 197 198 |
# File 'lib/thinking_sphinx/configuration.rb', line 196 def config_file=(file) @controller.path = file end |
#indexer_binary_name ⇒ Object
216 217 218 |
# File 'lib/thinking_sphinx/configuration.rb', line 216 def indexer_binary_name @controller.indexer_binary_name end |
#indexer_binary_name=(name) ⇒ Object
220 221 222 |
# File 'lib/thinking_sphinx/configuration.rb', line 220 def indexer_binary_name=(name) @controller.indexer_binary_name = name end |
#models_by_crc ⇒ Object
230 231 232 233 234 235 236 237 238 239 240 |
# File 'lib/thinking_sphinx/configuration.rb', line 230 def models_by_crc @models_by_crc ||= begin ThinkingSphinx.context.indexed_models.inject({}) do |hash, model| hash[model.constantize.to_crc32] = model Object.subclasses_of(model.constantize).each { |subclass| hash[subclass.to_crc32] = subclass.name } hash end end end |
#pid_file ⇒ Object
168 169 170 |
# File 'lib/thinking_sphinx/configuration.rb', line 168 def pid_file @configuration.searchd.pid_file end |
#pid_file=(pid_file) ⇒ Object
172 173 174 |
# File 'lib/thinking_sphinx/configuration.rb', line 172 def pid_file=(pid_file) @configuration.searchd.pid_file = pid_file end |
#port ⇒ Object
160 161 162 |
# File 'lib/thinking_sphinx/configuration.rb', line 160 def port @configuration.searchd.port end |
#port=(port) ⇒ Object
164 165 166 |
# File 'lib/thinking_sphinx/configuration.rb', line 164 def port=(port) @configuration.searchd.port = port end |
#query_log_file ⇒ Object
184 185 186 |
# File 'lib/thinking_sphinx/configuration.rb', line 184 def query_log_file @configuration.searchd.query_log end |
#query_log_file=(file) ⇒ Object
188 189 190 |
# File 'lib/thinking_sphinx/configuration.rb', line 188 def query_log_file=(file) @configuration.searchd.query_log = file end |
#reset(custom_app_root = nil) ⇒ Object
86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 |
# File 'lib/thinking_sphinx/configuration.rb', line 86 def reset(custom_app_root=nil) if custom_app_root self.app_root = custom_app_root else self.app_root = RAILS_ROOT if defined?(RAILS_ROOT) self.app_root = Merb.root if defined?(Merb) self.app_root ||= app_root end @configuration = Riddle::Configuration.new @configuration.searchd.address = "127.0.0.1" @configuration.searchd.port = 9312 @configuration.searchd.pid_file = "#{self.app_root}/log/searchd.#{environment}.pid" @configuration.searchd.log = "#{self.app_root}/log/searchd.log" @configuration.searchd.query_log = "#{self.app_root}/log/searchd.query.log" @controller = Riddle::Controller.new @configuration, "#{self.app_root}/config/#{environment}.sphinx.conf" self.database_yml_file = "#{self.app_root}/config/database.yml" self.searchd_file_path = "#{self.app_root}/db/sphinx/#{environment}" self.allow_star = false self.model_directories = ["#{app_root}/app/models/"] + Dir.glob("#{app_root}/vendor/plugins/*/app/models/") self.delayed_job_priority = 0 self. = {} self. = { :charset_type => "utf-8" } parse_config self end |
#searchd_binary_name ⇒ Object
208 209 210 |
# File 'lib/thinking_sphinx/configuration.rb', line 208 def searchd_binary_name @controller.searchd_binary_name end |
#searchd_binary_name=(name) ⇒ Object
212 213 214 |
# File 'lib/thinking_sphinx/configuration.rb', line 212 def searchd_binary_name=(name) @controller.searchd_binary_name = name end |
#searchd_log_file ⇒ Object
176 177 178 |
# File 'lib/thinking_sphinx/configuration.rb', line 176 def searchd_log_file @configuration.searchd.log end |
#searchd_log_file=(file) ⇒ Object
180 181 182 |
# File 'lib/thinking_sphinx/configuration.rb', line 180 def searchd_log_file=(file) @configuration.searchd.log = file end |