CGI (Common Gateway Interface)

Preview:

DESCRIPTION

CGI (Common Gateway Interface). CmpE 587 Emir Bayraktar Onur Bük. Overview. What is CGI ? How it works Perl Language Cgi Environment Variables Get & POST Methods Server-Side Includes (SSI). What is CGI ?. It stands for Common Gateway Interface It is a way of programming for the web - PowerPoint PPT Presentation

Citation preview

1

CGI(Common Gateway Interface)

CmpE 587

Emir BayraktarOnur Bük

2

Overview

What is CGI ? How it works Perl Language Cgi Environment Variables Get & POST Methods Server-Side Includes (SSI)

3

What is CGI ? It stands for Common Gateway

Interface It is a way of programming for the

web It is a server-side technology It makes web-pages dynamic

4

Basics of CGI CGI can be written with many

languages Most popular are PERL and C Our choose is PERL because...

PERL is standard on UNIX systems PERL is very easy and robust It also runs on WindowsNT

5

How it works ? CGI combines HTML tags with

program statements HTML tags are for appearance and

visuality PERL codes are for functionality The result are functional and nice

web-pages

6

Before we begin PERL is an interpreted language You write the script and it runs But only if it is error-free A simple text editor is enough No additional software required

7

Let’s begin with the first script

We need to know where PERL runs %>whereis perl or %> which perl /usr/bin/perl

The first line of our script would be #!/usr/bin/perl

As the result must be an HTML code print “Content-type:text/html\n\n”;

8

Default First Script : “HELLO WORLD”

#!/usr/bin/perl

print “Content-type:text/html\n\n”;

print “<html><head><title>HELLO

</title></head>\n”;

print “<body>\n”;

print “<h2>HELLO WORLD</h2>\n”;

print “</body></html>\n”;

9

PERL Variables

Like many other programming languages, PERL has different kinds of variables SCALAR VARIABLES ==> $scalar ARRAY VARIABLES ==> @array HASH VARIABLES ==> %hash

10

Scalar Variables

A scalar variable stores a scalar value. They have the prefix $. They can contain any kind of data like numbers, characters or a string. $num=5; $name=“John”;

You can input data to a scalar variable with $name=<STDIN>;

11

Array Variables

An array stores list of information. They have the prefix @. The arrays start with the index 0. If you refer to a single element of the array, you use the prefix $ with the index. For example @city=(“ist”,“ankara”,“izmir”); $city[0] =“ist” $city[2] =“izmir”

12

Hash Variables

