fcgi-tcl.htm
来自「FastCGI,语言无关的、可伸缩架构的CGI开放扩展」· HTM 代码 · 共 367 行 · 第 1/2 页
HTM
367 行
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"><HTML> <HEAD> <TITLE> Integrating FastCGI with Tcl </TITLE><STYLE TYPE="text/css"> body { background-color: #FFFFFF; color: #000000; } :link { color: #cc0000 } :visited { color: #555555 } :active { color: #000011 } h5.c3 {text-align: center} p.c2 {text-align: center} div.c1 {text-align: center}</STYLE> </HEAD> <BODY> <DIV CLASS="c1"> <A HREF="http://fastcgi.com"><IMG BORDER="0" SRC="../images/fcgi-hd.gif" ALT="[[FastCGI]]"></A> </DIV> <BR CLEAR="all"> <DIV CLASS="c1"> <H3> Integrating FastCGI with Tcl </H3> </DIV> <!--Copyright (c) 1996 Open Market, Inc. --> <!--See the file "LICENSE.TERMS" for information on usage and redistribution--> <!--of this file, and for a DISCLAIMER OF ALL WARRANTIES. --> <P CLASS="c2"> Michael S. Shanzer<BR> Open Market, Inc.<BR> <EM>19 January 1995</EM> </P> <H5 CLASS="c3"> Copyright © 1996 Open Market, Inc. 245 First Street, Cambridge, MA 02142 U.S.A.<BR> Tel: 617-621-9500 Fax: 617-621-1703 URL: <A HREF= "http://www.openmarket.com/">http://www.openmarket.com/</A><BR> $Id: fcgi-tcl.htm,v 1.4 2002/02/25 00:42:59 robs Exp $<BR> </H5> <HR> <H3> <A NAME="S1">1. Introduction</A> </H3> <P> Tcl (tool command language) is an embeddable scripting language that's often used for CGI programming. Tcl is freely available as a source kit. </P> <P> We've built a Tcl interpreter that runs as a FastCGI application. Our purpose in doing so was twofold: </P> <UL> <LI> <I>Create a useful artifact.</I> Open Market has written many CGI applications using Tcl. Now we'd like to turn them into FastCGI applications. <P> </P> </LI> <LI> <I>Demonstrate how easy it is to integrate FastCGI with an existing program.</I> The Tcl interpreter is a substantial program, so integrating FastCGI with the Tcl interpreter is a good test of the <TT>fcgi_stdio</TT> compatability library. </LI> </UL> <P> We've succeeded on both counts. We now have a platform for migrating our Tcl-based CGI applications to FastCGI. And the integration required a very small effort. The only source code change to the Tcl interpreter was the routine addition of a handful of new commands: <TT>FCGI_Accept</TT>, <TT>FCGI_Finish</TT>, <TT>FCGI_SetExitStatus</TT>, and <TT>FCGI_StartFilterData</TT>. </P> <P> The FastCGI-integrated Tcl interpreter works as usual when run from a shell or as a CGI program. You don't need two Tcls, one for FastCGI and one for other uses. </P> <P> The remainder of this document gives a recipe you can follow to build FastCGI into Tcl, explains what's happening in the recipe, and illustrates the use of FastCGI Tcl with an example program. </P> <P> </P> <H3> <A NAME="S2">2. Recipe</A> </H3> <P> Here are the assumptions embedded in the following recipe: </P> <UL> <LI> You are building Tcl 7.4p3, the current stable Tcl release as this is written. You unpack the Tcl kit into a directory <TT>tcl7.4</TT> that's a sibling of the FastCGI kit directory <TT>fcgi-devel-kit</TT>. <P> </P> </LI> <LI> You have gcc version 2.7 installed on your system, and use it in the build. gcc is convenient because it supports the <TT>-include</TT> command-line option that instructs the C preprocessor to include a specific file before processing any other include files. This allows you to include <TT>fcgi_stdio.h</TT> without modifying Tcl source files. (The reason for specifying gcc version 2.7 is that I have experienced bad behavior with an earlier version and the <TT>-include</TT> flag -- the C preprocessor died with SIGABRT.) <P> </P> </LI> <LI> You have GNU autoconf installed on your system. If you don't have GNU autoconf, you will have to make certain edits by hand and repeat these edits for each build platform.<BR> <BR> </LI> </UL> <P> If those are valid assumptions, follow these steps: </P> <OL> <LI> <I>Build the FastCGI Developer's Kit.</I> Tcl needs to link against <TT>libfcgi.a</TT>, so <A HREF= "fcgi-devel-kit.htm#S2">build the FastCGI Developer's Kit</A> in order to create this library for your platform. <P> </P> </LI> <LI> <I>Pull the Tcl 7.4p3 kit.</I> You'll need the files <A HREF= "ftp://ftp.smli.com/pub/tcl/tcl7.4.tar.Z">tcl7.4.tar.Z</A>, <A HREF= "ftp://ftp.smli.com/pub/tcl/tcl7.4p1.patch.gz">tcl7.4p1.patch.gz</A>, <A HREF= "ftp://ftp.smli.com/pub/tcl/tcl7.4p2.patch.gz">tcl7.4p2.patch.gz</A>, and <A HREF= "ftp://ftp.smli.com/pub/tcl/tcl7.4p3.patch.gz">tcl7.4p3.patch.gz</A>. (Some older Netscape browsers can't perform these retrievals because of a protocol conflict between Netscape and Sun's firewall.) <P> Unpack the tar file in the parent directory of the FastCGI kit directory you used in the previous step, so that the directories <TT>tcl7.4</TT> and <TT>fcgi-devel-kit</TT> are siblings. After unpacking the tar file, follow the directions in the <TT>README</TT> to apply the patches. </P> <P> The <A HREF="http://www.sunlabs.com:80/research/tcl/">Sun Labs Tcl/Tk Project Page</A> contains a wealth of information on Tcl, including up to date information on the latest kits. </P> <P> </P> </LI> <LI> <I>Copy the files <TT>tclFCGI.c</TT>, <TT>tclAppInit.c</TT>, <TT>Makefile.in</TT>, and <TT>configure.in</TT> from the FastCGI kit.</I> <PRE> > cd tcl7.4 > mv tclAppInit.c tclAppInit.c.orig > mv Makefile.in.orig Makefile.in.orig.orig > mv Makefile.in Makefile.in.orig > mv configure.in configure.in.orig > cp ../fcgi-devel-kit/tcl/tcl7.4/* . > cp ../fcgi-devel-kit/tcl/common/* .</PRE> </LI> <LI> <I>Create a new <TT>configure</TT> script.</I> <PRE> > autoconf</PRE> </LI> <LI> <I>Configure and build.</I> <PRE> > ./configure > make</PRE> The <TT>make</TT> creates the Tcl interpreter <TT>tclsh</TT> and library archive <TT>libtcl.a</TT> (for embedding Tcl in your own C applications). The Tcl <TT>README</TT> file explains how you can experiment with <TT>tclsh</TT> without installing it in a standard place.<BR> <BR> </LI> </OL> <H3> <A NAME="S3">3. Recipe Explained</A> </H3> <P> The recipe alone is fine if you are using Tcl 7.4p3, you have gcc version 2.7, and you have GNU autoconf. In case one or more of these assumptions doesn't hold for you, and to illuminate how little work was involved in integrating FastCGI, here's an explanation of how and why you would modify the files <TT>tclAppInit.c</TT>, <TT>Makefile.in</TT>, and <TT>configure.in</TT> from the Tcl kit. </P> <UL> <LI> <TT>tclAppInit.c</TT>:⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?