lib/PLP/Backend/CGI.pm

   1 package PLP::Backend::CGI;
   2
   3 use strict;
   4
   5 our $VERSION = '1.02';
   6
   7 use PLP;
   8
   9 # CGI initializer: opens SCRIPT_FILENAME
  10 sub init {
  11         $PLP::print = 'print';
  12         $PLP::read = \&read;
  13
  14         if (defined $ENV{PATH_TRANSLATED}) {
  15                 # SCRIPT_* points to handler script (Apache CGI)
  16                 # Run backwards through PATH_TRANSLATED to find target filename,
  17                 # then get file (relative) by stripping PATH_INFO.
  18                 my ($path, $rel) = (delete $ENV{PATH_TRANSLATED}, delete $ENV{PATH_INFO});
  19                 my $path_info;
  20                 while (not -f $path) {
  21                         if (not $path =~ s/(\/+[^\/]*)$//) {
  22                                 printf STDERR "PLP: Not found: $path$path_info ($ENV{REQUEST_URI})\n";
  23                                 PLP::error(undef, 404);
  24                                 return;
  25                         }
  26                         # move last path element onto PATH_INFO
  27                         $path_info = $1 . $path_info;
  28                 }
  29                 if (defined $path_info) {
  30                         $rel =~ s/\Q$path_info\E$//;
  31                         $ENV{PATH_INFO} = $path_info;
  32                 }
  33                 $ENV{SCRIPT_FILENAME} = $path;
  34                 $ENV{SCRIPT_NAME} = $rel;
  35         }
  36         elsif (not -f $ENV{SCRIPT_FILENAME}) {
  37                 print STDERR "PLP: Not found: $ENV{SCRIPT_FILENAME} ($ENV{REQUEST_URI})\n";
  38                 PLP::error(undef, 404);
  39                 return;
  40         }
  41
  42         $ENV{"PLP_$_"} = $ENV{"SCRIPT_$_"} for qw/NAME FILENAME/;
  43
  44         if (not -r $ENV{PLP_FILENAME}) {
  45                 print STDERR "PLP: Can't read: $ENV{PLP_FILENAME} ($ENV{REQUEST_URI})\n";
  46                 PLP::error(undef, 403);
  47                 return;
  48         }
  49
  50         delete @ENV{
  51                 qw(SCRIPT_NAME SCRIPT_FILENAME),
  52                 grep /^REDIRECT_/, keys %ENV
  53         };
  54
  55         my ($file, $dir) = File::Basename::fileparse($ENV{PLP_FILENAME});
  56         chdir $dir;
  57
  58         $PLP::code = PLP::source($file, 0, undef, $ENV{PLP_FILENAME});
  59         return 1;
  60 }
  61
  62 sub read ($) {
  63         my ($bytes) = @_;
  64         read *STDIN, my ($data), $bytes;
  65         return $data;
  66 }
  67
  68 sub everything {
  69         PLP::clean();
  70         $_[0]->init() and PLP::start();
  71 }
  72
  73 # This is run by the CGI script. (#!perl \n use PLP::Backend::CGI;)
  74 sub import {
  75         $PLP::interface = $_[0];
  76         $_[0]->everything();
  77 }
  78
  79 1;
  80
  81 =head1 NAME
  82
  83 PLP::Backend::CGI - CGI interface for PLP
  84
  85 =head1 SYNOPSIS
  86
  87 For most servers you'll need a script executable.
  88 Example F</foo/bar/plp.cgi>:
  89
  90     #!/usr/bin/perl
  91     use PLP::Backend::CGI;
  92
  93 Or install the C<plp.cgi> included with PLP.
  94
  95 =head2 Lighttpd
  96
  97 Usually in F</etc/lighttpd/lighttpd.conf>:
  98 enable I<mod_cgi> (add/outcomment in server.modules), and add:
  99
 100     cgi.assign = (
 101         ".plp" => "/foo/bar/plp.cgi",
 102     )
 103
 104 =head2 Apache
 105
 106 Enable I<mod_actions> and
 107 setup F<httpd.conf> (in new installs just create F</etc/apache/conf.d/plp>) with:
 108
 109     <IfModule mod_actions.c>
 110         ScriptAlias /PLP_COMMON/ /foo/bar/
 111         <Directory /foo/bar/>
 112             Options +ExecCGI
 113             Order allow,deny
 114             Allow from all
 115         </Directory>
 116         AddHandler plp-document plp
 117         Action plp-document /PLP_COMMON/plp.cgi
 118     </IfModule>
 119
 120 =head1 AUTHOR
 121
 122 Mischa POSLAWSKY <perl@shiar.org>
 123
 124 =head1 SEE ALSO
 125
 126 L<PLP>, L<PLP::Backend::FastCGI>
 127