LibCGI is now available for download from:
http://www.sweattechnologies.com/rev/ http://www.infiny.co.nz/developer/LibCGI%201.0.zip
The LibCGI home page is located at http://rodney.weblogs.com/libcgi
Please post any questions, comments or bugs to the discussion forum on this page.
LibCGI simplifies CGI scripting in Revolution (and Metacard). It provides a standard way to process data from users, whether submitted via web page forms or URL parameters.
Scripting your own CGIs is very simple with LibCGI. After configuration on your web server, all you need to do is create a Revolution stack containing an "on libraryStack" handler. All data from the user is stored in an array. This will be called when the web server calls a function in the stack.
A simple example of calling a libCGI function is illustrated in the following URL and response:
http://yourdomain.com/cgi-bin/form.cgi?stack=hello&cmd=hello
In the Hello.rev stack you would place the following handler
global gRequestA
on libraryStack
put gRequestA["address"] into tAddress
switch gRequestA["cmd"]
case "hello"
libCGI_Response "hello world"
break
default
libCGI_Response "command not understood"&& gRequestA["cmd"]
break
end switch
end libraryStackCalling the URL returns "Hello World"
State information can be handled through LibCGI support for getting and setting cookies on the remote client's web browser.
To simplify development, LibCGI features several useful error reporting features. When a script in a CGI stack fails LibCGI can generate a result page containing the error, submitted information from user, and Revolution variables. Errors can also be logged to the system log. To assist in debugging you can watch CGI scripts dynamically as they execute in the web server, by placing libCGI console logging messages in your scripts. These can be viewed in a console window, for example using the OSX Console application.
CGI stacks may call other stacks. One of the supplied example CGI stacks demonstrates sending an email reply to a request using the libSMTP stack. When file and file permissions are correctly configured, LibCGi scripts can also read and write files on the server.
The documentation explains how advanced users can configure Apache to support server side includes, allowing generation of dynamic web pages where portions of the page have been generated by Revolution CGI calls.
Documentation and several examples stacks are included in the download.
Known Issues:
(i) sending messages to console is not entirely reliable at this point. Will be fixed in the next release.
-- Rodney Tamblyn 44 Melville Street Dunedin New Zealand +64 3 4778606 http://rodney.weblogs.com/
_______________________________________________ use-revolution mailing list [EMAIL PROTECTED] http://lists.runrev.com/mailman/listinfo/use-revolution
