phprpc 3.0.0

data/lib/phprpc/server.rb

@@ -0,0 +1,55 @@
+############################################################
+#                                                          #
+# The implementation of PHPRPC Protocol 3.0                #
+#                                                          #
+# server.rb                                                #
+#                                                          #
+# Release 3.0.0                                            #
+# Copyright (c) 2005-2008 by Team-PHPRPC                   #
+#                                                          #
+# WebSite:  http://www.phprpc.org/                         #
+#           http://www.phprpc.net/                         #
+#           http://www.phprpc.com/                         #
+#           http://sourceforge.net/projects/php-rpc/       #
+#                                                          #
+# Authors:  Ma Bingyao <andot@ujn.edu.cn>                  #
+#                                                          #
+# This file may be distributed and/or modified under the   #
+# terms of the GNU Lesser General Public License (LGPL)    #
+# version 3.0 as published by the Free Software Foundation #
+# and appearing in the included file LICENSE.              #
+#                                                          #
+############################################################
+#
+# PHPRPC Server library.
+#
+# Copyright (C) 2005-2008 Ma Bingyao <andot@ujn.edu.cn>
+# Version: 3.0
+# LastModified: Sep 13, 2008
+# This library is free.  You can redistribute it and/or modify it.
+
+module PHPRPC
+
+  autoload :CGIServer, 'phprpc/cgi_server'
+  autoload :MongrelServer, 'phprpc/mongrel_server'
+  autoload :ThinServer, 'phprpc/thin_server'
+  autoload :FCGIServer, 'phprpc/fcgi_server'
+  autoload :SCGIServer, 'phprpc/scgi_server'
+  autoload :LSAPIServer, 'phprpc/lsapi_server'
+  autoload :EbbServer, 'phprpc/ebb_server'
+  autoload :WEBrickServer, 'phprpc/webrick_server'
+  autoload :FakeServer, 'phprpc/fake_server'
+  
+  ARGV[0] = '' if ARGV[0].nil? 
+  Server = case ARGV[0].downcase
+  when 'mongrel' then MongrelServer
+  when 'thin' then ThinServer
+  when 'fcgi' then FCGIServer
+  when 'scgi' then SCGIServer
+  when 'lsapi' then LSAPIServer
+  when 'ebb' then EbbServer
+  when 'webrick' then WEBrickServer
+  else (ENV['GATEWAY_INTERFACE'] =~ /CGI\/\d.\d/ ? CGIServer : FakeServer) 
+  end # class Server
+  
+end # module PHPRPC

data/lib/phprpc/thin_server.rb

