Repository is archived
No commit activity in last 3 years
No release in over 3 years
Exposes a PHP Session (read-only) to Rack applications
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0

Runtime

 Project Readme

rack-php-session

Exposes a PHP session (read-only) to Rack applications

Installation

  gem install rack-php-session

Dependencies

Usage

In a Rack environment:

  require 'rack/php-session'
  use Rack::PHPSession

  run app

In your application

  env['php.session'] => { } # Returns a Hash of the PHP Session contents

In a Rails environment add in 'config/environment.rb' the following:

  config.middleware.use Rack::PHPSession

Limitations

  • The PHP session is currently read-only.
  • The Rack application must be able to read PHP session files. In PHP configurations that utilize suPHP, this is trivial as session files are stored as the current user. Standard mod_php configurations may result in permission problems.
  • The PHP Session ID must be known -- this is generally stored in a cookie so the Rack application must run on the same domain as the PHP application (easily achievable using Passenger or a Proxy method).

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

Copyright

Copyright (c) 2010 Adam Daniels. See LICENSE for details.