English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

طرق CGI في Ruby

طرق CGI في Ruby

إليكم قائمة بالأساليب في فئة CGI:

الرقموصف الطريقة
1CGI::new([ level="query"])
إنشاء عنصر CGI. يمكن أن يكون query قيمةً من:
  • query: لا يوجد إنتاج HTML

  • html3: HTML3.2

  • html4:  HTML4.0 Strict

  • html4Tr: HTML4.0 Transitional

  • html4Fr:  HTML4.0 Frameset

2CGI::escape( str)
استخدام الترميز URL لتغيير سلسلة
3CGI::unescape( str)
تفسير سلسلة تم ت编码ها باستخدام escape()
4CGI::escapeHTML( str)
ت编码 رموز HTML الخاصة، بما في ذلك: & < >.
5CGI::unescapeHTML( str)
تفسير رموز HTML الخاصة، بما في ذلك: & < >.
6CGI::escapeElement( str[, element...])
ت编码 رموز HTML الخاصة في العنصر HTML المحدد.
7CGI::unescapeElement( str, element[, element...])
تفسير رموز HTML الخاصة في العنصر HTML المحدد.
8CGI::parse( query)
تخزين الاستعلام وعدم إرجاع دليل = > قيمة يحتوي على هشاشة.
9CGI::pretty( string[, leader=" "])
العودة إلى تنسيق HTML منضبط. إذا تم تحديد leader ،وسيتم كتابته في بداية كل سطر. leader القيمة الافتراضية هي مسافة بينين.
10CGI::rfc1123_date( time)
تنسيق الوقت وفقًا لـ RFC-1123 (مثل،Tue, 2 Jun 2008 00:00:00 GMT).

طريقة CGI المثالية

في المثال التالي، سنقوم بتعيين كائن CGI::new إلى متغير c، قائمة الطرق كالتالي:

الرقموصف الطريقة
1c[ name]
العودة إلى مجموعة من المفاتيح التي تحتوي على اسم الحقل المطلوب. name القيمة.
2c.checkbox( name[, value[, check=false]])
c.checkbox( options)

العودة إلى سطر HTML مخصص لتعريف حقل مربع اختيار. يمكن ترحيل خصائص العلامة باستخدام دالة هش.
3c.checkbox_group( name, value...)
c.checkbox_group( options)

>العودة إلى سطر HTML مخصص لتعريف مجموعة مربعات اختيار. يمكن ترحيل خصائص العلامة باستخدام دالة هش.
4c.file_field( name[, size=20[, max]])
c.file_field( options)

العودة إلى سطر HTML مخصص لصيغة ملف.
5c.form([ method="post"[, url]]) { ...}
c.form( options)

العودة إلى سطر HTML مخصص لصيغة نموذج. إذا تم تحديد فقاعة النص، فإنها ستكون محتوى النموذج. يمكن ترحيل خصائص العلامة باستخدام دالة هش.
6c.cookies
العودة إلى كائن CGI::Cookie الذي يحتوي على أزواج المفاتيح-القيم في الكوكي.
7c.header([ header])
العودة إلى معلومات رأس CGI. إذا كان معامل header قيمة هشاشة، فإنه يحتوي على أزواج المفاتيح-القيم، مكرر لإنشاء معلومات الرأس.
8c.hidden( name[, value])
c.hidden( options)

العودة إلى تعريف سطر HTML مختفي. يمكن ترحيل خصائص العلامة باستخدام دالة هش.
9c.image_button( url[, name[, alt]])
c.image_button( options)

يُرجع تعريف سلسلة HTML لمساحة زر الصورة. يمكن نقل خصائص العلامة بمعامل وظيفة هشاشة.
10c.keys
يُرجع مصفوفة تحتوي على أسماء ميدان النموذج.
11c.key?( name)
c.has_key?( name)
c.include?( name)

إذا كان النموذج يحتوي على اسم الميدان المحدد، فإنه يرجع true.
12c.multipart_form([ url[, encode]]) { ...}
c.multipart_form( options) { ...}

