ngx fancyindex
v0.5.2
สารบัญ
โมดูล Fancy Index ช่วยให้สามารถสร้างรายชื่อไฟล์ได้ เช่นเดียวกับโมดูล autoindex ในตัว แต่เพิ่มสไตล์เข้าไปอีก สิ่งนี้เป็นไปได้เนื่องจากโมดูลอนุญาตให้ปรับแต่งเนื้อหาที่สร้างขึ้นได้ในระดับหนึ่ง:
โมดูลนี้ออกแบบมาเพื่อทำงานร่วมกับ Nginx ซึ่งเป็นเว็บเซิร์ฟเวอร์โอเพ่นซอร์สประสิทธิภาพสูงที่เขียนโดย Igor Sysoev
สำหรับผู้ใช้พื้นที่เก็บข้อมูล Nginx ที่เสถียรอย่างเป็นทางการ จะมีพื้นที่เก็บข้อมูลแพ็คเกจเพิ่มเติมพร้อมโมดูลไดนามิกและรวม fancyindex ไว้ด้วย
ติดตั้งคอนฟิกูเรชันที่เก็บ จากนั้นแพ็กเกจโมดูล:
yum -y ติดตั้ง https://extras.getpagespeed.com/release-latest.rpm yum -y ติดตั้ง nginx-module-fancyindex.php
จากนั้นโหลดโมดูลใน /etc/nginx/nginx.conf โดยใช้:
load_module "โมดูล/ngx_http_fancyindex_module.so";
ผู้ใช้สามารถติดตั้ง Nginx บน macOS ด้วย MacPorts fancyindex รวมอยู่ด้วย:
พอร์ต sudo ติดตั้ง nginx
ในกรณีอื่นๆ ส่วนใหญ่ คุณจะต้องมีแหล่งที่มาสำหรับ Nginx เวอร์ชันใดก็ตามที่เริ่มต้นจากซีรีส์ 0.8 ควรใช้งานได้
ในการใช้คำสั่ง fancyindex_header_ และ fancyindex_footer_ คุณจะต้องมี ngx_http_addition_module ที่สร้างไว้ใน Nginx ด้วย
แกะแหล่ง Nginx:
$ gunzip -c nginx-?.?.?.tar.gz | ทาร์ -xvf -
แกะซอร์สสำหรับโมดูลการจัดทำดัชนีแฟนซี:
$ gunzip -c nginx-fancyindex-?.??.?.tar.gz | ทาร์ -xvf -
เปลี่ยนเป็นไดเร็กทอรีที่มีแหล่ง Nginx รันสคริปต์การกำหนดค่าด้วยตัวเลือกที่ต้องการ และอย่าลืมใส่แฟล็ก --add-module ที่ชี้ไปยังไดเร็กทอรีซึ่งมีซอร์สของโมดูลการจัดทำดัชนีแฟนซี:
$ ซีดี nginx-?.??.? $ ./configure --add-module=../nginx-fancyindex-?.??.? - [--with-http_addition_module] [ตัวเลือกเพิ่มเติมที่ต้องการ]
ตั้งแต่เวอร์ชัน 0.4.0 โมดูลยังสามารถสร้างเป็นโมดูลไดนามิกได้โดยใช้ --add-dynamic-module=… แทนและ load_module "modules/ngx_http_fancyindex_module.so"; ในไฟล์กำหนดค่า
สร้างและติดตั้งซอฟต์แวร์:
$ ทำ
จากนั้นในฐานะ root :
#ทำการติดตั้ง
กำหนดค่า Nginx โดยใช้คำสั่งการกำหนดค่าของโมดูล
คุณสามารถทดสอบสไตล์บิวท์อินเริ่มต้นได้โดยเพิ่มบรรทัดต่อไปนี้ลงในส่วน server ในไฟล์การกำหนดค่า Nginx ของคุณ:
ที่ตั้ง / {
ดัชนีแฟนซีบน; # เปิดใช้งานดัชนีแฟนซี
fancyindex_exact_size ปิด; # เอาต์พุตขนาดไฟล์ที่มนุษย์สามารถอ่านได้
-
ธีมต่อไปนี้แสดงให้เห็นถึงระดับของการปรับแต่งซึ่งสามารถทำได้โดยใช้โมดูล:
| ไวยากรณ์: | fancyindex [ บน | ปิด ] |
|---|---|
| ค่าเริ่มต้น: | ปิดดัชนีแฟนซี |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | เปิดหรือปิดใช้งานดัชนีไดเร็กทอรีแฟนซี |
| ไวยากรณ์: | fancyindex_default_sort [ ชื่อ | ขนาด | วันที่ | name_desc | size_คำอธิบาย | วันที่_รายละเอียด ] |
|---|---|
| ค่าเริ่มต้น: | ชื่อ fancyindex_default_sort |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | กำหนดเกณฑ์การเรียงลำดับตามค่าเริ่มต้น |
| ไวยากรณ์: | fancyindex_case_sensitive [ บน | ปิด ] |
|---|---|
| ค่าเริ่มต้น: | fancyindex_case_sensitive บน |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | หากเปิดใช้งาน (การตั้งค่าเริ่มต้น) การเรียงลำดับตามชื่อจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ หากปิดใช้งาน ตัวพิมพ์จะถูกละเว้นเมื่อเรียงลำดับตามชื่อ |
| ไวยากรณ์: | fancyindex_directories_first [ บน | ปิด ] |
|---|---|
| ค่าเริ่มต้น: | fancyindex_directories_first บน |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | หากเปิดใช้งาน (การตั้งค่าเริ่มต้น) ให้จัดกลุ่มไดเร็กทอรีไว้ด้วยกันและจัดเรียงก่อนไฟล์ปกติทั้งหมด หากปิดใช้งาน ไดเร็กทอรีจะถูกจัดเรียงพร้อมกับไฟล์ |
| ไวยากรณ์: | fancyindex_css_href uri |
|---|---|
| ค่าเริ่มต้น: | fancyindex_css_href "" |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | อนุญาตให้แทรกลิงก์ไปยังสไตล์ชีต CSS ในรายการที่สร้างขึ้น พารามิเตอร์ uri ที่ระบุจะถูกแทรกตามที่เป็นอยู่ในแท็ก HTML |
| ไวยากรณ์: | fancyindex_exact_size [ บน | ปิด ] |
|---|---|
| ค่าเริ่มต้น: | fancyindex_exact_size บน |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | กำหนดวิธีการแสดงขนาดไฟล์ในรายการไดเร็กทอรี: อย่างแม่นยำ หรือปัดเศษเป็นกิโลไบต์ เมกะไบต์ และกิกะไบต์ |
| ไวยากรณ์: | เส้นทาง fancyindex_footer [ คำขอย่อย | ท้องถิ่น ] |
|---|---|
| ค่าเริ่มต้น: | fancyindex_footer "" |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | ระบุว่าควรแทรกไฟล์ใดไว้ที่ส่วนท้ายของรายการไดเร็กทอรี หากตั้งค่าเป็นสตริงว่าง ส่วนท้ายเริ่มต้นที่โมดูลส่งมาจะถูกส่งไป พารามิเตอร์ทางเลือกจะระบุว่า เส้นทาง จะถือเป็น URI ที่จะโหลดโดยใช้ คำขอย่อย (ค่าเริ่มต้น) หรืออ้างถึงไฟล์ ในเครื่อง หรือไม่ |
บันทึก
การใช้คำสั่งนี้จำเป็นต้องมี ngx_http_addition_module ที่สร้างไว้ใน Nginx
คำเตือน
เมื่อแทรกส่วนหัว/ส่วนท้ายที่กำหนดเอง คำขอย่อยจะออกเพื่อให้สามารถใช้ URL ใดๆ เป็นแหล่งที่มาได้ แม้ว่าจะใช้งานได้กับ URL ภายนอก แต่รองรับเฉพาะการใช้ภายในเท่านั้น URL ภายนอกยังไม่ผ่านการทดสอบโดยสิ้นเชิง และการใช้ URL เหล่านี้จะทำให้ Nginx บล็อกในขณะที่รอคำขอย่อยให้เสร็จสิ้น หากคุณรู้สึกว่าส่วนหัว/ส่วนท้ายภายนอกเป็นสิ่งที่ต้องมีสำหรับคุณ โปรดแจ้งให้เราทราบ
| ไวยากรณ์: | เส้นทาง fancyindex_header [ คำขอย่อย | ท้องถิ่น ] |
|---|---|
| ค่าเริ่มต้น: | fancyindex_header "" |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | ระบุว่าควรแทรกไฟล์ใดไว้ที่ส่วนหัวของรายการไดเร็กทอรี หากตั้งค่าเป็นสตริงว่าง ส่วนหัวเริ่มต้นที่โมดูลส่งมาจะถูกส่งไป พารามิเตอร์ทางเลือกจะระบุว่า เส้นทาง จะถือเป็น URI ที่จะโหลดโดยใช้ คำขอย่อย (ค่าเริ่มต้น) หรืออ้างถึงไฟล์ ในเครื่อง หรือไม่ |
บันทึก
การใช้คำสั่งนี้จำเป็นต้องมี ngx_http_addition_module ที่สร้างไว้ใน Nginx
| ไวยากรณ์: | fancyindex_show_path [ บน | ปิด ] |
|---|---|
| ค่าเริ่มต้น: | fancyindex_show_path บน |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | ไม่ว่าจะส่งออกเส้นทางและแท็กปิด หลังส่วนหัวหรือไม่ สิ่งนี้มีประโยชน์เมื่อคุณต้องการจัดการเส้นทางที่แสดงด้วยสคริปต์ PHP เป็นต้น |
คำเตือน
คำสั่งนี้สามารถปิดได้ก็ต่อเมื่อมีการระบุส่วนหัวแบบกำหนดเองโดยใช้ fancyindex_header
| ไวยากรณ์: | fancyindex_show_dotfiles [ บน | ปิด ] |
|---|---|
| ค่าเริ่มต้น: | fancyindex_show_dotfiles ปิดอยู่ |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | ไม่ว่าจะแสดงรายการไฟล์ที่นำหน้าด้วยจุดหรือไม่ แบบแผนปกติคือการซ่อนสิ่งเหล่านี้ |
| ไวยากรณ์: | fancyindex_ignore string1 [string2 [... stringN]] |
|---|---|
| ค่าเริ่มต้น: | ไม่มีค่าเริ่มต้น |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | ระบุรายชื่อไฟล์ที่จะไม่แสดงในรายการที่สร้างขึ้น หาก Nginx ถูกสร้างขึ้นด้วยการสนับสนุน PCRE สตริงจะถูกตีความว่าเป็นนิพจน์ทั่วไป |
| ไวยากรณ์: | fancyindex_hide_symlinks [ บน | ปิด ] |
|---|---|
| ค่าเริ่มต้น: | fancyindex_hide_symlinks ปิดอยู่ |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | เมื่อเปิดใช้งาน รายการที่สร้างขึ้นจะไม่มีลิงก์สัญลักษณ์ |
| ไวยากรณ์: | fancyindex_hide_parent_dir [ บน | ปิด ] |
|---|---|
| ค่าเริ่มต้น: | fancyindex_hide_parent_dir ปิดอยู่ |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | เมื่อเปิดใช้งาน จะไม่แสดงไดเร็กทอรีหลัก |
| ไวยากรณ์: | fancyindex_localtime [ บน | ปิด ] |
|---|---|
| ค่าเริ่มต้น: | fancyindex_localtime ปิดอยู่ |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | เปิดใช้งานการแสดงเวลาไฟล์เป็นเวลาท้องถิ่น ค่าเริ่มต้นคือ "ปิด" (เวลา GMT) |
| ไวยากรณ์: | สตริง fancyindex_time_format |
|---|---|
| ค่าเริ่มต้น: | fancyindex_time_format "%Y-%b-%d %H:%M" |
| บริบท: | http, เซิร์ฟเวอร์, ที่ตั้ง |
| คำอธิบาย: | จัดรูปแบบสตริงที่ใช้สำหรับการประทับเวลา ตัวระบุรูปแบบเป็นชุดย่อยของฟังก์ชัน strftime ที่สนับสนุน และลักษณะการทำงานไม่ขึ้นกับโลแคล (เช่น ชื่อวันและเดือนจะเป็นภาษาอังกฤษเสมอ) รูปแบบที่รองรับคือ:
|