@@ -0,0 +1,161 @@
+############################################################
+#                                                          #
+# The implementation of PHPRPC Protocol 3.0                #
+#                                                          #
+# thin_server.rb                                           #
+#                                                          #
+# Release 3.0.0                                            #
+# Copyright (c) 2005-2008 by Team-PHPRPC                   #
+#                                                          #
+# WebSite:  http://www.phprpc.org/                         #
+#           http://www.phprpc.net/                         #
+#           http://www.phprpc.com/                         #
+#           http://sourceforge.net/projects/php-rpc/       #
+#                                                          #
+# Authors:  Ma Bingyao <andot@ujn.edu.cn>                  #
+#                                                          #
+# This file may be distributed and/or modified under the   #
+# terms of the GNU Lesser General Public License (LGPL)    #
+# version 3.0 as published by the Free Software Foundation #
+# and appearing in the included file LICENSE.              #
+#                                                          #
+############################################################
+#
+# PHPRPC ThinServer library.
+#
+# Copyright (C) 2005-2008 Ma Bingyao <andot@ujn.edu.cn>
+# Version: 3.0
+# LastModified: Sep 14, 2008
+# This library is free.  You can redistribute it and/or modify it.
+
+require 'thin'
+require "phprpc/base_server"
+
+module PHPRPC
+
+  class ThinServer < BaseServer
+
+    def initialize(options = {})
+      super()
+      @options = {
+        :address              => '0.0.0.0',
+        :port                 => Thin::Server::DEFAULT_PORT,
+        :timeout              => Thin::Server::DEFAULT_TIMEOUT,
+        :daemonize            => false,
+        :log                  => 'log/thin.log',
+        :pid                  => 'log/thin.pid',
+        :max_conns            => Thin::Server::DEFAULT_MAXIMUM_CONNECTIONS,
+        :max_persistent_conns => Thin::Server::DEFAULT_MAXIMUM_PERSISTENT_CONNECTIONS,
+        :threaded             => false,
+        :chdir                => Dir.pwd,
+        :session_mode         => :file,
+        :path                 => "/",
+        :expire_after         => 1800,
+        :debug                => false,
+        :trace                => false,
+      }.update(options)
+      @opts = OptionParser.new
+      @opts.banner = "Usage: #{@opts.program_name} thin [options]"
+      @opts.separator ""
+      @opts.separator "Server options:"
+      @opts.on("-a", "--address HOST", "Bind to HOST address (default: #{@options[:address]})") { |host| @options[:address] = host }
+      @opts.on("-p", "--port PORT", "Use PORT (default: #{@options[:port]})") { |port| @options[:port] = port.to_i }
+      @opts.on("-S", "--socket FILE", "Bind to unix domain socket") { |file| @options[:socket] = file }
+      @opts.on("-y", "--swiftiply [KEY]", "Run using swiftiply") { |key| @options[:swiftiply] = key }
+      @opts.on("-c", "--chdir DIR", "Change to dir before starting") { |dir| @options[:chdir] = File.expand_path(dir) }
+      @opts.on("--stats PATH", "Mount the Stats adapter under PATH") { |path| @options[:stats] = path }
+      unless Thin.win? # Daemonizing not supported on Windows
+        @opts.separator ""
+        @opts.separator "Daemon options:"
+        @opts.on("-d", "--daemonize", "Run daemonized in the background") { @options[:daemonize] = true }
+        @opts.on("-l", "--log FILE", "File to redirect output", "(default: #{@options[:log]})") { |file| @options[:log] = file }
+        @opts.on("-P", "--pid FILE", "File to store PID", "(default: #{@options[:pid]})") { |file| @options[:pid] = file }
+        @opts.on("-u", "--user NAME", "User to run daemon as (use with -g)") { |user| @options[:user] = user }
+        @opts.on("-g", "--group NAME", "Group to run daemon as (use with -u)") { |group| @options[:group] = group }
+      end
+      @opts.separator ""
+      @opts.separator "Tuning options:"
+      @opts.on("-b", "--backend CLASS", "Backend to use, full classname") { |name| @options[:backend] = name }
+      @opts.on("-t", "--timeout SEC", "Request or command timeout in sec", "(default: #{@options[:timeout]})") { |sec| @options[:timeout] = sec.to_i }
+      @opts.on("--max-conns NUM", "Maximum number of connections", "(default: #{@options[:max_conns]})",
+                                  "Might require sudo to set higher then 1024")  { |num| @options[:max_conns] = num.to_i } unless Thin.win?
+      @opts.on("--max-persistent-conns NUM", "Maximum number of persistent connections",
+                                       "(default: #{@options[:max_persistent_conns]})") { |num| @options[:max_persistent_conns] = num.to_i }
+      @opts.on("--threaded", "Call the Rack application in threads", "[experimental]") { @options[:threaded] = true }
+      @opts.separator ""
+      @opts.separator "Session options:"
+      @opts.on('-s', '--session-mode MODE', [:file, :memcache, :pool], "Select Session mode (file, memcache, pool)", "(default: #{@options[:session_mode].to_s})") { |mode| @options[:session_mode] = mode }
+      @opts.on('-e','--expire-after TIME', Integer, "Session expire after (default: #{@options[:expire_after]})") { |time| @options[:expire_after] = time }
+      @opts.on('-m','--memcache_server SERVER', String, "Memcache server used by session in", "memcache mode (default: localhost:11211)") { |server| @options[:memcache_server] = server }
+      @opts.on('--prefix PATH', String, "Mount the PHPRPC Server under PATH", "(start with /)") { |path| @options[:path] = path }
+      @opts.separator ""
+      @opts.separator "Common options:"
+      @opts.on_tail("-D", "--debug", "Set debbuging on") { @options[:debug] = true }
+      @opts.on_tail("-V", "--trace", "Set tracing on (log raw request/response)") { @options[:trace] = true }
+      @opts.on_tail("-?", "-h", "--help", "Show this message") { puts @opts; exit }
+      @opts.on_tail('-v', '--version', "Show version") { puts Thin::SERVER; exit }
+      begin
+        @opts.parse!(ARGV)
+      rescue OptionParser::ParseError
+        puts @opts
+        exit
+      end
+      @app = PHPRPC::BaseServer.new
+      self.debug = @options[:debug]
+    end
+    
+    def start()
+      @options[:backend] = eval(@options[:backend], TOPLEVEL_BINDING) if @options[:backend]
+      app = self
+      if [:memcache, :pool].include?(@options[:session_mode]) then
+        begin
+          require 'rack'
+          if @options[:session_mode] == :memcache then
+            app = Rack::Session::Memcache.new(self, @options)
+          else
+            app = Rack::Session::Pool.new(self, @options)
+          end
+        rescue Exception
+          app = self
+        end
+      end
+      Dir.chdir(@options[:chdir])      
+      Thin::Logging.debug = @options[:debug]
+      Thin::Logging.trace = @options[:trace]
+      server = Thin::Server.new(@options[:socket] || @options[:address], # Server detects kind of socket
+                                  @options[:port],                         # Port ignored on UNIX socket
+                                  @options,
+                                  app)
+
+      # Set options
+      server.pid_file                       = @options[:pid]
+      server.log_file                       = @options[:log]
+      server.timeout                        = @options[:timeout]
+      server.maximum_connections            = @options[:max_conns]
+      server.maximum_persistent_connections = @options[:max_persistent_conns]
+      server.threaded                       = @options[:threaded]
+
+      # Detach the process, after this line the current process returns
+      server.daemonize if @options[:daemonize]
+
+      # +config+ must be called before changing privileges since it might require superuser power.
+      server.config
+
+      server.change_privilege @options[:user], @options[:group] if @options[:user] && @options[:group]
+
+      # If a prefix is required, wrap in Rack URL mapper
+      server.app = Rack::URLMap.new(@options[:path] => server.app) if @options[:path]
+
+      # If a stats URL is specified, wrap in Stats adapter
+      server.app = Thin::Stats::Adapter.new(server.app, @options[:stats]) if @options[:stats]
+
+      # Register restart procedure which just start another process with same options,
+      # so that's why this is done here.
+      server.on_restart { Thin::Command.run(:start, @options) }
+
+      server.start
+    end
+
+  end # class ThinServer
+
+end # module PHPRPC