Hash variables are a special kind of arrays. They contain paired groups of elements. Each pair consists of a key and data value. They have the prefix %. %pages = ( ”Yahoo" => "http://www.yahoo.com",

”Mail" => "http://www.hotmail.com",

”Uni" => "http://www.boun.edu.tr“ );

13

CGI Environment Variables

These are a series of hidden values that the web server sends to every CGI you run. They are stored in a hash called %ENV. Some of them are… DOCUMENT_ROOT:The root directory of your

server HTTP_HOST:The hostname of your server REMOTE_ADDR:The IP address of the visitor REMOTE_HOST:The hostname of the visitor SERVER_NAME:Your server's qualified domain

name

14

Properties of %ENV

The %ENV hash is set for every CGI, and you can use any or all of it as needed. For example, you can write the IP address of the visitor with the command: print “Your IP =$ENV{‘REMOTE_ADDR'}\n";

print “Your Port =$ENV{‘REMOTE_PORT’}\n”; print “Your Browser =$ENV{‘HTTP_USER_AGENT’}\n”;

15

Some examples using %ENV

Let’s find the IP address of the visitor...#!usr/bin/perl

print “Content-type:text/html\n\n”;

print <<Finish

<html><head><title>IP</title></head>

<body>

Your IP address: $ENV{‘REMOTE_ADDR’}

</body></html>

Finish

16

GET and POST

We use GET and POST in order to send data from an HTML document to a CGI program.

GET: The input values are sent as part of the URL, saved in the QUERY_STRING environment variable.

POST: Data are sent as input stream to the program

17

A simple example with GET

We will write a simple CGI script which takes data input from and sends the data with the ‘QUERY_STRING’. The working part of the code is as follows:#!/usr/bin/perl

print “Content-type:text/html\n\n”

print <<Finish

<html><head><title>CMPE587</title></head>

<body>

18

A simple example with GET (cont’d)

<h2>This page collects info about you</h2>

<form action:“http://www.students.itu.edu.tr/~bayraktara/cgi-bin/info.cgi” method=“GET”>

Name:<input type=“text” name=“name” size=20>

<p>

Surname:<input type=“text” name=“sname” size=30><p>

<input type=“submit” value=“submit”>

Finish

19

A simple example with GET (cont’d)

20

There are two important results

If we look at the %ENV variable we would see that $ENV{‘QUERY_STRING’}= name=Ali+Veli&sname=Yilmaz

The second result is that the address bar of the result page would look like

21

How to filter unwanted characters

There are some unwanted characters in the string: “=” , “+” and “&”. “+” stands for space and “&” separates input values. name=Ali+Veli&sname=Yilmaz

First we have to split “name” and “sname”. Fortunately, PERL has a “split” command. @val=split(/&/,$ENV{‘QUERY_STRING’}) @val=(“name=Ali+Veli”,”sname=Yilmaz”)

22

How to filter unwanted characters (cont’d)

We have now an array variable. We use the split command for the second time in order to filter “=“ character. As we have many input values we use such a code: foreach $ran (@val) {

($field, $value)= split(/=/,$ran);print “$field = $value\n”;}

23

Advantages and disadvantages of GET

It is very simple to collect data and process it. You can make forms very easily. This is an advantage.

It is not secure. The data that will be sent is a part of the URL. It can be easily obtained by others.

24

An example with POST

POST is another method of sending data but it is much more secure than GET. Data will be sent after encoding. It can also send more data according to GET. Encoding requires decoding and this increases the complexity of the script.

The decoding tasks are performed by PERL with some simple commands.

25

Decoding Commands

There are two basic decoding commands. These are substitute and translate.

The syntax for substitute is:$varia =~ s/pattern/replacement

An example clears all: $greeting = “Hello name.\n”;

$greeting = ~s/name/Ali/;

print $greeting;

26

Decoding Commands

The syntax for translate is: $varia =~ tr/searchlist/replacelist The translate command turns every

character in the searchlist to its corresponding character in the replacelist

The upper&lower case transformation can easily be done with

$lower =~ tr/[A-Z]/[a-z]

$upper =~ tr/[a-z]/[A-Z]

27

How to decode data streams

We have seen how to split a data stream. Now , we have to decode the stream with translate and substitute.$value =~ tr/+/ /;

$value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack(“C”, hex($1))/eg;

28

How we get POST dataread (STDIN, $ENV{‘CONTENT_LENGTH’});

@pairs=split(/&/,$buffers);

Foreach $pair(@pairs){

($varname,$value)=split(/=/,$pair);,

$value =~ tr/+/ /;

$value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack(“C”, hex($1))/eg;

$FORM{$varname}=$value;

}

29

Server-Side Includes(SSI) Embedded code section in an HTML

document. Dependent on type of server Server

parses SSI code executes it sends the results to the client

30

Server-Side Includes (cont’d) How does the server understand

that the HTML file contains SSI code? The file extension is converted to

shtml or The access rights for the file is 755

(in UNIX environment)

31

SSI Structure <!--#element property=value

property=value -- > Ex:

<!--#include file=“bodybar” -- > <!--#flatsmode

virtual=“/includes/flashes.inc” -- > <!--#exec cgi=“/cgi-bin/a.cgi” -- >

32

Database Connectivity Uses Perl’s DBI Module Ex (pseudocode):

use DBI;$dbh=DBI->Connect(“dbi:mysql:dbname”,”username”,”pswd”);

$sth=$dbh->prepare(“sql query”);$sth.execute;while(($var1,$var2,$var3)=$sth->fetchrow){use variables$dbh->disconnect}

33

Thank You!

Please ask any questions you may have.

34

İyi Bayramlar!

Recommended