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

Returns a new instance of 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

#apps ⇒ Object (readonly)

Returns the value of attribute apps.



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

def apps
  @apps
end

#dirs ⇒ Object

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

Returns:

  • (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

#scan ⇒ Object 



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