.phar - निष्पादन योग्य PHP अभिलेखागार

मैं इस लेख को PHP 5.2 में एक दिलचस्प नवाचार के लिए समर्पित करना चाहता हूं (संस्करण 5.3 से यह मानक PHP पैकेज में शामिल है) - PHAR।

PHAR PHP में निष्पादन योग्य अभिलेखागार बनाने के लिए एक उपयोगिता है, जावा में JAR का एक एनालॉग।
PHAR आपको कई फ़ाइलों को एक में पैक करने की अनुमति देता है, जिसके परिणामस्वरूप आपका एप्लिकेशन पूरी लाइब्रेरी के साथ एक फ़ाइल के साथ काम कर सकता है।
PHAR TAR, ZIP और वास्तव में PHAR जैसे प्रारूप बना, पढ़, लिख और परिवर्तित कर सकता है।
संग्रह में फ़ाइलों को एक्सेस सीधे बाहर किया जाता है, बिना संग्रह को अनपैक करने की आवश्यकता के बिना, PHP स्ट्रीम रैपर के माध्यम से, अर्थात, वे सभी कार्य जो PHP स्ट्रीम लिपिक के संग्रह से फ़ाइलों के साथ काम करते हैं।

आवश्यकताओं

PHAR अभिलेखागार के साथ काम करने के लिए आपको PHAR, zlib और bzip2 एक्सटेंशन (यदि आपके पास PHP 5.3 है, तो PHAR पहले से ही डिफ़ॉल्ट रूप से स्थापित है) के साथ PHP 5.2 से कम नहीं है।
सुरक्षा
डिफ़ॉल्ट रूप से, PHAR अभिलेखागार में केवल-पढ़ने के लिए पहुँच होती है। यदि वांछित है, तो आप php.ini में phar.readonly = 0 सेट कर सकते हैं।
इसके अलावा, PHAR अभिलेखागार केवल PHP दुभाषिया द्वारा निष्पादित किया जा सकता है।

उदाहरण

पाठ फ़ाइल के साथ एक संग्रह बनाएँ:

$phar = new Phar('test.phar'); $phar[hello_habr.txt] = 'Hello Habr!'; 

अब इसकी सामग्री पढ़ें:

 echo file_get_contents('phar://test.phar/hello_habr.txt'); 

स्टब फ़ाइल

एक "स्टब" एक फ़ाइल है जिसे पहले पढ़ा जाता है जब PHAR संग्रह जुड़ा होता है; यह एक प्रकार का बूटस्ट्रैप है। इस फ़ाइल की व्याख्या केवल तभी की जाती है जब पुरालेख पूरी तरह से जुड़ा हुआ हो। यदि स्क्रिप्ट संग्रह से केवल विशिष्ट फ़ाइलों का उपयोग करती है, तो स्टब फ़ाइल की व्याख्या नहीं की जाती है।
आइए एक उदाहरण देखें:

 //-   include_once('some_archive.phar'); //-    include_once('phar://some_archive.phar/somefile.php'); 

स्टब फ़ाइल बनाते समय, फ़ाइल के अंत में __HALT_COMPILER () कॉल का उपयोग करें।
स्टब फ़ाइल का एक्सेस गेटस्टब () विधि से कॉल करके प्राप्त किया जा सकता है, उदाहरण के लिए:

 $phar = new Phar('some_archive.phar'); $stub = $phar->getStub(); 

डिफ़ॉल्ट स्टब फ़ाइल सेट करने के लिए, setDefaultStub () विधि का उपयोग करें:

 $phar = new Phar('some_archive.phar'); $phar->setDefaultStub('cli.php', 'web/index.php'); 

संग्रह सामग्री बनाना

महत्वपूर्ण: php.ini में phar.readonly = 0 सेट करें

सामग्री लिखने के कई तरीके हैं:

• एक वस्तु संपत्ति के माध्यम से
• फ़ार :: addFile ()
• फ़ार :: addFromString ()
• फ़ार :: addEmptyDir ()
• फ़ार :: buildFromDirectory ()
• फ़ार :: buildFromIterator ()

कुछ उदाहरण:

 $phar = new Phar('habr.phar'); $phar['index.php'] = file_get_contents('some/path/to/file.php'); //          (ArrayAccess) 

 $phar = new Phar('habr.phar'); $phar->addFile('http://habrahabr.ru', 'HabrHomePage.html'); $phar->addFromString('HabrHomePage', file_get_contents('http://habrahabr.ru')); $phar = new Phar('habr.phar'); $phar->addEmptyDir('temporary/'); $phar->buildFromDirectory('some_directory/'); 

 $phar = new Phar('habr'); $dir = 'somedir/'; $phar->buildFromIterator( new RecursiveDirectoryIterator($dir) ); 

संग्रह से पढ़ना

रिकॉर्डिंग के साथ, कई तरीके हैं:

