Diff for /loncom/publisher/lonupload.pm between versions 1.21 and 1.40

version 1.21, 2003/11/08 10:58:30 version 1.40, 2008/11/18 19:14:40
Line 28 Line 28
 #  #
 ###  ###
   
   =head1 NAME
   
   Apache::lonupload - upload files into construction space
   
   =head1 SYNOPSIS
   
   Invoked by /etc/httpd/conf/srm.conf:
   
    <Location /adm/upload>
    PerlAccessHandler       Apache::lonacc
    SetHandler perl-script
    PerlHandler Apache::lonupload
    ErrorDocument     403 /adm/login
    ErrorDocument     404 /adm/notfound.html
    ErrorDocument     406 /adm/unauthorized.html
    ErrorDocument  500 /adm/errorhandler
    </Location>
   
   =head1 INTRODUCTION
   
   This module uploads a file sitting on a client computer into 
   library server construction space.
   
   This is part of the LearningOnline Network with CAPA project
   described at http://www.lon-capa.org.
   
   =head1 HANDLER SUBROUTINE
   
   This routine is called by Apache and mod_perl.
   
   =over 4
   
   =item *
   
   Initialize variables
   
   =item *
   
   Start page output
   
   =item *
   
   output relevant interface phase (phaseone or phasetwo or phasethree)
   
   =item *
   
   (phase one is to specify upload file; phase two is to handle conditions
   subsequent to specification--like overwriting an existing file; phase three
   is to handle processing of secondary uploads - of embedded objects in an
   html file).
   
   =back
   
   =head1 OTHER SUBROUTINES
   
   =over
   
   =item phaseone()
   
   Interface for specifying file to upload.
   
   =item phasetwo()
   
   Interface for handling post-conditions about uploading (such
   as overwriting an existing file).
   
   =item phasethree()
   
   Interface for handling secondary uploads of embedded objects
   in an html file.
   
   =item upfile_store()
   
   Store contents of uploaded file into temporary space.  Invoked
   by phaseone subroutine.
   
   =item check_extension()
   
   Checks if filename extension is permitted and checks type
    of file - if html file, calls parser to check for embedded objects.
    Invoked by phasetwo subroutine.
   
   =back
   
   =cut
   
 package Apache::lonupload;  package Apache::lonupload;
   
 use strict;  use strict;
