Parse HTTP रेंज मानक द्वारा

परियोजनाओं में से एक में, मुझे भागों में फ़ाइलों को डाउनलोड करने के लिए समर्थन जोड़ने के लिए HTTP रेंज अनुरोध को पार्स करने की आवश्यकता थी। नेटवर्क विभिन्न उदाहरणों से भरा है, लेकिन मुझे RFC 2616 का एक भी पूर्ण कार्यान्वयन नहीं मिला है। एक कोड ने इस बात पर ध्यान नहीं दिया कि कई रेंज हो सकती हैं, दूसरा जो मानक दस्तावेज़ के आकार से बड़े अनुरोधों को अनुमति देता है, तीसरा एक सिंटैक्टिक रूप से सही और अगम्य अनुरोध के बीच अंतर नहीं करता है, जैसा कि मानक अनुशंसा करता है। इसलिए, मैंने अपने कार्यान्वयन को लिखने और सभी के साथ साझा करने का निर्णय लिया। विवरण और बिल्ली के नीचे PHP में एक उदाहरण कार्यान्वयन।

मानक राज्यों के रूप में, एक श्रेणी क्वेरी में दो भाग होते हैं: रेंज का आयाम और चयन नियमों की एक सूची। RFC 2616 में परिभाषित एकमात्र रेंज आयाम बाइट्स है। इसके अलावा, यह ध्यान दिया जाना चाहिए कि एक ही श्रेणी के शीर्षलेख में एक बार में अल्पविराम द्वारा इंगित कई श्रेणियां हो सकती हैं।

क्लाइंट द्वारा HTTP रेंज लाने के लिए दो विकल्प हैं।

पहला दस्तावेज़ के शरीर में शुरुआत और अंत की स्थिति का संकेत है। पहली स्थिति शून्य से शुरू होती है। अंतिम स्थिति अनुरोध में पहले स्थान से अधिक या उसके बराबर होनी चाहिए। अन्यथा, मानक के अनुसार, इस कार्यान्वयन शीर्ष लेख को अनदेखा किया जाना चाहिए। यदि अंतिम स्थिति अनुपस्थित है या इसका मूल्य दस्तावेज़ के आकार से अधिक या उसके बराबर है, तो अंतिम स्थिति बाइट्स में दस्तावेज़ का वर्तमान आकार है। 1 से कम। मानक के अनुसार, यह कोई त्रुटि नहीं है, क्योंकि यह ग्राहक को दस्तावेज़ का एक हिस्सा अनुरोध करने के लिए अनुमति देता है बिना इसके आकार को अग्रिम में जाने बिना।

उदाहरण के लिए, आकार में 10 बाइट्स के दस्तावेज़ के लिए, bytes=1-9 9 बाइट्स का अनुरोध करता है, दूसरे से शुरू होता है और दस्तावेज़ निकाय के अंतिम बाइट के साथ समाप्त होता है।

दूसरा दस्तावेज निकाय के अंतिम एन बाइट्स का चयन है। यदि दस्तावेज़ अनुरोध में निर्दिष्ट आकार से छोटा है, तो पूरे दस्तावेज़ का चयन किया जाएगा। उदाहरण के लिए, bytes=-2 अंतिम 2 बाइट्स का अनुरोध करता है।

सभी श्रेणियों के प्रसंस्करण के पूरा होने के बाद, सर्वर निर्धारित करता है कि कम से कम एक सीमा है जिसमें गैर-शून्य संख्या के बाइट्स हैं। यदि कोई नहीं हैं, तो सर्वर SHOULD क्लाइंट 416 (अनुरोधित सीमा संतोषजनक नहीं) का जवाब देता है, अन्यथा 206 (आंशिक सामग्री)।

कार्यान्वयन को "सशर्त रूप से संगत" माना जाता है यदि यह शर्तों को पूरा नहीं करता है। इस प्रकार, यदि मानक की सभी शर्तें पूरी हो जाती हैं, तो रेंज अनुरोध का पूर्ण प्रसंस्करण प्राप्त किया जा सकता है।

PHP कार्यान्वयन उदाहरण:

 <?php namespace HTTP; /* * Copyright (c) 2012, aignospam@gmail.com * http://www.opensource.org/licenses/bsd-license.php */ /** * Parse HTTP Range header * http://tools.ietf.org/html/rfc2616#section-14.35 * return array of Range on success * false on syntactically invalid byte-range-spec * empty array on unsatisfiable bytes-range-set * @param int $entity_body_length * @param string range_header * @return array|bool */ function parse_range_request($entity_body_length, $range_header) { $range_list = array(); if ($entity_body_length == 0) { return $range_list; // mark unsatisfiable } // The only range unit defined by HTTP/1.1 is "bytes". HTTP/1.1 // implementations MAY ignore ranges specified using other units. // Range unit "bytes" is case-insensitive if (preg_match('/^bytes=([^;]+)/i', $range_header, $match)) { $range_set = $match[1]; } else { return false; } // Wherever this construct is used, null elements are allowed, but do // not contribute to the count of elements present. That is, // "(element), , (element) " is permitted, but counts as only two elements. $range_spec_list = preg_split('/,/', $range_set, null, PREG_SPLIT_NO_EMPTY); foreach ($range_spec_list as $range_spec) { $range_spec = trim($range_spec); if (preg_match('/^(\d+)\-$/', $range_spec, $match)) { $first_byte_pos = $match[1]; if ($first_byte_pos > $entity_body_length) { continue; } $first_pos = $first_byte_pos; $last_pos = $entity_body_length - 1; } elseif (preg_match('/^(\d+)\-(\d+)$/', $range_spec, $match)) { $first_byte_pos = $match[1]; $last_byte_pos = $match[2]; // If the last-byte-pos value is present, it MUST be greater than or // equal to the first-byte-pos in that byte-range-spec if ($last_byte_pos < $first_byte_pos) { return false; } $first_pos = $first_byte_pos; $last_pos = min($entity_body_length - 1, $last_byte_pos); } elseif (preg_match('/^\-(\d+)$/', $range_spec, $match)) { $suffix_length = $match[1]; if ($suffix_length == 0) { continue; } $first_pos = $entity_body_length - min($entity_body_length, $suffix_length); $last_pos = $entity_body_length - 1; } else { return false; } $range_list[] = new Range($first_pos, $last_pos); } return $range_list; } class Range { private $_first_pos; private $_last_pos; public function __construct($first_pos, $last_pos) { $this->_first_pos = $first_pos; $this->_last_pos = $last_pos; } public function get_first_pos() { return $this->_first_pos; } public function get_last_pos() { return $this->_last_pos; } } ?>