view release on metacpan or  search on metacpan

site/config.html  view on Meta::CPAN

<font face="courier new" size=3><pre>
</pre></font>default 0, may be set between 1 and 9.  This setting determine how much
text/html output should be compressed.  A setting of 1 strips mostly
white space saving usually 10% in output size, at a performance cost
of less than 5%.  A setting of 9 goes much further saving anywhere
25% to 50% typically, but with a performance hit of 50%.
<font face="courier new" size=3><pre>
</pre></font>This config option is implemented via HTML::Clean.  Per script
configuration of this setting is available via the $Response-&gt;{Clean}
property, which may also be set between 0 and 9.
<font face="courier new" size=3><pre>
  PerlSetVar Clean 0
</pre></font>
	
	<p>
	<a name=CompressGzip></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>CompressGzip</b></font>
<font face="courier new" size=3><pre>
</pre></font>default 0, if true will gzip compress HTML output on the
fly if Compress::Zlib is installed, and the client browser
supports it.  Depending on the HTML being compressed, 
the client may see a 50% to 90% reduction in HTML output.
I have seen 40K of HTML squeezed down to just under 6K.
This will come at a 5%-20% hit to CPU usage per request
compressed.
<font face="courier new" size=3><pre>
</pre></font>Note there are some cases when a browser says it will accept
gzip encoding, but then not render it correctly.  This
behavior has been seen with IE5 when set to use a proxy but 
not using a proxy, and the URL does not end with a .html or .htm.
No work around has yet been found for this case so use at your 
own risk.
<font face="courier new" size=3><pre>
  PerlSetVar CompressGzip 1
</pre></font>
	
	<p>
	<a name=FormFill></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>FormFill</b></font>
<font face="courier new" size=3><pre>
</pre></font>default 0, if true will auto fill HTML forms with values
from $Request-&gt;Form().  This functionality is provided
by use of HTML::FillInForm.  For more information please
see &quot;perldoc HTML::FillInForm&quot;, and the 
example <a href=eg/formfill.asp>./site/eg/formfill.asp</a>.  
<font face="courier new" size=3><pre>
</pre></font>This feature can be enabled on a per form basis at runtime
with $Response-&gt;{FormFill} = 1
<font face="courier new" size=3><pre>
  PerlSetVar FormFill 1
</pre></font>
	
	<p>
	<a name=TimeHiRes></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>TimeHiRes</b></font>
<font face="courier new" size=3><pre>
</pre></font>default 0, if set and Time::HiRes is installed, will do 
sub second timing of the time it takes Apache::ASP to process
a request.  This will not include the time spent in the 
session manager, nor modperl or Apache, and is only a 
rough approximation at best.
<font face="courier new" size=3><pre>
</pre></font>If Debug is set also, you will get a comment in your
HTML output that indicates the time it took to process
that script.
<font face="courier new" size=3><pre>
</pre></font>If system debugging is set with Debug -1 or -2, you will
also get this time in the Apache error log with the 
other system messages.</font>
	
	<p>
	<a name=Mail%20Adminis1a4d2b59></a>
	<font face=verdana><font class=title size=+0 color=#555555><b>Mail Administration</b></font>
<font face="courier new" size=3><pre>
</pre></font>Apache::ASP has some powerful administrative email
extensions that let you sleep at night, knowing full well
that if an error occurs at the web site, you will know
about it immediately.  With these features already enabled,
it was also easy to provide the $Server-&gt;Mail(\%mail) API 
extension which you can read up about in the <a href=objects.html><font size=-1 face=verdana><b>OBJECTS</b></font></a> section.</font>
	
	<p>
	<a name=MailHost></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>MailHost</b></font>
<font face="courier new" size=3><pre>
</pre></font>The mail host is the smtp server that the below Mail* config directives
will use when sending their emails.  By default Net::SMTP uses
smtp mail hosts configured in Net::Config, which is set up at
install time, but this setting can be used to override this config.
<font face="courier new" size=3><pre>
</pre></font>The mail hosts specified in the Net::Config file will be used as
backup smtp servers to the MailHost specified here, should this
primary server not be working.
<font face="courier new" size=3><pre>
  PerlSetVar MailHost smtp.yourdomain.com.foobar
</pre></font>
	
	<p>
	<a name=MailFrom></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>MailFrom</b></font>
<font face="courier new" size=3><pre>
</pre></font>Default NONE, set this to specify the default mail address placed 
in the From: mail header for the $Server-&gt;Mail() API extension, 
as well as MailErrorsTo and MailAlertTo.
<font face="courier new" size=3><pre>
  PerlSetVar MailFrom <b>&#121;&#111;&#117;&#114;&#101;&#109;&#097;&#105;&#108;&#064;&#121;&#111;&#117;&#114;&#100;&#111;&#109;&#097;&#105;&#110;&#046;&#099;&#111;&#109;&#046;&#102;&#111;&#111;&#098;&#097;&#114;</b>
</pre></font>
	
	<p>
	<a name=MailErrorsTo></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>MailErrorsTo</b></font>
<font face="courier new" size=3><pre>
</pre></font>No default, if set, ASP server errors, error code 500, that result
while compiling or running scripts under Apache::ASP will automatically
be emailed to the email address set for this config.  This allows
an administrator to have a rapid response to user generated server
errors resulting from bugs in production ASP scripts.  Other errors, such 
as 404 not found will be handled by Apache directly.
<font face="courier new" size=3><pre>
</pre></font>An easy way to see this config in action is to have an ASP script which calls
a die(), which generates an internal ASP 500 server error.