restructure file locations

[perl/plp/.git] / lib / PLP / Backend / CGI.pm

diff --git a/lib/PLP/Backend/CGI.pm b/lib/PLP/Backend/CGI.pm
new file mode 100644 (file)
index 0000000..e4bcf1e
--- /dev/null
+++ b/lib/PLP/Backend/CGI.pm
@@ -0,0 +1,127 @@
+package PLP::Backend::CGI;
+
+use strict;
+
+our $VERSION = '1.02';
+
+use PLP;
+
+# CGI initializer: opens SCRIPT_FILENAME
+sub init {
+       $PLP::print = 'print';
+       $PLP::read = \&read;
+
+       if (defined $ENV{PATH_TRANSLATED}) {
+               # SCRIPT_* points to handler script (Apache CGI)
+               # Run backwards through PATH_TRANSLATED to find target filename,
+               # then get file (relative) by stripping PATH_INFO.
+               my ($path, $rel) = (delete $ENV{PATH_TRANSLATED}, delete $ENV{PATH_INFO});
+               my $path_info;
+               while (not -f $path) {
+                       if (not $path =~ s/(\/+[^\/]*)$//) {
+                               printf STDERR "PLP: Not found: $path$path_info ($ENV{REQUEST_URI})\n";
+                               PLP::error(undef, 404);
+                               return;
+                       }
+                       # move last path element onto PATH_INFO
+                       $path_info = $1 . $path_info;
+               }
+               if (defined $path_info) {
+                       $rel =~ s/\Q$path_info\E$//;
+                       $ENV{PATH_INFO} = $path_info;
+               }
+               $ENV{SCRIPT_FILENAME} = $path;
+               $ENV{SCRIPT_NAME} = $rel;
+       }
+       elsif (not -f $ENV{SCRIPT_FILENAME}) {
+               print STDERR "PLP: Not found: $ENV{SCRIPT_FILENAME} ($ENV{REQUEST_URI})\n";
+               PLP::error(undef, 404);
+               return;
+       }
+
+       $ENV{"PLP_$_"} = $ENV{"SCRIPT_$_"} for qw/NAME FILENAME/;
+
+       if (not -r $ENV{PLP_FILENAME}) {
+               print STDERR "PLP: Can't read: $ENV{PLP_FILENAME} ($ENV{REQUEST_URI})\n";
+               PLP::error(undef, 403);
+               return;
+       }
+
+       delete @ENV{
+               qw(SCRIPT_NAME SCRIPT_FILENAME),
+               grep /^REDIRECT_/, keys %ENV
+       };
+
+       my ($file, $dir) = File::Basename::fileparse($ENV{PLP_FILENAME});
+       chdir $dir;
+
+       $PLP::code = PLP::source($file, 0, undef, $ENV{PLP_FILENAME});
+       return 1;
+}
+
+sub read ($) {
+       my ($bytes) = @_;
+       read *STDIN, my $data, $bytes;
+       return $data;
+}
+
+sub everything {
+       PLP::clean();
+       $_[0]->init() and PLP::start();
+}
+
+# This is run by the CGI script. (#!perl \n use PLP::Backend::CGI;)
+sub import {
+       $PLP::interface = $_[0];
+       $_[0]->everything();
+}
+
+1;
+
+=head1 NAME
+
+PLP::Backend::CGI - CGI interface for PLP
+
+=head1 SYNOPSIS
+
+For most servers you'll need a script executable.
+Example F</foo/bar/plp.cgi>:
+
+    #!/usr/bin/perl
+    use PLP::Backend::CGI;
+
+Or install the C<plp.cgi> included with PLP.
+
+=head2 Lighttpd
+
+Usually in F</etc/lighttpd/lighttpd.conf>:
+enable I<mod_cgi> (add/outcomment in server.modules), and add:
+
+    cgi.assign = (
+        ".plp" => "/foo/bar/plp.cgi",
+    )
+
+=head2 Apache
+
+Enable I<mod_actions> and
+setup F<httpd.conf> (in new installs just create F</etc/apache/conf.d/plp>) with:
+
+    <IfModule mod_actions.c>
+        ScriptAlias /PLP_COMMON/ /foo/bar/
+        <Directory /foo/bar/>
+            Options +ExecCGI
+            Order allow,deny
+            Allow from all
+        </Directory>
+        AddHandler plp-document plp
+        Action plp-document /PLP_COMMON/plp.cgi
+    </IfModule>
+
+=head1 AUTHOR
+
+Mischa POSLAWSKY <perl@shiar.org>
+
+=head1 SEE ALSO
+
+L<PLP>, L<PLP::Backend::FastCGI>
+