• PHAR स्ट्रीम रैपर (चरण: //)
• सीधा संबंध
• Phar :: extractTo ()
• 'फ़ार' के उदाहरण पर कथन

PHAR संग्रह हस्ताक्षर

हस्ताक्षर का उपयोग डेटा को मान्य करने के लिए किया जाता है।
PHAR चार हस्ताक्षर पीढ़ी के एल्गोरिदम का समर्थन करता है:

• MD5
• SHA1
• SHA256
• SHA512

हस्ताक्षर सेट करने के लिए, चरण :: setSignatureAl एल्गोरिदम () विधि का उपयोग करें, जो दो पैरामीटर लेता है:

• हस्ताक्षर का प्रकार:
  
  • चरण :: एमडी 5
  • चरण :: SHA1
  • चरण :: SHA256
  • चरण :: SHA512
  • चरण :: OPENSSL
  
  
• निजी कुंजी - यानी ओपनएसएसएल निजी कुंजी

कोड उदाहरण:

 $phar=new Phar('habr.phar'); $phar->buildFromDirectory('habr/'); $signatures=Phar::getSupportedSignatures(); if (in_array(PHAR::SHA512,$signatures)) { $phar->setSignatureAlgorithm(PHAR::SHA512); } elseif (in_array(PHAR::SHA256,$signatures)) { $phar->setSignatureAlgorithm(PHAR::SHA256); } elseif (in_array(PHAR::SHA1,$signatures)) { $phar->setSignatureAlgorithm(PHAR::SHA1); } elseif (in_array(PHAR::MD5,$signatures)) { $phar->setSignatureAlgorithm(PHAR::MD5); } 

और ओपनएसएसएल के लिए:

 $phar=new Phar('habr.phar'); $phar->buildFromDirectory('habr/'); $OSSLPrivateKey=openssl_get_privatekey(file_get_contents('private.pem')); $OSSLPKey=''; openssl_pkey_export($OSSLPrivateKey,$OSSLPKey); $phar->setSignatureAlgorithm(Phar::OPENSSL,$OSSLPKey); 

जिप और टीएआर

PHAR ज़िप और TAR अभिलेखागार पढ़ने का समर्थन करता है। उसी समय, पढ़ना ऐसा होता है मानो यह एक नियमित PHAR संग्रह हो। हालांकि, यह याद रखना चाहिए कि नाम की लंबाई 255 बाइट्स से अधिक नहीं होनी चाहिए, जिसमें फ़ाइल का पथ भी शामिल है, और यह भी कि संग्रह के लिए निष्पादन योग्य होने के लिए, इसके नाम में '.phar' होना चाहिए (उदाहरण के लिए, habr। Phar। GZ)
अभिलेखागार को दो एल्गोरिदम में से एक का उपयोग करके संकुचित किया जाता है: gzip या bzip2।
कृपया ध्यान दें कि php.ini में phar.readonly = 1 होने पर भी ज़िप और TAR अभिलेखागार बनाए जा सकते हैं, लेकिन इस मामले में उनके पास नाम में कोई स्टब फ़ाइल या '.phar' नहीं हो सकती है।
पुरालेख प्रारूप परिवर्तित करें
पुरालेख रूपांतरण दो तरीकों से किया जा सकता है:

1. चरण :: ConvertToData (), जो तीन पैरामीटर लेता है: स्वरूप (Phar :: TAR, Phar :: ZIP), कम्प्रेशन (Phar :: NONE, Phar :: GZ, Phar :: BZ2) और एक्सटेंशन (.tar)। .tar.bz2, .tar.gz, .zip)।

2. चरण :: ConvertToExecutable (), जो अंतिम-एक्सटेंशन को छोड़कर सभी समान मापदंडों को स्वीकार करता है। कई और विकल्प उपलब्ध हैं जो फिर भी PHAR, ZIP या TAR स्वरूपों पर आधारित हैं: क्रमशः .phar, .phar.gz, .phar.bz2, .phar.tar, .phar.tar.gz, .phar.tar.bz2। , .phar.zip

दबाव

जैसा कि मैंने ऊपर लिखा है, दो संपीड़न विधियाँ उपलब्ध हैं: Gzip और Bzip2, जबकि आप संग्रह और उसके बाद की फ़ाइलों दोनों को संपीड़ित कर सकते हैं।
संग्रह को संपीड़ित करने के लिए, आपको सेक () विधि का उपयोग करने की आवश्यकता है, जो दो मापदंडों को लेती है - संपीड़न का प्रकार और फ़ाइल एक्सटेंशन:

 $phar=new Phar('habr.phar'); $phar->buildFromDirectory('habr/'); if (Phar::canCompress(Phar::GZ)) { $phar->compress(Phar::GZ,'.phar.gz'); } else if (Phar::canCompress(Phar::BZ2)) { $phar->compress(Phar::BZ2,'.phar.bz2'); } 

फ़ाइल संपीड़न के लिए - एक पैरामीटर के साथ compressFiles () - संपीड़न प्रकार:

 $phar=new Phar('habr.phar'); $phar->buildFromDirectory('habr/'); if (Phar::canCompress(Phar::GZ)) { $phar->compressFiles(Phar::GZ); } else if (Phar::canCompress(Phar::BZ2)) { $phar->compressFiles(Phar::BZ2); } 

उत्पादकता

एपीसी का उपयोग करते समय, PHAR प्रदर्शन 6 गुना तक बढ़ जाता है।
कैशिंग के बिना - लगभग PHAR के समान ही।

परिणाम

और इसलिए, संक्षेप में:

• PHAR स्थापित करना आसान है, या यों कहें, यह मानक PHP 5.3 वितरण का हिस्सा है।
• इसका उपयोग करना आसान है।
• तैनाती के लिए आसान - सिर्फ एक फ़ाइल।
• यह अच्छी तरह से संरक्षित है - हस्ताक्षर, ओपनएसएसएल।
• इसमें उच्च प्रदर्शन है।