يُرجع تعريف سلسلة HTML لنموذج متعدد المكونات (multipart). يمكن نقل خصائص العلامة بمعامل وظيفة هشاشة.
13c.out([ header]) { ...}
توليد HTML وإخراج. استخدم سلسلة الناتج من الكتلة لإنشاء جسم الصفحة.
14c.params
يُرجع قيمة هشاشة تحتوي على اسم ميدان النموذج والقيمة.
15c.params= hash
تعيين استخدام اسم الميدان والقيمة.
16c.password_field( name[, value[, size=40[, max]]])
c.password_field( options)

يُرجع تعريف سلسلة HTML لميدان كلمة المرور. يمكن نقل خصائص العلامة بمعامل وظيفة هشاشة.
17c.popup_menu( name, value...)
c.popup_menu( options)
c.scrolling_list( name, value...)
c.scrolling_list( options)

يُرجع تعريف سلسلة HTML لمكتبة التنقل. يمكن نقل خصائص العلامة بمعامل وظيفة هشاشة.
18c.radio_button( name[, value[, checked=false]])
c.radio_button( options)

يُرجع تعريف سلسلة HTML لميدان الراديو. يمكن نقل خصائص العلامة بمعامل وظيفة هشاشة.
19c.radio_group( name, value...)
c.radio_group( options)

يُرجع تعريف سلسلة HTML لمجموعة أزرار الراديو. يمكن نقل خصائص العلامة بمعامل وظيفة هشاشة.
20c.reset( name[, value])
c.reset( options)

يعيد تعريف سطر HTML معرفاً بحقل زر إعادة الإعدادات. يمكن نقل خصائص العلامة بوساطة دالة هاشة كمعامل.
21c.text_field( name[, value[, size=40[, max]]])
c.text_field( options)

يعيد تعريف سطر HTML معرفاً بحقل text. يمكن نقل خصائص العلامة بوساطة دالة هاشة كمعامل.
22c.textarea( name[, cols=70[, rows=10]]) { ...}
c.textarea( options) { ...}

يعيد تعريف سطر HTML معرفاً بحقل textarea. إذا تم تحديد الكتلة، فإن النص الخارج من الكتلة سيكون محتوى textarea. يمكن نقل خصائص العلامة بوساطة دالة هاشة كمعامل.

طرق إنشاء HTML

يمكنك استخدام علامات HTML المتبادلة في مثال CGI لإنشاء علامات HTML، مثل ما يلي:

مثال على الإنترنت

#!/usr/bin/ruby
 
require "cgi"
cgi = CGI.new("html4")
cgi.out{
   cgi.html{
      cgi.head{ "\n"+cgi.title{"This Is a Test"} } +
      cgi.body{ "\n"+
         cgi.form{"\n"+
            cgi.hr +
            cgi.h1 { "A Form: " } + "\n"+
            cgi.textarea("get_text") +"\n"+
            cgi.br +
            cgi.submit
         }
      }
   }
}

خصائص عنصر CGI

يمكنك استخدام الخصائص التالية في مثال CGI:

الخصائصالقيمة المعدة
acceptأنواع MIME المقبولة
accept_charsetالجميعات المقبولة
accept_encodingال编码 المقبولة
accept_languageاللغات المقبولة
auth_typeالأنواع المقبولة
raw_cookieبيانات الكوكيز (النص الأصلي)
content_lengthطول المحتوى (Content length)
content_typeنوع المحتوى (Content type)
منعنوان البريد الإلكتروني للعميل
واجهة الشبكةإصدار CGI
path_infoالمسار
path_translatedالمسار المترجم
Query_stringالسلسلة العنصرية
refererرابط الزيارة السابقة
remote_addrعنوان المضيف للعميل (IP)
remote_hostاسم المضيف للعميل
remote_identاسم العميل
remote_userالمستخدم المعتمد
request_methodطريقة الطلب (GET, POST، إلخ)
script_nameاسم المعامل
server_nameاسم الخادم
server_portمنفذ الخادم
server_protocolبروتوكول الخادم
server_softwareبرنامج التخزين على الخادم
user_agentمستخدم الوكيل (User agent)