home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _4591b10d404612b391a493ce4609aa9a < prev    next >
Text File  |  2000-03-22  |  8KB  |  209 lines

  1. <HTML>
  2.  
  3. <HEAD>
  4. <TITLE>PerlScript</TITLE>
  5. <META name="GENERATOR" charset="iso-8859-1" content="Microsoft FrontPage 4.0">
  6. <META name="ProgId" content="FrontPage.Editor.Document">
  7. <LINK rel="STYLESHEET" href="../../Active.css" type="text/css">
  8. </HEAD>
  9.  
  10. <BODY bgcolor="#ffffff">
  11.  
  12. <!-- beginning of leaf header-->
  13.  
  14. <TABLE border="0" cellpadding="0" cellspacing="0" width="100%">
  15.   <TR>
  16.     <TD class="block" valign="MIDDLE" width="100%" bgcolor="#cccccc"><FONT size="+1"><STRONG>
  17.       <P class="block"> PerlScript</P>
  18.       </STRONG></FONT></TD>
  19.   </TR>
  20. </TABLE>
  21. <BR>
  22. <BR>
  23.  
  24.       <!-- end of leaf content-->
  25.  
  26. <UL>
  27.   <LI><A href="#what_is_perlscript">What is PerlScript?</A>
  28.   <LI><A href="#running_perlscript">What do I need to run PerlScript?</A>
  29.   <LI><A href="#how_do_i_install_perlscript">How do I install PerlScript?</A>
  30.   <LI><A href="#perlscript_configuration">How can I configure PerlScript security?</A>
  31.   <LI><A href="#case_sensitive_event_names">Why aren't my event handlers called?</A>
  32.   <LI><A href="#windows_scripting_host">What is Windows Scripting Host?</A>
  33.   <LI><A href="#active_server_pages">Can I write Active Server Pages with PerlScript?</A>
  34.   <LI><A href="#client_side">Client-side PerlScript</A>
  35.   <LI><A href="#other_references">Other References</A>
  36. </UL>
  37. <P><A name="what_is_perlscript">
  38. <HR>
  39. <H1>What is PerlScript?</H1>
  40. <P>PerlScript is an ActiveX scripting engine that allows you to use Perl with any ActiveX scripting
  41. host. At this time, ActiveX scripting hosts include:</P>
  42. <UL>
  43.   <LI>Internet Information Server 3.0+
  44.   <LI>Peer Web Services 3.0+
  45.   <LI>Microsoft Internet Explorer 4.0+
  46.   <LI>Windows Scripting Host
  47. </UL>
  48. <P></A><A name="running_perlscript">
  49. <HR>
  50. <H1>What do I need to run PerlScript?</H1>
  51. <UL>
  52.   <LI><B>ActivePerl</B>
  53.   <LI>an ActiveX scripting host (see above)
  54.   <LI>Perl scripts!</LI>
  55. </UL>
  56. <P></A><A name="how_do_i_install_perlscript">
  57. <HR>
  58. <H1>How do I install PerlScript?</H1>
  59. <P>When you launch the <B>ActivePerl</B> installer, <B>PerlScript</B> is one of the components you
  60. can optionally install. You must install, or have previously installed, <B>ActivePerl</B> to use
  61. PerlScript.
  62. <P></A><A name="perlscript_configuration">
  63. <HR>
  64. <H1>How can I configure PerlScript security?</H1>
  65. <P>PerlScript in IE 4.0 and higher can be enabled/disabled by zones
  66. <UL>
  67.   HKEY_LOCAL_MACHINE\SOFTWARE\ActiveState\PerlSE\1.0<BR>
  68.   REG_DWORD: EnabledZones = 0x0010 (default)
  69. </UL>
  70. <P><STRONG>Values</STRONG>
  71. <UL>
  72.   <LI>Enable All 0x0001
  73.   <LI>Enable Local 0x0010
  74.   <LI>Enable Internet 0x0020
  75.   <LI>Enable Trusted 0x0040
  76.   <LI>Enable Restricted 0x0080 (for the perverse)
  77. </UL>
  78. IE3 is more limited; it is an all or nothing affair. For IE3 the only values recognized are
  79. <P><STRONG>Values</STRONG>
  80. <UL>
  81.   <LI>Disable All 0x0000
  82.   <LI>Enable All 0x0001
  83. </UL>
  84. <P></A><A name="case_sensitive_event_names">
  85. <HR>
  86. <H1>Why aren't my event handlers called?</H1>
  87. <P>Case sensitive lookup of event names may be being performed. Event name lookup can be made case
  88. insensitive by adding key
  89. <UL>
  90.   HKEY_LOCAL_MACHINE\SOFTWARE\ActiveState\PerlSE\1.0<BR>
  91.   REG_DWORD: NoCaseCompare = 1 (default)
  92. </UL>
  93. <P></A><A name="windows_scripting_host">
  94. <HR>
  95. <H1>What is Windows Scripting Host?</H1>
  96. <P>Microsoft advertises <B>Windows Scripting Host</B>, or WSH for short, as being "a
  97. language-independent scripting host for 32-bit Windows operating system platforms". WSH offers
  98. a lot to VBScript and JScript developers for whom console type programs have been traditionally
  99. difficult. For Perl Developers, however, the same functionality can be found with a Perl module or
  100. extension.
  101. <P>More information on Windows Scripting Host can be found on the Microsoft Web Site at: </A><A href="http://www.microsoft.com/scripting/">http://www.microsoft.com/scripting/</A>.
  102. <P><A name="active_server_pages">
  103. <HR>
  104. <H1>Can I write Active Server Pages with PerlScript?</H1>
  105. <P><B>Active Server Pages</B>, or ASP for short, generate HTML on your Web server and send it to the
  106. browser. <B>ActivePerl</B> and <B>PerlScript</B> are required on your server but they are not
  107. required on the clients.
  108. <P>To identify server-side Perl code to the server, you must do one of the following:
  109. <P>  use the <CODE><SCRIPT></CODE> tag
  110. <P>or
  111. <P>  wrap your code in <CODE><%</CODE> and <CODE>%></CODE>
  112. <P>The example below uses the <CODE><SCRIPT></CODE> tag.
  113. <P> 
  114. <UL>
  115.   <CODE><%@ LANGUAGE = PerlScript %><BR>
  116.   <HTML><BR>
  117.   <HEAD><BR>
  118.   <TITLE>PerlScript Hello World!</TITLE><BR>
  119.   </HEAD><BR>
  120.   <BODY BGCOLOR="#FFFFFF"><BR>
  121.   <H1>PerlScript Hello world!</H1><BR>
  122.   <P><BR>
  123.   <SCRIPT LANGUAGE="PerlScript" RUNAT=Server><BR>
  124.   $Response->write("Hello world!");<BR>
  125.   </SCRIPT><BR>
  126.   </BODY><BR>
  127.   </HTML><BR>
  128.   </CODE>
  129. </UL>
  130. To do the same by wraping your code in <CODE><%</CODE> and <CODE>%></CODE>:
  131. <UL>
  132.   <CODE><%@ LANGUAGE = PerlScript %><BR>
  133.   <HTML><BR>
  134.   <HEAD><BR>
  135.   <TITLE>PerlScript Hello World!</TITLE><BR>
  136.   </HEAD><BR>
  137.   <BODY BGCOLOR="#FFFFFF"><BR>
  138.   <H1>PerlScript Hello world!</H1><BR>
  139.   <%<BR>
  140.   $Response->write("Hello world!");<BR>
  141.   %><BR>
  142.   </BODY><BR>
  143.   </HTML><BR>
  144.   </CODE>
  145. </UL>
  146. The first line of the script, <CODE><%@ LANGUAGE = PerlScript %></CODE> tells the server that
  147. you are using PerlScript, rather than any of the other scripting languages supported by Active
  148. Server Pages.
  149. <P>Another option is enclosing anything that you want to be displayed as HTML as follows:
  150. <P> 
  151. <UL>
  152.   <CODE><%= $hello %></CODE>
  153. </UL>
  154. <P>This will display the value of the variable <CODE>$hello</CODE>.
  155. <P></A><A name="client_side">
  156. <HR>
  157. <H1>Client-side PerlScript</H1>
  158. <P>Client-Side PerlScript has Perl embedded within your HTML documents. All PerlScript code must be
  159. contained within <CODE><SCRIPT LANGUAGE="PerlScript"> </SCRIPT></CODE>
  160. <P>Client-side PerlScript has the added requirement that both ActivePerl and PerlScript be installed
  161. on each computer will will be loading PerlScript pages.
  162. <P>Client-side Perlscript should only be used if you can control the ocnfiguration of the computers
  163. on which it will be run. If your goal is build an application which will be used by a large number
  164. users, Server-side PerlScript is considerably more practical.
  165. <P>To display something to the browser, use the <CODE>write()</CODE> method of the document object.
  166. You can use the <CODE>write()</CODE> method with <CODE>$windows->document->write('any old
  167. text')</CODE>.
  168. <P>The sample below is another Hello World variation, but this time using client-side PerlScript:
  169. <UL>
  170.   <CODE><HTML><BR>
  171.   <HEAD><BR>
  172.   <TITLE>PerlScript Hello World!</TITLE><BR>
  173.   </HEAD><BR>
  174.   <BODY BGCOLOR="#FFFFFF"><BR>
  175.   <H1>PerlScript Hello world!</H1><BR>
  176.   <SCRIPT LANGUAGE="PerlScript"><BR>
  177.   $window->document->write('Hello world!');<BR>
  178.   </SCRIPT><BR>
  179.   </BODY><BR>
  180.   </HTML><BR>
  181.   </CODE>
  182. </UL>
  183. <P></A><A name="other_references">
  184. <HR>
  185. <H1>Other References</H1>
  186. <P>Here's a short list of PerlScript FAQs available on the net:  </A>
  187. <UL>
  188.   <LI><A href="http://www.fastnetltd.ndirect.co.uk/Perl/perl-win32-asp.html"><B>The Perl-Win32-ASP
  189.     FAQ</B></A>. Maintained by Matthew Sergeant.</LI>
  190. </UL>
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.           <!-- beginning of leaf footer-->
  199. <P> 
  200. <TABLE border="0" cellpadding="0" cellspacing="0" width="100%">
  201.   <TR>
  202.     <TD class="block" valign="MIDDLE" width="100%" bgcolor="#cccccc"><FONT size="+1"><STRONG>
  203.       <P class="block"> PerlScript</P>
  204.       </STRONG></FONT></TD>
  205.   </TR>
  206. </TABLE>
  207.  
  208. </BODY>
  209.