data/lib/phprpc/webrick_server.rb

@@ -0,0 +1,139 @@
+############################################################
+#                                                          #
+# The implementation of PHPRPC Protocol 3.0                #
+#                                                          #
+# webrick_server.rb                                        #
+#                                                          #
+# Release 3.0.0                                            #
+# Copyright (c) 2005-2008 by Team-PHPRPC                   #
+#                                                          #
+# WebSite:  http://www.phprpc.org/                         #
+#           http://www.phprpc.net/                         #
+#           http://www.phprpc.com/                         #
+#           http://sourceforge.net/projects/php-rpc/       #
+#                                                          #
+# Authors:  Ma Bingyao <andot@ujn.edu.cn>                  #
+#                                                          #
+# This file may be distributed and/or modified under the   #
+# terms of the GNU Lesser General Public License (LGPL)    #
+# version 3.0 as published by the Free Software Foundation #
+# and appearing in the included file LICENSE.              #
+#                                                          #
+############################################################
+#
+# PHPRPC WEBrickServer library.
+#
+# Copyright (C) 2005-2008 Ma Bingyao <andot@ujn.edu.cn>
+# Version: 3.0
+# LastModified: Sep 12, 2008
+# This library is free.  You can redistribute it and/or modify it.
+
+require 'webrick'
+require "phprpc/base_server"
+
+module PHPRPC
+
+  class WEBrickServlet < BaseServer
+    
+    def get_instance(*a)
+      self
+    end
+
+    def service(request, response)
+      env = request.meta_vars
+      env.delete_if { |k, v| v.nil? }
+      env["HTTPS"] = ENV["HTTPS"]
+      env["rack.input"] = StringIO.new(request.body.to_s)
+      env['rack.multithread'] = true # this variable only used for rack pool session on debug mode
+      env["rack.url_scheme"] = ["yes", "on", "1"].include?(ENV["HTTPS"]) ? "https" : "http"
+      env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
+      env["QUERY_STRING"] ||= ""
+      env["REQUEST_PATH"] ||= "/"
+      status, headers, body = @app.call(env)
+      response.status = status.to_i
+      headers.each { |k, v| response[k] = v }
+      response.body = body
+    end
+
+  end # class WEBrickServlet
+  
+  class WEBrickServer < WEBrickServlet
+    
+    def initialize(options = {})
+      super()
+      @app = self
+      @options = {
+        :BindAddress    => '0.0.0.0',
+        :Port           => 3000,
+        :Logger         => nil,
+        :MaxClients     => 100,
+        :RequestTimeout => 30,
+        :session_mode   => :file,
+        :path           => "/",
+        :expire_after   => 1800,        
+      }.update(options)
+      @opts = OptionParser.new
+      @opts.banner = "Usage: #{@opts.program_name} webrick [options]"
+      @opts.separator ""
+      @opts.separator "Server options:"
+      @opts.on('-a', '--address IP', String, "Address to bind to (default: #{@options[:BindAddress]})") { |ip| @options[:BindAddress] = ip }
+      @opts.on('-p', '--port PORT', Integer, "Which port to bind to (default: #{@options[:Port]})") { |port| @options[:Port] = port }
+      @opts.on('-l', '--log FILE', String, "File to redirect output") { |file| @options[:Logger] = WEBrick::Log.new(file); }
+      @opts.on('-L', '--accesslog FILE', String, "File to redirect access info") { |file|
+        file = open(file, "a+")
+        @options[:AccessLog] = [
+          [ file, WEBrick::AccessLog::COMMON_LOG_FORMAT ],
+          [ file, WEBrick::AccessLog::REFERER_LOG_FORMAT ]
+        ]
+      }
+      @opts.separator ""
+      @opts.separator "Tuning options:"
+      @opts.on('-n', '--max-clients INT', Integer, "Maximum number of the concurrent", "connections (default: #{@options[:MaxClients]})") { |num| @options[:MaxClients] = num }
+      @opts.on('-t', '--timeout TIME', Integer, "Request timeout (in seconds)", "(default: #{@options[:RequestTimeout]})") { |time| @options[:RequestTimeout] = time }
+      @opts.separator ""
+      @opts.separator "Session options:"
+      @opts.on('-s', '--session-mode MODE', [:file, :memcache, :pool], "Select Session mode (file, memcache, pool)", "(default: #{@options[:session_mode].to_s})") { |mode| @options[:session_mode] = mode }
+      @opts.on('-e','--expire-after TIME', Integer, "Session expire after (default: #{@options[:expire_after]})") { |time| @options[:expire_after] = time }
+      @opts.on('-m','--memcache_server SERVER', String, "Memcache server used by session in", "memcache mode (default: localhost:11211)") { |server| @options[:memcache_server] = server }
+      @opts.on('--prefix PATH', String, "Mount the PHPRPC Server under PATH", "(start with /)") { |path| @options[:path] = path }
+      @opts.separator ""
+      @opts.separator "Common options:"
+      @opts.on_tail('-D', '--debug', "Set debbuging on (default: disabled)") { self.debug = true }
+      @opts.on_tail('-?', '-h', '--help', "Show this help message.") { puts @opts; exit }
+      @opts.on_tail('-v', '--version', "Show version") { puts "WEBrick/#{WEBrick::VERSION} (Ruby/#{RUBY_VERSION}/#{RUBY_RELEASE_DATE})"; exit }
+      begin
+        @opts.parse!(ARGV)
+      rescue OptionParser::ParseError
+        puts @opts
+        exit
+      end
+    end
+    
+    def start
+      if [:memcache, :pool].include?(@options[:session_mode]) then
+        old_app = @app
+        begin
+          require 'rubygems'
+          require 'rack'
+          if @options[:session_mode] == :memcache then
+            @app = Rack::Session::Memcache.new(@app, @options)
+          else
+            @app = Rack::Session::Pool.new(@app, @options)
+          end
+        rescue Exception
+          @app = old_app
+        end
+      end
+      @options.delete(:ServerType)
+      @options.delete(:DocumentRoot)
+      @options.delete(:RequestCallback)
+      @options.delete(:RequestHandler)
+      server = WEBrick::HTTPServer.new(@options)
+      server.mount(@options[:path], self)
+      trap(:INT) { server.shutdown }
+      server.start
+    end
+
+  end # class WEBrickServer
+  
+end # module PHPRPC

