Class: PhusionPassenger::Standalone::AppFinder

Inherits:
Object
  • Object
show all
Defined in:
lib/phusion_passenger/standalone/app_finder.rb

Overview

Security note: can run arbitrary ruby code by evaluating passenger.conf

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(dirs, options = {}) ⇒ AppFinder



39
40
41
42
# File 'lib/phusion_passenger/standalone/app_finder.rb', line 39

def initialize(dirs, options = {})
  @dirs = dirs
  @options = options
end

Instance Attribute Details

#appsObject (readonly)

Returns the value of attribute apps.



31
32
33
# File 'lib/phusion_passenger/standalone/app_finder.rb', line 31

def apps
  @apps
end

#dirsObject

Returns the value of attribute dirs.



30
31
32
# File 'lib/phusion_passenger/standalone/app_finder.rb', line 30

def dirs
  @dirs
end

Class Method Details

.looks_like_app_directory?(dir) ⇒ Boolean



33
34
35
36
37
# File 'lib/phusion_passenger/standalone/app_finder.rb', line 33

def self.looks_like_app_directory?(dir)
  return File.exist?("#{dir}/config.ru") ||
    File.exist?("#{dir}/config/environment.rb") ||
    File.exist?("#{dir}/passenger_wsgi.py")
end

Instance Method Details

#monitor(termination_pipe) ⇒ Object



77
78
79
80
81
82
83
84
85
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
# File 'lib/phusion_passenger/standalone/app_finder.rb', line 77

def monitor(termination_pipe)
  raise "You must call #scan first" if !@apps
  
  watcher = PhusionPassenger::Utils::FileSystemWatcher.new(@watchlist, termination_pipe)
  if wait_on_io(termination_pipe, 3)
    return
  end
  
  while true
    changed = watcher.wait_for_change
    watcher.close
    if changed
      old_apps = @apps
      # The change could be caused by a write to some passenger.conf file.
      # Wait for a short period so that the write has a chance to finish.
      if wait_on_io(termination_pipe, 0.25)
        return
      end
      
      new_apps = scan
      watcher = PhusionPassenger::Utils::FileSystemWatcher.new(@watchlist, termination_pipe)
      if old_apps != new_apps
        yield(new_apps)
      end
      
      # Don't process change events again for a short while,
      # but do detect changes while waiting.
      if wait_on_io(termination_pipe, 3)
        return
      end
    else
      return
    end
  end
ensure
  watcher.close if watcher
end

#scanObject



44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
# File 'lib/phusion_passenger/standalone/app_finder.rb', line 44

def scan
  apps = []
  watchlist = []
  
  app_root = find_app_root
  apps << {
    :server_names => ["_"],
    :root => app_root
  }
  watchlist << app_root
  watchlist << "#{app_root}/config" if File.exist?("#{app_root}/config")
  watchlist << "#{app_root}/passenger.conf" if File.exist?("#{app_root}/passenger.conf")
  
  apps.sort! do |a, b|
    a[:root] <=> b[:root]
  end
  apps.map! do |app|
    config_filename = File.join(app[:root], "passenger.conf")
    if File.exist?(config_filename)
      local_options = load_config_file(:local_config, config_filename)
      merged_options = @options.merge(app)
      merged_options.merge!(local_options)
      merged_options
    else
      @options.merge(app)
    end
  end
  
  @apps = apps
  @watchlist = watchlist
  return apps
end