مجموعه ServerVariables سرور ASP
تعریف و استفاده
مجموعه ServerVariables برای بازگرداندن ارزش متغیرهای سرور استفاده می‌شود.
نحوه استفاده
Request.ServerVariables (server_variable)
| پارامتر | توضیح |
|---|---|
| server_variable | ضروری. متغیری که بایدمتغیرهای سرورنام‌گذاری شده. |
متغیرهای سرور
| متغیر | توضیح |
|---|---|
| ALL_HTTP | همه سربرگ‌های HTTP ارسالی توسط مشتری را بازمی‌گرداند. همیشه با HTTP_ پیشوند شده و بزرگ‌نوشته |
| ALL_RAW | همه سربرگ‌ها را به صورت خالص بازمی‌گرداند |
| APPL_MD_PATH | مسیر پوسته متا برای برنامه برای DLL ISAPI را بازمی‌گرداند |
| APPL_PHYSICAL_PATH | مسیر فیزیکی که با مسیر پوسته متا مطابقت دارد |
| AUTH_PASSWORD | مقدار وارد شده در دیالوگ تأیید مشتری را بازمی‌گرداند |
| AUTH_TYPE | روشی که سرور برای تأیید کاربران استفاده می‌کند |
| AUTH_USER | بازگرداندن نام کاربر تأیید شده خالص |
| CERT_COOKIE | بازگرداندن شناسه منحصر به فرد گواهینامه کاربر به عنوان یک رشته |
| CERT_FLAGS | اگر گواهینامه کاربر موجود باشد، بیت 0 به 1 تنظیم می‌شود و اگر نه، اگر نه اعتبار گواهینامه اعتماد کاربر معتبر نباشد، بیت 1 به 1 تنظیم می‌شود |
| CERT_ISSUER | بازگرداندن میدان منتشرکننده گواهینامه کاربر |
| CERT_KEYSIZE | بازگرداندن تعداد بیت‌ها در اندازه کلید اتصال لایه سکویه‌های امن |
| CERT_SECRETKEYSIZE | بازگرداندن تعداد بیت‌ها در کلید خصوصی گواهینامه سرور |
| CERT_SERIALNUMBER | بازگرداندن میدان شماره سریال گواهینامه کاربر |
| CERT_SERVER_ISSUER | بازگرداندن میدان صادرکننده گواهینامه سرور |
| CERT_SERVER_SUBJECT | بازگرداندن میدان موضوعی گواهینامه سرور |
| CERT_SUBJECT | بازگرداندن میدان موضوعی گواهینامه کاربر |
| CONTENT_LENGTH | بازگرداندن طول محتوا به عنوان آنچه توسط کاربر ارسال شده است |
| CONTENT_TYPE | بازگرداندن نوع داده محتوا |
| GATEWAY_INTERFACE | بازگرداندن نسخه‌ای از специفیکیشن CGI مورد استفاده توسط سرور |
| HTTP_<HeaderName> | بازگرداندن مقدار ذخیره شده در سربرگ HeaderName |
| HTTP_ACCEPT | بازگرداندن مقدار سربرگ Accept |
| HTTP_ACCEPT_LANGUAGE | بازگرداندن رشته‌ای که زبان مورد استفاده برای نمایش محتوا را توصیف می‌کند |
| HTTP_COOKIE | بازگرداندن رشته کوکی شامل درخواست |
| HTTP_REFERER | بازگرداندن رشته‌ای که شامل URL صفحه‌ای است که درخواست را به صفحه فعلی با استفاده از برچسب <a> ارجاع داده است. اگر صفحه به دیگری هدایت شده باشد، HTTP_REFERER خالی است |
| HTTP_USER_AGENT | بازگرداندن رشته‌ای که توصیف‌کننده مرورگری است که درخواست را ارسال کرده است |
| HTTPS | بازگرداندن ON اگر درخواست از کانال امن وارد شده باشد یا OFF اگر درخواست از کانال غیرامن وارد شده باشد |
| HTTPS_KEYSIZE | بازگرداندن تعداد بیت‌ها در اندازه کلید اتصال لایه سکویه‌های امن |
| HTTPS_SECRETKEYSIZE | بازگرداندن تعداد بیت‌ها در کلید خصوصی گواهینامه سرور |
| HTTPS_SERVER_ISSUER | بازگرداندن میدان صادرکننده گواهینامه سرور |
| HTTPS_SERVER_SUBJECT | بازگرداندن میدان موضوعی گواهینامه سرور |
| INSTANCE_ID | شماره شناسه نمونه IIS به صورت متن |
| INSTANCE_META_PATH | مسیر پیکربندی پایه برای نمونه‌ای از IIS که به درخواست پاسخ می‌دهد |
| LOCAL_ADDR | بازگرداندن آدرس سرور که درخواست به آن وارد شده است |
| LOGON_USER | بازگرداندن حساب کاربری ویندوز که کاربر به آن وارد شده است |
| PATH_INFO | اطلاعات مسیر اضافی را که توسط کاربر داده شده را بازمی‌گرداند |
| PATH_TRANSLATED | نسخه‌ای از PATH_INFO ترجمه شده که مسیر را دریافت کرده و هرگونه تطبیق مجازی به فیزیکی لازم را انجام می‌دهد |
| QUERY_STRING | اطلاعات جستجو را بازمی‌گرداند که در رشته‌ای که پس از علامت سوال (?) در درخواست HTTP ذخیره شده است، قرار دارد |
| REMOTE_ADDR | آدرس IP میزبان دور که درخواست را می‌کند را بازمی‌گرداند |
| REMOTE_HOST | نام میزبانی که درخواست را می‌کند را بازمی‌گرداند |
| REMOTE_USER | رشته نام کاربری غیرمAPPED ارسالی توسط کاربر را بازمی‌گرداند |
| REQUEST_METHOD | روشی که برای ارسال درخواست استفاده شده را بازمی‌گرداند |
| SCRIPT_NAME | یک مسیر مجازی به اسکریپتی که در حال اجرا است بازمی‌گرداند |
| SERVER_NAME | نام میزبان سرور، آلیاس DNS یا آدرس IP را بازمی‌گرداند که در URLهای خود مرجعانه ظاهر خواهد شد |
| SERVER_PORT | شماره پورتی که درخواست به آن ارسال شده را بازمی‌گرداند |
| SERVER_PORT_SECURE | بازمی‌گردد به یک رشته که شامل 0 یا 1 است. اگر درخواست در پورت امن در حال پردازش است، 1 خواهد بود. در غیر این صورت، 0 خواهد بود |
| SERVER_PROTOCOL | نام و نسخه پروتکل اطلاعات درخواست را بازمی‌گرداند |
| SERVER_SOFTWARE | نام و نسخه نرم‌افزار سروری که درخواست را پاسخ می‌دهد و گیت‌ووی را اجرا می‌کند را بازمی‌گرداند |
| URL | قسمت پایه URL را بازمی‌گرداند |
مثال
مثال 1
شما می‌توانید به این صورت همه متغیرهای سرور را در یک چرخه بیابید:
<% for each x in Request.ServerVariables response.write(x & "<br />") next %>
مثال 2
این مثال روشی را برای شناسایی نوع مرورگر بازدیدکننده، آدرس IP و غیره نشان می‌دهد:
<html>
<body>
<p>
<b>You are browsing this site with:</b>
<%Response.Write(Request.ServerVariables("http_user_agent"))%>
</p>
<p>
<b>Your IP address is:</b>
<%Response.Write(Request.ServerVariables("remote_addr"))%>
</p>
<p>
<b>The DNS lookup of the IP address is:</b>
<%Response.Write(Request.ServerVariables("remote_host"))%>
</p>
<p>
<b>The method used to call the page:</b>
<%Response.Write(Request.ServerVariables("request_method"))%>
</p>
<p>
<b>The server's domain name:</b>
<%Response.Write(Request.ServerVariables("server_name"))%>
</p>
<p>
<b>The server's port:</b>
<%Response.Write(Request.ServerVariables("server_port"))%>
</p>
<p>
<b>نرم‌افزار سرور:</b>
<%Response.Write(Request.ServerVariables("server_software"))%>
</p>
</body>
</html>