data/lib/powmod.rb

@@ -0,0 +1,39 @@
+############################################################
+#                                                          #
+# The implementation of PHPRPC Protocol 3.0                #
+#                                                          #
+# powmod.rb                                                #
+#                                                          #
+# Release 3.0.0                                            #
+# Copyright (c) 2005-2008 by Team-PHPRPC                   #
+#                                                          #
+# WebSite:  http://www.phprpc.org/                         #
+#           http://www.phprpc.net/                         #
+#           http://www.phprpc.com/                         #
+#           http://sourceforge.net/projects/php-rpc/       #
+#                                                          #
+# Authors:  Ma Bingyao <andot@ujn.edu.cn>                  #
+#                                                          #
+# This file may be distributed and/or modified under the   #
+# terms of the GNU Lesser General Public License (LGPL)    #
+# version 3.0 as published by the Free Software Foundation #
+# and appearing in the included file LICENSE.              #
+#                                                          #
+############################################################
+#
+# Math.powmod
+#
+# Copyright (C) 2005-2008 Ma Bingyao <andot@ujn.edu.cn>
+# Version: 1.0
+# LastModified: Aug 21, 2008
+# This library is free.  You can redistribute it and/or modify it.
+
+def Math.powmod(x, y, z)
+  r = 1
+  while y > 0
+    r = (r * x) % z if (y & 1) == 1
+    x = (x * x) % z
+    y >>= 1
+  end
+  return r
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: phprpc
+version: !ruby/object:Gem::Version 
+  version: 3.0.0
+platform: ruby
+authors: 
+- MA Bingyao ( andot )
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-09-16 00:00:00 +08:00
+default_executable: 
+dependencies: []
+
+description: 
+email: andot@ujn.edu.cn
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- examples/client.rb
+- examples/server.rb
+- lib/crypt
+- lib/crypt/xxtea.rb
+- lib/dhparams
+- lib/dhparams/1024.dhp
+- lib/dhparams/128.dhp
+- lib/dhparams/1536.dhp
+- lib/dhparams/160.dhp
+- lib/dhparams/192.dhp
+- lib/dhparams/2048.dhp
+- lib/dhparams/256.dhp
+- lib/dhparams/3072.dhp
+- lib/dhparams/4096.dhp
+- lib/dhparams/512.dhp
+- lib/dhparams/768.dhp
+- lib/dhparams/96.dhp
+- lib/php
+- lib/php/formator.rb
+- lib/phprpc
+- lib/phprpc/base_server.rb
+- lib/phprpc/cgi_server.rb
+- lib/phprpc/client.rb
+- lib/phprpc/ebb_server.rb
+- lib/phprpc/fake_server.rb
+- lib/phprpc/fcgi_server.rb
+- lib/phprpc/lsapi_server.rb
+- lib/phprpc/mongrel_server.rb
+- lib/phprpc/scgi_server.rb
+- lib/phprpc/server.rb
+- lib/phprpc/thin_server.rb
+- lib/phprpc/webrick_server.rb
+- lib/phprpc.rb
+- lib/powmod.rb
+- AUTHORS
+- examples
+- lib
+- LICENSE
+- README
+has_rdoc: false
+homepage: http://phprpc.rubyforge.org/
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: phprpc
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: PHPRPC is a Remote Procedure Calling protocol that works over the Internet. It is secure and fast. It has a smaller overhead. It is powerful and easy to use. This project is the client and server implementations of the PHPRPC for Ruby.
+test_files: []
+