Apache2-Archive

 view release on metacpan or  search on metacpan

lib/Apache2/Archive.pm  view on Meta::CPAN


I<##StartData>

A file in the archive. This tag should be place on a line by itself.

I<##EndData>

Marks the end of the repeated section. This tag should be placed on a line by
itself.

The next four tags provide information about one of the component files in
the archive. These tags should only be used between the ##StartData and ##EndData
tags.

I<##FileName>

The name of the archived file.

I<##FileDate>

The last modification date of the file.

I<##FileSize>

The size of the file.

I<##FileLink>

An absolute URL that allows the user to download the file.

=back

This example is the template used by default.

	<HTML><BODY BGCOLOR="#cccccc">
	<H2>
	<A HREF=##ArchiveLink>##ArchiveName</A>
	</H2>
	##ArchiveDate<BR>
	##ArchiveSize<BR>
	This is the contents of the archive:
	<P>
	<TABLE border=4 cellpadding=6 cellspacing=2>
	<TR>
	<TH>View item</TH><TH>Name</TH><TH>Date</TH><TH>Size</TH>
	</TR>
	##StartData
	<TR>
		<TD><A HREF=##FileLink>View File</A></TD>
		<TD>##FileName</TD><TD>##FileDate</TD>
		<TD>##FileSize</TD>
	</TR>
	##EndData
	</TABLE></BODY></HTML>

=head1 BUGS

=item MEMORY LEAK

There is a problem with memory leakage. This is greatly
reduced with Archive::Tar 0.2 and later. Still, if you have a busy site, I advise
checking memory consumption, and experimenting with the SizeLimit variable, or with
Apache::SizeLimit. Expect processes to be 10Mb and more.

=item No error checking on template file 

If you create a faulty template file,
the server will attempt to use it regardless and may behave unpredictably.

=item Tar files within tar files

If an archive contains other archives, the
sub-archives are not passed through the Apache2::Archive handler - they are simply
treated as regular files. This is not really a bug per se, more a missing feature.

=item No support for .zip files 

This will be added later.

=back

=head1 AUTHOR

J. Peterson, jon@snowdrift.org, made the original Apache::Archive module. David Moreno, david@axiombox.com, made the port to mod_perl 2.

=head1 COPYRIGHT

Copyright 1998-1999, J. Peterson
Copyright 2008, David Moreno

This module is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.

If you have questions or problems regarding use or installation of this module
please feel free to email me directly.

=head1 SEE ALSO

Apache2, Apache::Archive, Archive::Tar, Compress::Zlib, Apache::SizeLimit

=cut



( run in 1.547 second using v1.01-cache-2.11-cpan-d8267643d1d )