granicus.if.org Git - apache/blob - modules/lua/README

   1 -*- mode:org -*-
   2 * Requirements:
   3 ** lua 5.1, 5.2 ( http://www.lua.org/ ) or LuaJIT 2.x ( http://www.luajit.org/ )
   4 ** Apache HTTPD 2.3 ( http://httpd.apache.org/ ) or higher
   5
   6 * Documentation
   7   See docs/README
   8
   9 * Building
  10   For now, see docs/building-from-subversion.txt
  11
  12 * To Consider
  13   Allow definition of lua_State instances associated with arbitrary
  14   pool using the pool's user_data constuct. There would, here, be two
  15   types, pooled and singleton. On the other hand, singleton would work
  16   fine for almost all cases -- the exception being a process or server
  17   pool, and then we could stay singleton anyway and lock around it.
  18
  19
  20 * Task List
  21 ** TODO Use r->file to determine file, doing rewriting in translate_name
  22 ** TODO Provide means to get useful output from lua errors in response body
  23    Probably have to put it on the vm spec for pre-handler errors, as
  24    it is pre-handler, will prolly be on the request_config somewhere,
  25    but sometimes cannot put there, so... fun
  26 ** TODO Mapping in the server_rec
  27 ** TODO Figure out how reentrancy works regarding filter chain stuff.
  28    Do we need new "threads"?
  29 ** TODO: Flatten LuaHook* to LuaHook phase file fn ?
  30 ** TODO: document or remove block sections
  31 ** TODO: test per-dir behavior of block sections
  32 ** TODO: Suppress internal details (fs path to scripts, etc) in error responses
  33
  34 * License
  35   Apache License, Version 2.0,
  36
  37   http://www.apache.org/licenses/LICENSE-2.0
  38
  39   See NOTICE file for more information
  40
  41 * Problems and Patches:
  42   Please use dev@httpd.apache.org for discussing mod_lua development
  43   To subscribe send email to dev-subscribe@httpd.apache.org
  44   Note that this is for development discussion, not user support :-)
  45
  46 * Contributors Include
  47 ** Brian McCallister
  48 ** Paul Querna
  49 ** Garrett Rooney
  50 ** Martin Traverso
  51 ** Brian Akins
  52 ** Justin Erenkrantz
  53 ** Philip M. Gollucci
  54 ** Stefan Fritsch
  55 ** Eric Covener
  56 ** Daniel Gruno
  57 ** Günter Knauf