Một chương trình CGI hữu dụng thường sẽ nhận dữ liệu nhập qua các mẫu đơn (form), xử lý các dữ liệu này, và trả về kết quả.
Các dữ liệu nhập được truyền đến ứng dụng web ở dạng bộ 2 (khóa, giá trị) (key-value pair). Ví dụ nếu chúng ta điền vào một mẫu đơn có trường nhập tên là name và giá trị của nó là Nguyễn Việt Nam thì khóa sẽ là name và giá trị là Nguyễn Việt Nam. Thông thường có hai phương thức truyền dữ liệu đến ứng dụng web là GET và POST.
Trong phương thức GET, các bộ 2 (khóa, giá trị) này sẽ được truyền qua URL. Với ví dụ ở trên, URL sẽ có dạng http://host/path?name=Nguyễn+Việt+Nam. Bạn đọc sẽ chú ý các điểm quan trọng sau:
Trong phương thức POST, các bộ 2 (khóa, giá trị) được truyền trong nội dung yêu cầu HTTP, và không hiện rõ cho người dùng.
print ("Content-Type: text/html")
print ("")
print ("<html><head><title>CGI form processing</title></head><body>"
+"<fieldset><legend>Number guessing game</legend>"
+"<form method=\"POST\">"
+"<label for=\"number\">Enter a number</label>"
+"<input type=\"text\" name=\"number\" value=\"\" />"
+"<input type=\"submit\" />"
+"</form>"
+"</fieldset></body></html>")
Kết quả mà chúng ta nhận được là một mẫu đơn như hình:
Một số điểm quan trọng trong chương trình này là sự sử dụng các thẻ liên quan đến mẫu đơn.
- Trước hết là thẻ form dùng để thông báo sự bắt đầu của một mẫu đơn. Các thuộc tính (attribute) thông thường của thẻ này gồm method và action.
- Thuộc tính method xác định phương thức truyền dữ liệu. Chúng ta có thể sử dụng GET hoặc POST.
- Thuộc tính action xác định đường dẫn đến chương trình CGI sẽ xử lý mẫu đơn này. Nếu không xác định thì chính địa chỉ hiện tại sẽ được dùng.
- Thẻ input xác định một trường nhập. Thẻ này có các thuộc tính chính là type, name, và value.
- Thuộc tính type xác định kiểu nhập là một ô nhập (text box), một nút nhấn (button), một nút chọn (radio button), hoặc một tập tin (file). Ở ví dụ này chúng ta xác định một ô nhập với kiểu text.
- Thuộc tính name xác định khóa của bộ 2. Trong ví dụ này khóa nhập là number.
- Thuộc tính value xác định giá trị khởi đầu của trường nhập này. Chúng ta để trống.
- Thẻ input với thuộc tính type là submit sẽ tạo một nút nhấn. Nút nhấn này đặc biệt vì nó sẽ gửi các giá trị chúng ta nhập vào mẫu đơn đến chương trình CGI.
Thông tin chi tiết về các thẻ HTML có thể được xem thêm từ các tài liệu từ
W3C.
Chương trình này cũng chỉ là in ra một mẫu đơn nhưng chúng ta đã có thể nhấn nút để gửi mẫu đơn đó đi.
Chúng ta sẽ sửa nó để in lại những gì đã nhận từ trình duyệt.
#!/python35/python
import cgi,cgitb;cgitb.enable()
cgitb.enable()
print ("Content-Type: text/html")
print ("")
print ("<html><head><title>CGI form processing</title></head><body>"
+"<fieldset><legend>Number guessing game</legend>"
+"<form method=\"POST\">"
+"<label for=\"number\">Enter a number</label>"
+"<input type=\"text\" name=\"number\" value=\"\" />"
+"<input type=\"submit\" />"
+"</form>"
+"</fieldset>"
+"</body></html>")
form = cgi.FieldStorage()
print ("You have entered: %s" % form.getfirst('number'))
Điều đầu tiên chúng ta nhận ra là sự sử dụng mô-đun cgi. Mô-đun này cho phép chúng ta tạo một đối tượng FieldStorage. Đối tượng FieldStorage chứa các bộ 2 (khóa, giá trị) chúng ta nhận được từ trình duyệt trong một cấu trúc như kiểu từ điển. Do đó chúng ta có thể dùng phương thức has_key để kiểm tra sự tồn tại của khóa tương ứng. Để lấy giá trị từ FieldStorage ta có thể dùng form[’number’].value hoặc gọi các hàm như getvalue, getfirst, hay getlist. Các hàm này được đề cập đến một cách chi tiết trong bộ tài liệu sử dụng Python.
Nếu tinh ý, chúng ta sẽ thấy rằng khi dữ liệu nhập chứa các thẻ HTML hợp lệ thì kết quả xuất ra sẽ hiển thị cả những thẻ HTML này. Ví dụ khi ta nhập Nguyễn <b>Việt</b> Nam.
Điều này có thể là đúng theo ý định, hoặc cũng thể nằm ngoài mong muốn. Chúng ta gọi đây là các lỗi kịch bản chéo trang (Cross Site Scripting, XSS). Cách khắc phục là trước khi hiển thị các chuỗi không nằm trong kiểm soát của chương trình (ví dụ như dữ liệu nhập, dữ liệu xuất từ hệ thống khác, v.v…), chúng ta sẽ cần chuyển mã các ký tự đặc biệt. Mô-đun cgi cung cấp hàm escape để làm việc này. Mã nguồn mới sẽ gói getfirst trong cgi.escape như sau:
#!c:/python26/python
import cgi
print "Content-Type: text/html"
print
print """<html>
<head>
<title>CGI form processing</title>
</head>
<body>
<fieldset>
<legend>Number guessing game</legend>
<form method="POST">
<label for="number">Enter a number</label>
<input type="text" name="number" value="" />
<input type="submit" />
</form>
</fieldset>
"""
form = cgi.FieldStorage()
if form.has_key('number'):
print """You have entered: %s""" % cgi.escape( \
form.getfirst('number'), True)
print """</body>
</html>
"""
Giờ đây, chuỗi được xuất ra sẽ giống hệt với chuỗi nhập.
Chúng ta cũng có thể thử với phương thức GET bằng cách nhập thẳng URL http://localhost/cgi-bin/fp.py?number=Nguyễn+<b>Việt</b>+Nam. Chúng ta cũng sẽ nhận được kết quả tương tự.
Vậy là qua hai phần chúng ta đã tìm hiểu về cách hoạt động của một chương trình CGI. Điểm mạnh của giao thức CGI là tính đơn giản và an toàn cao vì mỗi yêu cầu được một tiến trình riêng xử lý. Cũng chính vì mô hình đơn giản như vậy nên CGI gặp phải nhiều cản trở trong việc phát triển. Cản trở đầu tiên là chương trình CGI phải tự xử lý trạng thái giữa các yêu cầu kế tiếp nhau, hay còn gọi là phiên làm việc (session). Cản trở thứ hai là chương trình CGI sẽ phải được thiết kế đặc biệt nếu muốn sử dụng các biến có phạm vi toàn ứng dụng (application scope). Cuối cùng, chương trình CGI chạy chậm hơn và tốn tài nguyên hơn vì mỗi yêu cầu phải được xử lý riêng.