ruby-debug-passenger

Warning: This project is no longer maintained and may not work any more.

Background

I wanted to use Phusion Passenger as an Apache module (not standalone) but still be able to use the interactive Ruby debugger.

Thanks to Adam Meehan I was able to do that, and I decided to make it into a reusable Gem.

Requirements

• Ruby on Rails 3.0+
• Ruby 1.9+ (untested on 1.8 but it may work)
• Ruby Debug / Debugger / Byebug
• Phusion Passenger

Installation

Add this to your Gemfile if you are on Ruby 2.0:

gem "byebug"
gem "ruby-debug-passenger"

Or this if you are on Ruby 1.9:

gem "debugger"
gem "ruby-debug-passenger"

Or this if you are on Ruby 1.8 (but it hasn't been tested!):

gem "ruby-debug"
gem "ruby-debug-passenger"

Then run bundle install to install it.

Usage

Add debugger (Ruby 1.9 or lower) or byebug (Ruby 2.0+) anywhere in your Ruby code that you want to invoke the debugger. Or in an ERB template add <% debugger %> or <% byebug %> instead.

Run rake debug to restart Phusion Passenger and connect to the debugger. (You will be prompted to reload the app in your browser.)

Recommended reading

• ruby-debug documentation
• RailsCast #54, or the revised version if you're a Pro subscriber.

Changelog

0.2.0

• Support for byebug gem (David Rodríguez) - #2

0.1.0

• Support for debugger gem (Kai Middleton) - #1

0.0.1

• Initial release

License

MIT License - see LICENSE.txt.