Lập trình CGI trong Python
CGI (là viết tắt của Common Gateway Interface) là một tập hợp các chuẩn mà định nghĩa cách thông tin được trao đổi giữa Web Server và một Custom Script. Phiên bản CGI hiện tại là CGI/1.1. Cấu hình Web Server Trước khi tiến hành lập trình CGI, bạn đảm bảo rằng Web Server của bạn hỗ trợ CGI ...
CGI (là viết tắt của Common Gateway Interface) là một tập hợp các chuẩn mà định nghĩa cách thông tin được trao đổi giữa Web Server và một Custom Script. Phiên bản CGI hiện tại là CGI/1.1.
Cấu hình Web Server
Trước khi tiến hành lập trình CGI, bạn đảm bảo rằng Web Server của bạn hỗ trợ CGI và được cấu hình để xử lý các chương trình CGI. Tất cả chương trình CGI được thực thi bởi HTTP đều được giữ trong một thư mục đã được cấu hình trước.
Thư mục này được gọi là CGI Directory và theo qui ước nó được đặt tên dạng /var/www/cgi-bin. Các CGI file có đuôi là .cgi, nhưng bạn cũng có thể giữ các file trong .py.
Theo mặc định, Linux Server được cấu hình để chạy các script trong thư mục cgi-bin trong /var/www. Nếu bạn muốn xác định bất kỳ thư mục nào khác để chạy CGI script của bạn, thì bạn comment các dòng sau trong httpd.conf file:
<Directory "/var/www/cgi-bin"> AllowOverride None Options ExecCGI Order allow,deny Allow from all </Directory> <Directory "/var/www/cgi-bin"> Options All </Directory>
Chương trình CGI đầu tiên
Dưới đây là một CGI script có tên là hello.py, được giữ trong thư mục /var/www/cgi-bin. Trước khi chạy, bạn cần thay đổi mode của file này bởi sử dụng chmod 755 hello.py để làm file này có thể thực thi.
print "Content-type:text/html " print '<html>' print '<head>' print '<title>Lap trinh CGI trong Python</title>' print '</head>' print '<body>' print '<h2>Day la chuong trinh CGI dau tien trong Python</h2>' print '</body>' print '</html>'
Kết quả là:
Day la chuong trinh CGI dau tien trong Python |
Đây là một Python script đơn giản để viết kết quả trên STDOUT chuẩn là màn hình. Dòng Content-type:text/html được gửi trở lại trình duyệt và nó xác định kiểu nội dung để được hiển thị trên màn hình trình duyệt.
HTTP Header
Dòng Content-type:text/html là một phần của HTTP Header mà được gửi tới trình duyệt để giúp trình duyệt hiểu nội dung cần được hiển thị. Tất cả HTTP Header sẽ là trong form sau:
HTTP Ten Truong: Noi Dung Cua Truong Vi du Content-type: text/html
Dưới đây là một số HTTP Header quan trọng khác mà bạn sẽ sử dụng thường xuyên trong lập trình CGI:
| Header | Miêu tả |
|---|---|
| Content-type: | Một chuỗi MIME định nghĩa định dạng của file được trả về. Ví dụ Content-type:text/html |
| Expires: Date | Ngày mà thông tin trở nên hết hiệu lực. Nó được sử dụng bởi trình duyệt để xác định khi nào trang cần được refresh. Một chuỗi date hợp lệ là trong định dạng 01 Jan 1998 12:00:00 GMT. |
| Location: URL | URL mà được trả về thay cho URL đã được yêu cầu. Bạn có thể sử dụng trường này để chuyển hướng một yêu cầu tới bất kỳ file nào |
| Last-modified: Date | Ngày sửa đổi cuối cùng của nguồn |
| Content-length: N | Độ dài (số byte) của dữ liệu đang được trả về. Trình duyệt sử dụng giá trị này để báo cáo thời gian download ước lượng cho một file |
| Set-Cookie: String | Thiết lập cookie được truyền thông qua String |
Các biến môi trường của CGI
Tất cả chương trình CGI có quyền truy cập tới các biến môi trường sau. Các biến này đóng một vai trò quan trọng trong khi viết bất cứ chương trình CGI nào.
| Tên biến | Miêu tả |
|---|---|
| CONTENT_TYPE | Kiểu dữ liệu của nội dung. Được sử dụng khi Client đang gửi nội dung đính kèm tới Server. Ví dụ: file upload |
| CONTENT_LENGTH | Độ dài của thông tin truy vấn. Chỉ có sẵn cho các yêu cầu POST |
| HTTP_COOKIE | Trả về các Cookie đã thiết lập trong dạng là cặp key/value |
| HTTP_USER_AGENT | Trường User-Agent chứa thông tin về user agent tạo yêu cầu. Đây là tên của trình duyệt web |
| PATH_INFO | Path cho CGI script |
| QUERY_STRING | Thông tin mã hóa URL được gửi với phương thức GET |
| REMOTE_ADDR | Địa chỉ IP của host từ xa mà tạo yêu cầu. Biến này hữu ích cho log và xác nhận |
| REMOTE_HOST | Tên đầy đủ của host tạo yêu cầu. Nếu thông tin này không có sẵn, thì REMOTE_ADDR có thể được sử dụng để lấy địa chỉ IP |
| REQUEST_METHOD | Phương thức được sử dụng để tạo yêu cầu. Phương thức được sử dụng phổ biên là GET và POST |
| SCRIPT_FILENAME | Path đầy đủ tới CGI script |
| SCRIPT_NAME | Tên của CGI script |
| SERVER_NAME | Tên của CGI script |
| SERVER_SOFTWARE | Tên và phiên bản của phần mềm mà Server đang chạy trên đó |
Chương trình CGI sau sẽ liệt kê tất cả các biến CGI.
import os print "Content-type: text/html "; print "<font size=+1>Environment</font><r>"; for param in os.environ.keys(): print "<b>%20s</b>: %s<r>" % (param, os.environ[param])
Truyền thông tin bởi sử dụng phương thức GET
Phương thức GET gửi thông tin người dùng đã mã hóa được phụ thêm tới yêu cầu trang. Trang và thông tin mã hóa được phân biệt bởi ký tự ? như sau:
http://www.test.com/cgi-bin/hello.py?key1=value1&key2=value2
Phương thức GET là phương thức mặc định để truyền thông tin từ trình duyệt tới Web Server và nó tạo ra một chuỗi dài xuất hiện trong Location:box của trình duyệt.
Nếu bạn có password hoặc bất cú thông tin nhạy cảm nào khác cần truyền tới Server thì bạn đừng bao giờ sử dụng phương thức GET. Phương thức GET có giới hạn kích cỡ: chỉ có 1024 ký tự có thể được gửi trong một chuỗi yêu cầu. Phương thức GET gửi thông tin bởi QUERY_STRING Header và sẽ là có thể truy cập trong chương trìn CGI thông qua biến môi trường QUERY_STRING.
Bạn có thể truyền thông tin bằng cách đơn giản là nối chuỗi các cặp key và value cùng với bất cứ URL nào hoặc bạn có thể sử dụng thẻ form trong HTML.
Phương thức GET: Ví dụ URL đơn giản
URL đơn giản sau sẽ truyền hai giá trị tới chương trình hello_get.py bởi sử dụng phương thức GET.
/cgi-bin/hello_get.py?first_name=HOANG&last_name=NGUYEN
Dưới đây là hello_get.py để xử lý đầu vào đã được cung cấp bởi trình duyệt web. Chúng ta đang sử dụng cgi Module giúp cho việc truy cập thông tin đã truyền được dễ dàng hơn.
# Import cac module de xu ly CGI
import cgi, cgitb
# Tao instance cua FieldStorage
form = cgi.FieldStorage()
# Lay du lieu tu cac truong
first_name = form.getvalue('first_name')
last_name = form.getvalue('last_name')
print "Content-type:text/html
"
print "<html>"
print "<head>"
print "<title>Chuong trinh CGI thu hai</title>"
print "</head>"
print "<body>"
print "<h2>Hello %s %s</h2>" % (first_name, last_name)
print "</body>"
print "</html>"
Phương thức GET: Ví dụ FORM đơn giản
Ví dụ sau sẽ truyền hai giá trị bởi sử dụng HTML form và nút submit. Chúng ta sử dụng hello_get.py giống như trên để xử lý đầu vào này.
<form action="/cgi-bin/hello_get.py" method="get"> First Name: <input type="text" name="first_name"> <br /> Last Name: <input type="text" name="last_name" /> <input type="submit" value="Submit" /> </form>
Truyền thông tin bởi sử dụng phương thức POST
Một phương thức đáng tin cậy hơn để truyền thông tin tới một chương trình CGI là phương thức POST. Phương thức này đóng gói thông tin theo đúng như cách của phương thức GET, nhưng thay vì gửi nó dưới dạng một chuỗi text sau một dấu ? trong URL, thì nó gửi dưới dạng một thông điệp riêng rẽ. Thông điệp này vào trong CGI script trong dạng đầu vào chuẩn.
Ví dụ sau cũng sử dụng hello_get.py ở trên.
# Import cac module de xu ly CGI
import cgi, cgitb
# Tao instance cua FieldStorage
form = cgi.FieldStorage()
# Lay du lieu tu cac truong
first_name = form.getvalue('first_name')
last_name = form.getvalue('last_name')
print "Content-type:text/html
"
print "<html>"
print "<head>"
print "<title>Chuong trinh CGI thu hai</title>"
print "</head>"
print "<body>"
print "<h2>Hello %s %s</h2>" % (first_name, last_name)
print "</body>"
print "</html>"
Sử dụng lại ví dụ trên để truyền hai giá trị bởi sử dụng HTML form và nút submit.
<form action="/cgi-bin/hello_get.py" method="post"> First Name: <input type="text" name="first_name"><br /> Last Name: <input type="text" name="last_name" /> <input type="submit" value="Submit" /> </form>
Truyền Checkbox tới chương trình CGI
HTML code sau là cho một form với hai checkbox:
<form action="/cgi-bin/checkbox.cgi" method="POST" target="_blank"> <input type="checkbox" name="toan" value="on" /> Toan <input type="checkbox" name="vatly" value="on" /> VatLy <input type="submit" value="Chon Mon Hoc" /> </form>
Dưới đây là checkbox.cgi để xử lý đầu vào được cung cấp bởi trình duyệt web:
# Import cac module de xu ly CGI
import cgi, cgitb
# Tao instance cua FieldStorage
form = cgi.FieldStorage()
# Lay du lieu tu cac truong
if form.getvalue('toan'):
toan_flag = "ON"
else:
toan_flag = "OFF"
if form.getvalue('vatly'):
vatly_flag = "ON"
else:
vatly_flag = "OFF"
print "Content-type:text/html
"
print "<html>"
print "<head>"
print "<title>Vi du Checkbox</title>"
print "</head>"
print "<body>"
print "<h2> Mon Toan la : %s</h2>" % toan_flag
print "<h2> Mon Vat Ly la : %s</h2>" % vatly_flag
print "</body>"
print "</html>"
Truyền RadioButton tới chương trình CGI
HTML code sau cho một form với hai Radiobutton:
<form action="/cgi-bin/radiobutton.py" method="post" target="_blank"> <input type="radio" name="subject" value="toan" /> Toan <input type="radio" name="subject" value="vatly" /> VatLy <input type="submit" value="Chon Mon Hoc" /> </form>
Và đây là radiobutton.py để xử lý đầu vào được cung cấp bởi trình duyệt web:
# Import cac module de xu ly CGI
import cgi, cgitb
# Tao instance cua FieldStorage
form = cgi.FieldStorage()
# Lay du lieu tu cac truong
if form.getvalue('subject'):
subject = form.getvalue('subject')
else:
subject = "Khong duoc thiet lap"
print "Content-type:text/html
"
print "<html>"
print "<head>"
print "<title>Vi du Radio button</title>"
print "</head>"
print "<body>"
print "<h2> Mon hoc ban da chon la %s</h2>" % subject
print "</body>"
print "</html>"
Ví dụ File Upload
Để upload một file, HTML form phải có thuộc tính enctype được thiết lập thành multipart/form-data.
<html>
<body>
<form enctype="multipart/form-data"
action="save_file.py" method="post">
<p>File: <input type="file" name="filename" /></p>
<p><input type="submit" value="Upload" /></p>
</form>
</body>
</html>
Dưới đây là save_file.py để xử lý file upload:
import cgi, os
import cgitb; cgitb.enable()
form = cgi.FieldStorage()
# Lay ten file o day.
fileitem = form['filename']
# Kiem tra xem file da duoc upload chua
if fileitem.filename:
fn = os.path.basename(fileitem.filename)
open('/tmp/' + fn, 'wb').write(fileitem.file.read())
message = 'File co ten la "' + fn + '" duoc upload thanh cong'
else:
message = 'Khong co file nao duoc upload'
print """
Content-Type: text/html
<html>
<body>
<p>%s</p>
</body>
</html>
""" % (message,)
Sử dụng Cookie
Cookie là bản ghi dữ liệu thuần text của 5 trường biến sau:
Thiết lập cookie
Để gửi cookie tới trình duyệt là khá dễ dàng. Các cookie này được gửi cùng với HTTP Header, ở trước trường Content-type. Giả sử bạn muốn thiết lập UserID và Password là các cookie, thì việc này được thực hiện như sau:
print "Set-Cookie:UserID=XYZ; " print "Set-Cookie:Password=XYZ123; " print "Set-Cookie:Expires=Tuesday, 31-Nov-2015 23:12:40 GMT"; " print "Set-Cookie:Domain=www.code24h.com; " print "Set-Cookie:Path=/perl; " print "Content-type:text/html " ...........Rest of the HTML Content....
Qua ví dụ trên, bạn có thể thấy rằng chúng ta đã sử dụng trường Set-Cookie để thiết lập các cookie. Việc thiết lập các thuộc tính của cookie như Expires, Domain, Path là tùy ý. Bạn cần chú ý là các cookie được thiết lập trước khi gửi trường "Content-type:text/html .
Thu nhận Cookie
Để thu nhận tất cả các Cookie đã thiết lập là khá dễ dàng. Các cookie được lưu trữ trong biến môi trường HTTP_COOKIE của CGI và có dạng sau:
key1=value1;key2=value2;key3=value3....
Dưới đây là ví dụ đơn giản minh họa cách thu nhận các cookie:
# Import cac module de xu ly CGI
from os import environ
import cgi, cgitb
if environ.has_key('HTTP_COOKIE'):
for cookie in map(strip, split(environ['HTTP_COOKIE'], ';')):
(key, value ) = split(cookie, '=');
if key == "UserID":
user_id = value
if key == "Password":
password = value
print "Ten dang nhap = %s" % user_id
print "Mat khau = %s" % password