Line 37  use File::Basename; Line 123  use File::Basename;
 use Apache::Constants qw(:common :http :methods);  use Apache::Constants qw(:common :http :methods);
 use Apache::loncacc;  use Apache::loncacc;
 use Apache::loncommon();  use Apache::loncommon();
 use Apache::Log();  
 use Apache::lonnet;  use Apache::lonnet;
 use HTML::Entities();  use HTML::Entities();
 use Apache::lonlocal;  use Apache::lonlocal;
   use Apache::lonnet;
   use LONCAPA();
   
 my $DEBUG=0;  my $DEBUG=0;
   
 sub Debug {  sub Debug {
         # Put out the indicated message but only if DEBUG is true.
   # Marshall the parameters.      if ($DEBUG) {
      my ($r,$message) = @_;
   my $r       = shift;   $r->log_reason($message);
   my $log     = $r->log;      }
   my $message = shift;  
     
   # Put out the indicated message butonly if DEBUG is false.  
     
   if ($DEBUG) {  
     $log->debug($message);  
   }  
 }  }
   
 sub upfile_store {  sub upfile_store {
     my $r=shift;      my $r=shift;
   
     my $fname=$ENV{'form.upfile.filename'};      my $fname=$env{'form.upfile.filename'};
     $fname=~s/\W//g;      $fname=~s/\W//g;
           
     chomp($ENV{'form.upfile'});      chomp($env{'form.upfile'});
       
     my $datatoken=$ENV{'user.name'}.'_'.$ENV{'user.domain'}.      my $datatoken=$env{'user.name'}.'_'.$env{'user.domain'}.
   '_upload_'.$fname.'_'.time.'_'.$$;    '_upload_'.$fname.'_'.time.'_'.$$;
     {      {
        my $fh=Apache::File->new('>'.$r->dir_config('lonDaemons').         my $fh=Apache::File->new('>'.$r->dir_config('lonDaemons').
                                    '/tmp/'.$datatoken.'.tmp');                                     '/tmp/'.$datatoken.'.tmp');
        print $fh $ENV{'form.upfile'};         print $fh $env{'form.upfile'};
     }      }
     return $datatoken;      return $datatoken;
 }  }
   
   
 sub phaseone {  sub phaseone {
    my ($r,$fn,$uname,$udom)=@_;      my ($r,$fn,$uname,$udom,$mode)=@_;
    $ENV{'form.upfile.filename'}=~s/\\/\//g;      my $action = '/adm/upload';
    $ENV{'form.upfile.filename'}=~s/^.*\/([^\/]+)$/$1/;      if ($mode eq 'testbank') {
    if ($ENV{'form.upfile.filename'}) {          $action = '/adm/testbank';
     $fn=~s/\/[^\/]+$//;      } elsif ($mode eq 'imsimport') {
     $fn=~s/([^\/])$/$1\//;          $action = '/adm/imsimport';
     $fn.=$ENV{'form.upfile.filename'};      }
     $fn=~s/^\///;      $env{'form.upfile.filename'}=~s/\\/\//g;
     $fn=~s/(\/)+/\//g;      $env{'form.upfile.filename'}=~s/^.*\/([^\/]+)$/$1/;
       if ($env{'form.upfile.filename'}) {
    $fn=~s/\/[^\/]+$//;
    $fn=~s/([^\/])$/$1\//;
    $fn.=$env{'form.upfile.filename'};
    $fn=~s/^\///;
    $fn=~s/(\/)+/\//g;
   
 #    Fn is the full path to the destination filename.  #    Fn is the full path to the destination filename.
 #      #    
   
     &Debug($r, "Filename for upload: $fn");   &Debug($r, "Filename for upload: $fn");
     if (($fn) && ($fn!~/\/$/)) {   if (($fn) && ($fn!~/\/$/)) {
       $r->print(      $r->print('<form action="'.$action.'" method="post" name="fileupload">'.
  '<form action=/adm/upload method=post>'.        '<input type="hidden" name="phase" value="two" />'.
  '<input type=hidden name=phase value=two>'.        '<input type="hidden" name="datatoken" value="'.
  '<input type=hidden name=datatoken value="'.&upfile_store.'">'.        &upfile_store.'" />'.
  '<input type=hidden name=uploaduname value="'.$uname.'">'.        '<input type="hidden" name="uploaduname" value="'.$uname.
  &mt('Store uploaded file as ')."<tt>/priv/$uname/</tt>".        '" />'.&mt('Save uploaded file as ').
  '<input type=text size=50 name=filename value="'.$fn.'"><br>'.                        "<span class='LC_filename'>/priv/$uname/</span>".
  '<input type=submit value="'.&mt('Store').'"></form>');                        '<input type="text" size="50" name="filename" value="'.$fn.
       # Check for bad extension and warn user                        '" /><br />'.
       if ($fn=~/\.(\w+)$/ &&         '<br />'.&mt('Choose file type:').'
   (&Apache::loncommon::fileembstyle($1) eq 'hdn')) {  <select name="filetype">
   $r->print(   <option value="standard" selected>'.&mt('Regular file').'
  '<font color=red>'.   <option value="testbank">'.&mt('Testbank file').'
  &mt('The extension on this file,').' "'.$1.   <option value="imsimport">'.&mt('IMS package').'
  '"'.&mt(', is reserved internally by LON-CAPA.').' <br \>'.  </select>'.&Apache::loncommon::help_open_topic("Uploading_File_Options").'
  &mt('Please change the extension.').  <br />
  '</font>');  <br />
       } elsif($fn=~/\.(\w+)$/ &&   ');
       !defined(&Apache::loncommon::fileembstyle($1))) {              $r->print('<input type="button" value="'.&mt('Save').'" onClick="javascript:verifyForm()"/></form>');
   $r->print(      # Check for bad extension and warn user
  '<font color=red>'.      if ($fn=~/\.(\w+)$/ && 
  &mt('The extension on this file,').' "'.$1.   (&Apache::loncommon::fileembstyle($1) eq 'hdn')) {
  '"'.&mt(', is not recognized by LON-CAPA.').' <br \>'.   $r->print('<span class="LC_error">'.&mt('The extension on this file,').
  &mt('Please change the extension.').    ' "'.$1.'"'.&mt(', is reserved internally by LON-CAPA.').
  '</font>');    ' <br />'.&mt('Please change the extension.').'</span>');
       }      } elsif($fn=~/\.(\w+)$/ && 
   } else {      !defined(&Apache::loncommon::fileembstyle($1))) {
       $r->print('<font color=red>'.&mt('Illegal filename.').'</font>');   $r->print('<span class="LC_error">'.&mt('The extension on this file,').
   }    ' "'.$1.'"'.&mt(', is not recognized by LON-CAPA.').
  } else {    ' <br />'.&mt('Please change the extension.').
      $r->print('<font color=red>'.&mt('No upload file specified.').'</font>');    '</span>');
  }      }
    } else {
       $r->print('<span class="LC_error">'.&mt('Illegal filename.').'</span>');
    }
       } else {
    $r->print('<span class="LC_error">'.&mt('No upload file specified.').'</span>');
       }
 }  }
   
 sub phasetwo {  sub phasetwo {
    my ($r,$tfn,$uname,$udom)=@_;      my ($r,$tfn,$uname,$udom,$mode)=@_;
    my $fn='/priv/'.$uname.'/'.$tfn;      my $output;
    $fn=~s/\/+/\//g;      my $action = '/adm/upload';
    &Debug($r, "Filename is ".$tfn);      my $returnflag = '';
    if ($tfn) {      if ($mode eq 'testbank') {
     &Debug($r, "Filename for tfn = ".$tfn);          $action = '/adm/testbank';
     my $target='/home/'.$uname.'/public_html'.$tfn;      } elsif ($mode eq 'imsimport') {
     &Debug($r, "target -> ".$target);          $action = '/adm/imsimport';
       }
       my $fn='/priv/'.$uname.'/'.$tfn;
       $fn=~s/\/+/\//g;
       &Debug($r, "Filename is ".$tfn);
       if ($tfn) {
    &Debug($r, "Filename for tfn = ".$tfn);
    my $target='/home/'.$uname.'/public_html'.$tfn;
    &Debug($r, "target -> ".$target);
 #     target is the full filesystem path of the destination file.  #     target is the full filesystem path of the destination file.
    my $base = &File::Basename::basename($fn);
    my $path = &File::Basename::dirname($fn);
    $base    = &HTML::Entities::encode($base,'<>&"');
    my $url  = $path."/".$base; 
    &Debug($r, "URL is now ".$url);
    my $datatoken=$env{'form.datatoken'};
    if (($fn) && ($datatoken)) {
               if ($env{'form.cancel'}) {
                   my $source=$r->dir_config('lonDaemons').'/tmp/'.$datatoken.'.tmp';
                   my $dirpath=$path.'/';
                   $dirpath=~s/\/+/\//g;
                   $output .= &mt('Upload cancelled.').'<br /><font size="+2"><a href="'.$dirpath.'">'.
                             &mt('Back to Directory').'</a></font>';
       } elsif ((-e $target) && (!$env{'form.override'})) {
    $output .= '<form action="'.$action.'" method="post">'.
     &mt('File [_1] exists. Overwrite?','<span class="LC_filename">'.$fn.'</span>').
     '<input type="hidden" name="phase" value="two" />'.
     '<input type="hidden" name="filename" value="'.$url.'" />'.
     '<input type="hidden" name="datatoken" value="'.$datatoken.'" />'.
     '<input type="submit" name="override" value="'.&mt('Yes').'" />'.
                             '<input type="submit" name="cancel" value="'.&mt('Cancel').'" />'.
                             '</form>';
               } else {
    my $source=$r->dir_config('lonDaemons').'/tmp/'.$datatoken.'.tmp';
    my $dirpath=$path.'/';
    $dirpath=~s/\/+/\//g;
    # Check for bad extension and disallow upload
                   my $result;
                   ($result,$returnflag) = &check_extension($fn,$mode,$source,$target,$action,$dirpath,$url);
                   $output .= $result;
       }
    } else {
       $output .= '<span class="LC_error">'.
         &mt('Please use browser "Back" button and pick a filename').
         '</span><br />';
    }
       } else {
    $output .= '<span class="LC_error">'.
      &mt('Please use browser "Back" button and pick a filename').
      '</span><br />';
       }
       return ($output,$returnflag);
   }
   
   sub check_extension {
       my ($fn,$mode,$source,$target,$action,$dirpath,$url) = @_;
       my ($result,$returnflag);
       # Check for bad extension and disallow upload
       if ($fn=~/\.(\w+)$/ &&
           (&Apache::loncommon::fileembstyle($1) eq 'hdn')) {
           $result .= &mt('File [_1] could not be copied.',
                         '<span class="LC_filename">'.$fn.'</span> ').
                     '<br /><span class="LC_error">'.
                     &mt('The extension on this file is reserved internally by LON-CAPA.').
                     '</span>';
       } elsif ($fn=~/\.(\w+)$/ &&
                !defined(&Apache::loncommon::fileembstyle($1))) {
           $result .= &mt('File [_1] could not be copied.',
                         '<span class="LC_filename">'.$fn.'</span> ').
                     '<br /><span class="LC_error">'.
                     &mt('The extension on this file is not recognized by LON-CAPA.').
                     '</span>';
       } elsif (-d $target) {
           $result .= &mt('File [_1] could not be copied.',
                         '<span class="LC_filename">'.$fn.'</span>').
                     '<br /><span class="LC_error">'.
                     &mt('The target is an existing directory.').
                     '</span>';
       } elsif (copy($source,$target)) {
           chmod(0660, $target); # Set permissions to rw-rw---.
           if ($mode eq 'testbank' || $mode eq 'imsimport') {
               $returnflag = 'ok';
               $result .= &mt('Your file - [_1] - was uploaded successfully',$fn).'<br /><br />';
           } else {
               $result .= &mt('File copied.').'<br />';
           }
           # Check for embedded objects.
           my (%allfiles,%codebase);
           my ($text,$header,$css,$js);
           if (($mode ne 'imsimport') && ($target =~ /\.(htm|html|shtml)$/i)) {
               my (%allfiles,%codebase);
               &Apache::lonnet::extract_embedded_items($target,\%allfiles,\%codebase);
               if (keys(%allfiles) > 0) {
                   my $state = <<STATE;
       <input type="hidden" name="action"      value="upload_embedded" />
       <input type="hidden" name="currentpath" value="$env{'form.currentpath'}" />
       <input type="hidden" name="mode"        value="$mode" />
       <input type="hidden" name="phase"       value="three" />
       <input type="hidden" name="filename" value="$url" />
   STATE
                   $result .= "<h3>".&mt("Reference Warning")."</h3>".
                              "<p>".&mt("Completed upload of the file. This file contained references to other files.")."</p>".
                             "<p>".&mt("Please select the locations from which the referenced files are to be uploaded.")."</p>".
                             &Apache::loncommon::ask_for_embedded_content($action,$state,\%allfiles,\%codebase,
                                         {'error_on_invalid_names'   => 1,
                                          'ignore_remote_references' => 1,});
                   if ($mode eq 'testbank') {
                       $returnflag = 'embedded';
                       $result .=  '<p>'.&mt('Or [_1]continue[_2] the testbank import without these files','<a href="javascript:document.testbankForm.submit();">','</a>').'</p>';
                   }
               }
           }
           if (($mode ne 'imsimport') && ($mode ne 'testbank')) {
               $result .= '<br /><font size="+2"><a href="'.$url.'">'.
                           &mt('View file').'</a></font>';
           }
       } else {
           $result .= &mt('Failed to copy: [_1].',$!);
       }
       if ($mode ne 'imsimport' && $mode ne 'testbank') {
           $result .= '<br /><font size="+2"><a href="'.$dirpath.'">'.
                      &mt('Back to Directory').'</a></font><br />';
       }
       return ($result,$returnflag);
   }
   
   sub phasethree {
       my ($r,$fn,$uname,$udom,$mode) = @_;
       my $result;
       my $dir_root = '/home/'.$uname.'/public_html';
       my $url_root = '/priv/'.$uname;
     my $base = &File::Basename::basename($fn);      my $base = &File::Basename::basename($fn);
     my $path = &File::Basename::dirname($fn);      my $path = &File::Basename::dirname($fn);
     $base    = &HTML::Entities::encode($base);      $result = &Apache::loncommon::upload_embedded($mode,$path,$uname,$udom,
     my $url  = $path."/".$base;                                                     $dir_root,$url_root);
     &Debug($r, "URL is now ".$url);      if ($mode ne 'imsimport' && $mode ne 'testbank') {
     my $datatoken=$ENV{'form.datatoken'};          $result = '<br /><font size="+2"><a href="'.$url_root.$fn.'">'.
     if (($fn) && ($datatoken)) {                    &mt('View main file').'</a></font>'.
  if ((-e $target) && ($ENV{'form.override'} ne 'Yes')) {                    '<br /><font size="+2"><a href="'.$url_root.$path.'">'.
            $r->print(                    &mt('Back to Directory').'</a></font><br />';
  '<form action=/adm/upload method=post>'.      }
  &mt('File').' <tt>'.$fn.'</tt> '.&mt('exists. Overwrite?').' '.      return $result;
  '<input type=hidden name=phase value=two>'.  
  '<input type=hidden name=filename value="'."$url".'">'.  
  '<input type=hidden name=datatoken value="'.$datatoken.'">'.  
  '<input type=submit name=override value="'.&mt('Yes').'"></form>');  
        } else {  
            my $source=$r->dir_config('lonDaemons').  
                              '/tmp/'.$datatoken.'.tmp';  
            # Check for bad extension and disallow upload  
    if ($fn=~/\.(\w+)$/ &&   
        (&Apache::loncommon::fileembstyle($1) eq 'hdn')) {  
        $r->print(  
  &mt('File').' <tt>'.$fn.'</tt> '.&mt('could not be copied.').'<br />'.  
  '<font color=red>'.  
  &mt('The extension on this file is reserved internally by LON-CAPA.').  
  '</font>');  
               $r->print('<p><font size=+2><a href="'.$path.  
                         '">'.&mt('Back to Directory').'</a></font>');  
    } elsif ($fn=~/\.(\w+)$/ &&   
     !defined(&Apache::loncommon::fileembstyle($1))) {  
        $r->print(  
  &mt('File').' <tt>'.$fn.'</tt> '.&mt('could not be copied.').'<br />'.  
  '<font color=red>'.  
  &mt('The extension on this file is not recognized by LON-CAPA.').  
  '</font>');  
        $r->print('<p><font size=+2><a href="'.$path.  
                         '">'.&mt('Back to Directory').'</a></font>');  
    } elsif (-d $target) {  
        $r->print(  
  'File <tt>'.$fn.'</tt> could not be copied.<br />'.  
  '<font color=red>'.  
  &mt('The target is an existing directory.').  
  '</font>');  
        $r->print('<p><font size=+2><a href="'.$path.  
                         '">'.&mt('Back to Directory').'</a></font>');  
    } elsif (copy($source,$target)) {  
        chmod(0660, $target); # Set permissions to rw-rw---.  
       $r->print(&mt('File copied.'));  
               $r->print('<p><font size=+2><a href="'.$url.  
                         '">'.&mt('View file').'</a></font>');  
               $r->print('<p><font size=+2><a href="'.$path.  
                         '">'.&mt('Back to Directory').'</a></font>');  
    } else {  
               $r->print('Failed to copy: '.$!);  
               $r->print('<p><font size=+2><a href="'.$path.  
                         '">'.&mt('Back to Directory').'</a></font>');  
    }  
        }  
     } else {  
        $r->print(  
    '<font size=+1 color=red>'.  
 &mt('Please use browser "Back" button and pick a filename').'</font><p>');  
     }  
   } else {  
     $r->print(  
    '<font size=+1 color=red>'.&mt('Please use browser "Back" button and pick a filename').'</font><p>');  
   }  
 }  }
   
 # ---------------------------------------------------------------- Main Handler  # ---------------------------------------------------------------- Main Handler
 sub handler {  sub handler {
   
   my $r=shift;      my $r=shift;
   
   my $uname;      my $uname;
   my $udom;      my $udom;
       my $javascript = '';
 #  #
 # phase two: re-attach user  # phase two: re-attach user
 #  #
   if ($ENV{'form.uploaduname'}) {      if ($env{'form.uploaduname'}) {
       $ENV{'form.filename'}='/priv/'.$ENV{'form.uploaduname'}.'/'.   $env{'form.filename'}='/priv/'.$env{'form.uploaduname'}.'/'.
   $ENV{'form.filename'};      $env{'form.filename'};
   }      }
 #  
   
   ($uname,$udom)=      unless ($env{'form.phase'} eq 'two') {
     &Apache::loncacc::constructaccess(          $javascript = qq|
  $ENV{'form.filename'},$r->dir_config('lonDefDomain'));  function verifyForm() {
   unless (($uname) && ($udom)) {      var mode = document.fileupload.filetype.options[document.fileupload.filetype.selectedIndex].value
      $r->log_reason($uname.' at '.$udom.      if (mode == "testbank") {
          ' trying to publish file '.$ENV{'form.filename'}.          document.fileupload.action = "/adm/testbank";
          ' - not authorized',       }
          $r->filename);       if (mode == "imsimport") {
      return HTTP_NOT_ACCEPTABLE;          document.fileupload.action = "/adm/imsimport";
   }      }
       if (mode == "standard") {
   my $fn;          document.fileupload.action = "/adm/upload";
   if ($ENV{'form.filename'}) {      }
       $fn=$ENV{'form.filename'};      document.fileupload.submit();
       $fn=~s/^http\:\/\/[^\/]+\///;  }
       $fn=~s/^\///;   |;
       $fn=~s/(\~|priv\/)(\w+)//;      }
       $fn=~s/\/+/\//g;      ($uname,$udom)=
   } else {   &Apache::loncacc::constructaccess($env{'form.filename'},
      $r->log_reason($ENV{'user.name'}.' at '.$ENV{'user.domain'}.    $r->dir_config('lonDefDomain'));
          ' unspecified filename for upload', $r->filename);   
      return HTTP_NOT_FOUND;      unless (($uname) && ($udom)) {
   }   $r->log_reason($uname.' at '.$udom.
          ' trying to publish file '.$env{'form.filename'}.
          ' - not authorized', 
          $r->filename); 
    return HTTP_NOT_ACCEPTABLE;
       }
       
       my $fn;
       if ($env{'form.filename'}) {
    $fn=$env{'form.filename'};
    $fn=~s/^http\:\/\/[^\/]+\///;
    $fn=~s/^\///;
    $fn=~s{(~|priv/)($LONCAPA::username_re)}{};
    $fn=~s/\/+/\//g;
       } else {
    $r->log_reason($env{'user.name'}.' at '.$env{'user.domain'}.
          ' unspecified filename for upload', $r->filename); 
    return HTTP_NOT_FOUND;
       }
   
 # ----------------------------------------------------------- Start page output  # ----------------------------------------------------------- Start page output
   
   
   &Apache::loncommon::content_type($r,'text/html');      &Apache::loncommon::content_type($r,'text/html');
   $r->send_http_header;      $r->send_http_header;
   
   $r->print('<html><head><title>LON-CAPA Construction Space</title></head>');     $javascript = "<script type=\"text/javascript\">\n//<!--\n".
    $javascript."\n// --></script>\n";
   
   $r->print(&Apache::loncommon::bodytag('Upload file to Construction Space'));      $r->print(&Apache::loncommon::start_page('Upload file to Construction Space',
        $javascript));
       
   if (($uname ne $ENV{'user.name'}) || ($udom ne $ENV{'user.domain'})) {      if (($uname ne $env{'user.name'}) || ($udom ne $env{'user.domain'})) {
       $r->print('<h3><font color=red>'.&mt('Co-Author').': '.$uname.   $r->print('<h3><span class="LC_error">'.&mt('Co-Author').': '.$uname.
  &mt(' at ').$udom.'</font></h3>');    &mt(' at ').$udom.'</span></h3>');
   }      }
   
   if ($ENV{'form.phase'} eq 'two') {  
       &phasetwo($r,$fn,$uname,$udom);  
   } else {  
       &phaseone($r,$fn,$uname,$udom);  
   }  
   
   $r->print('</body></html>');      if ($env{'form.phase'} eq 'three') {
   return OK;            my $output = &phasethree($r,$fn,$uname,$udom,'author');
           $r->print($output);
       } elsif ($env{'form.phase'} eq 'two') {
    my ($output,$returnflag) = &phasetwo($r,$fn,$uname,$udom);
           $r->print($output);
       } else {
    &phaseone($r,$fn,$uname,$udom);
       }
   
       $r->print(&Apache::loncommon::end_page());
       return OK;  
 }  }
   
 1;  1;
 __END__  __END__
   
 =head1 NAME  
   
 Apache::lonupload - upload files into construction space  
   
 =head1 SYNOPSIS  
   
 Invoked by /etc/httpd/conf/srm.conf:  
   
  <Location /adm/upload>  
  PerlAccessHandler       Apache::lonacc  
  SetHandler perl-script  
  PerlHandler Apache::lonupload  
  ErrorDocument     403 /adm/login  
  ErrorDocument     404 /adm/notfound.html  
  ErrorDocument     406 /adm/unauthorized.html  
  ErrorDocument  500 /adm/errorhandler  
  </Location>  
   
 =head1 INTRODUCTION  
   
 This module uploads a file sitting on a client computer into   
 library server construction space.  
   
 This is part of the LearningOnline Network with CAPA project  
 described at http://www.lon-capa.org.  
   
 =head1 HANDLER SUBROUTINE  
   
 This routine is called by Apache and mod_perl.  
   
 =over 4  
   
 =item *  
   
 Initialize variables  
   
 =item *  
   
 Start page output  
   
 =item *  
   
 output relevant interface phase (phaseone or phasetwo)  
   
 =item *  
   
 (phase one is to specify upload file; phase two is to handle conditions  
 subsequent to specification--like overwriting an existing file)  
   
 =back  
   
 =head1 OTHER SUBROUTINES  
   
 =over 4  
   
 =item *  
   
 phaseone() : Interface for specifying file to upload.  
   
 =item *  
   
 phasetwo() : Interface for handling post-conditions about uploading (such  
 as overwriting an existing file).  
   
 =item *  
   
 upfile_store() : Store contents of uploaded file into temporary space.  Invoked  
 by phaseone subroutine.  
   
 =back  
   
 =cut  

Removed from v.1.21  
changed lines
  Added in v.1.40


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>