--- loncom/cgi/loncgi.pm 2003/10/09 22:04:37 1.1 +++ loncom/cgi/loncgi.pm 2013/05/13 01:26:54 1.13 @@ -1,7 +1,7 @@ # # LON-CAPA helpers for cgi-bin scripts # -# $Id: loncgi.pm,v 1.1 2003/10/09 22:04:37 matthew Exp $ +# $Id: loncgi.pm,v 1.13 2013/05/13 01:26:54 raeburn Exp $ # # Copyright Michigan State University Board of Trustees # @@ -36,8 +36,8 @@ loncgi =head1 SYNOPSIS -Provides subroutines for checking a LON-CAPA cookie and loading the users -environment. +Provides subroutines for checking a LON-CAPA cookie, loading the user's +environment, and retrieving arguments passed in via a CGI's Query String. =head1 Subroutines @@ -52,10 +52,16 @@ package LONCAPA::loncgi; use strict; use warnings FATAL=>'all'; no warnings 'uninitialized'; -use CGI(); + +use lib '/home/httpd/lib/perl/'; +use CGI qw(:standard); use CGI::Cookie(); +use MIME::Types(); use Fcntl qw(:flock); +use LONCAPA; use LONCAPA::Configuration(); +use GDBM_File; +use Apache::lonlocal; my $lonidsdir; @@ -65,24 +71,32 @@ BEGIN { $lonidsdir = $perlvar->{'lonIDsDir'}; } + ############################################# ############################################# =pod -=item check_cookie_and_load_env +=item check_cookie_and_load_env() -Inputs: none +Inputs: 1 ( optional). When called from a handler in mod_perl, + pass in the request object. Returns: 1 if the user has a LON-CAPA cookie 0 if not. -Loads the users environment into the %ENV hash if the cookie is correct. +Loads the users environment into the %env hash if the cookie is correct. =cut ############################################# ############################################# sub check_cookie_and_load_env { - my %cookies=fetch CGI::Cookie; + my ($r) = @_; + my %cookies; + if (ref($r)) { + %cookies = CGI::Cookie->fetch($r); + } else { + %cookies = CGI::Cookie->fetch(); + } if (exists($cookies{'lonID'}) && -e "$lonidsdir/".$cookies{'lonID'}->value.".id") { # cookie found @@ -99,7 +113,7 @@ sub check_cookie_and_load_env { =pod -=item check_cookie +=item check_cookie() Inputs: none @@ -126,9 +140,9 @@ sub check_cookie { =pod -=item transfer_profile_to_env +=item transfer_profile_to_env() -Load the users environment into the %ENV hash. +Load the users environment into the %env hash. Inputs: $handle, the name of the users LON-CAPA cookie. @@ -140,19 +154,12 @@ Returns: undef ############################################# sub transfer_profile_to_env { my ($handle)=@_; - my @profile; - { - open(IDFILE, "<$lonidsdir/$handle.id"); - flock(IDFILE,LOCK_SH); - @profile=; - close(IDFILE); - } - foreach my $envrow (@profile) { - chomp($envrow); - my ($envname,$envvalue)=split(/=/,$envrow); - $ENV{$envname} = $envvalue; + if (tie(my %disk_env,'GDBM_File',"$lonidsdir/$handle.id",&GDBM_READER(), + 0640)) { + %Apache::lonnet::env = %disk_env; + untie(%disk_env); } - $ENV{'user.environment'} = "$lonidsdir/$handle.id"; + $Apache::lonnet::env{'user.environment'} = "$lonidsdir/$handle.id"; return undef; } @@ -161,6 +168,97 @@ sub transfer_profile_to_env { =pod +=item missing_cookie_msg() + +Inputs: none +Returns: HTML for a page indicating cookie information absent. + +=cut + +############################################# +############################################# +sub missing_cookie_msg { + my %lt = &Apache::lonlocal::texthash ( + cook => 'Bad Cookie', + your => 'Your cookie information is incorrect.', + ); + return < +$lt{'cook'} + +$lt{'your'} + + +END + +} + +############################################# +############################################# + +=pod + +=cgi_getitems() + +Inputs: $query (the CGI query string), and $getitems, a reference to a hash + +Returns: nothing + +Side Effects: populates $getitems hash ref with key => value + where each key is the name of the form item in the query string + and value is an array of corresponding values. + +=cut + +############################################# +############################################# +sub cgi_getitems { + my ($query,$getitems)= @_; + foreach (split(/&/,$query)) { + my ($name, $value) = split(/=/,$_); + $name = &unescape($name); + $value =~ tr/+/ /; + $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg; + push(@{$$getitems{$name}},$value); + } + return; +} + +############################################# +############################################# + +=pod + +=cgi_header() + +Inputs: $contenttype - Content Type (e.g., text/html or text/plain) + $nocache - Boolean 1 = nocache +Returns: HTTP Response headers constructed using CGI.pm + +=cut + +############################################# +############################################# +sub cgi_header { + my ($contenttype,$nocache) = @_; + my $mimetypes = MIME::Types->new; + my %headers; + if ($contenttype ne '') { + if ($mimetypes->type($contenttype) ne '') { + $headers{'-type'} = $contenttype; + } + } + if ($nocache) { + $headers{'-expires'} = 'now'; + } + if (%headers) { + return CGI::header(%headers); + } + return; +} + +=pod + =back =cut