वाक्य-विन्यास

1. सॉफ्टेन हेरेडोक और नॉवडॉक सिंटैक्स आवश्यकताएँ
2. समारोह और विधि कॉल में अल्पविराम के लिए समर्थन
3. list() में लिंक list()

पदावनत सुविधाएँ (पदावनत)

1. image2wbmp() फ़ंक्शन को हटा दिया गया
2. FILTER_FLAG_SCHEME_REQUIRED का उपयोग करते समय झंडे FILTER_FLAG_SCHEME_REQUIRED और FILTER_FLAG_HOST_REQUIRED
3. पंजीकृत स्वतंत्र स्थिरांक

नई सुविधाएँ

1. json_encode और json_decode में त्रुटियों के लिए वैकल्पिक अपवाद json_decode
2. is_countable() फ़ंक्शन को जोड़ना
3. कार्यों को जोड़ना array_key_first() और array_key_last()

परिवर्तन

1. PCRE से PCRE2 में माइग्रेट करना

सॉफ्टेन हेरेडोक और नॉवडॉक सिंटैक्स आवश्यकताएँ

Heredoc और Nowdoc ने क्लोजिंग आइडेंटिफायर को पहली बार एक नई लाइन में डालने की मांग की।

एक उदाहरण:

 $foo = <<<IDENTIFIER the crazy dog jumps over the lazy fox "foo" bar; IDENTIFIER 

यहाँ, समापन IDENTIFIER काम करने के लिए नई लाइन पर पहला वर्ण होना चाहिए। इसके अलावा, समापन पहचानकर्ता (छोड़कर ; जो वैकल्पिक है) के बाद कोई अन्य वर्ण नहीं होना चाहिए था।

PHP 7.3 के लिए RFC कोड की पठनीयता में सुधार के लिए इन आवश्यकताओं को हटाने का सुझाव देता है। सबसे पहले, heredoc/nowdoc पहचानकर्ताओं का उपयोग करते समय इंडेंटेशन जोड़ने के लिए।

heredoc/nowdoc सिंटैक्स में परिवर्तन की पूरी सूची:

1. समापन पहचानकर्ता को स्ट्रिंग में पहला वर्ण होना आवश्यक नहीं है।
2. समापन पहचानकर्ता रिक्त स्थान या टैब से प्रेरित है।
3. इंडेंटेशन (रिक्त स्थान या टैब) मिश्रित नहीं होना चाहिए। यदि आप ऐसा करते हैं, तो आपको Parse error: Invalid indentation - tabs and spaces cannot be mixed in .. on line .. मिलेगी Parse error: Invalid indentation - tabs and spaces cannot be mixed in .. on line ..
4. समापन पहचानकर्ता से पहले उपयोग किए जाने वाले रिक्त स्थान / टैब की सटीक संख्या को heredoc/nowdoc अभिव्यक्ति की प्रत्येक पंक्ति से हटा दिया जाएगा।
5. यदि समापन पहचानकर्ता से पहले उपयोग किए जाने वाले इंडेंट पात्रों की संख्या अभिव्यक्ति की किसी भी रेखा से अधिक है, तो आपको Parse error: Invalid body indentation level (expecting an indentation level of at least ..) in .. on line .. मिलेगी Parse error: Invalid body indentation level (expecting an indentation level of at least ..) in .. on line ..
6. समापन पहचानकर्ता के बाद कई अभिव्यक्तियाँ त्रुटियों के बिना काम करेंगी

यहाँ एक स्निपेट है जो नए नियमों को तोड़े बिना नई सुविधाओं का लाभ लेता है:

 $foo = ['foo', 'bar', <<<EOT baz - hello world! -- ahoy EOT, 'qux', 'quux' ]; var_dump($foo); 

उत्पादन होगा:

 array(5) {        [0]=>           string(3) "foo" [1]=>           string(3) "bar" [2]=>           string(29) "baz - hello world! -- ahoy" [3]=> string(3) "qux" [4]=> string(4) "quux" }     ` 

ध्यान दें कि heredoc उपयोग करते हुए घोषणा में उपयोग किए गए इंडेंटेशन को var_dump() के आउटपुट में प्रदर्शित नहीं किया गया है, और हम EOT पहचानकर्ता के बाद सरणी के तत्वों को सूचीबद्ध करना जारी रखते हैं।

RFC , Externals.io पर चर्चा , कार्यान्वयन

पिछड़े संगतता प्रभाव

जब तक आप एक पंक्ति की शुरुआत के रूप में समान heredox/nowdoc वर्ण पहचानकर्ताओं के सेट का उपयोग करते हैं, तब तक आप घोड़े पर हैं।

 $foo = <<<HELLO HELLO_WORLD <--         HELLOWORLD <--     HELLO WORLD <--    HELLO; 

यदि आपके पास ऊपर वर्णित एक के समान heredoc/nowdoc सिंटैक्स है, तो मैं ध्यान देता हूं कि PHP 7.3 के साथ, PHP पहले HELLO शाब्दिक को स्वीकार करेगा और अगली पंक्ति पर एक त्रुटि फेंक देगा। पहले के संस्करणों में, HELLO WORLD हेरेडोक के लिए एक पहचानकर्ता के रूप HELLO WORLD नहीं माना जाता HELLO WORLD । इसे इंगित करने के लिए Reddit के साथ धन्यवाद / u / ImSuperObjective2

समारोह और विधि कॉल में अल्पविराम के लिए समर्थन

यह एक सरल परिवर्तन है जो फ़ंक्शन कॉल और विधियों में कॉलिंग ट्रेल्स के उपयोग की अनुमति देता है। यह घोषणा को प्रभावित नहीं करता है।

उदाहरण के लिए, निम्नलिखित सिंटैक्स संभव हो जाएगा:

 //  foo('bar', 'baz',); //        'baz' 

पूर्व PHP-7.3 संस्करणों में, ऊपर वाला स्निप एक PHP Parse error: syntax error, unexpected ')' in .. on line ..

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

ध्यान दें कि आप फ़ंक्शन / विधि घोषणाओं में इस सुविधा का उपयोग नहीं कर सकते हैं; यह गलत है:

 function foo($bar, $baz, ) { // nah, you can't do this. } 

RFC , Externals.io पर चर्चा , कार्यान्वयन

पिछड़े संगतता प्रभाव

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

list() में लिंक list()

किसी सरणी से चर के मूल्यों को जल्दी से असाइन करने के लिए list() फ़ंक्शन उपयोगी है। PHP 7.3 से पहले, संदर्भ द्वारा एक चर निर्दिष्ट करना संभव नहीं था। PHP 7.3 से पहले, निम्नलिखित स्निपेट से एक घातक त्रुटि हुई:

 $arr = ['apple', 'orange']; list($a, &$b) = $arr; $b = 'banana'; echo $arr[1]; // Fatal error: [] and list() assignments cannot be by reference in .. on line .. 

non-referencable चर को संदर्भित करना असंभव है: list($a, &$b) = [12, 14]; Fatal error: Cannot assign reference to non referencable value in .. on line ..

RFC , Externals.io पर चर्चा , कार्यान्वयन

पिछड़े संगतता प्रभाव

नहीं। कई चर को आबाद करने के लिए list() का उपयोग करने के बजाय, मैं आपको चीजों को सरल बनाने के लिए मूल्य वस्तुओं का उपयोग करने का सुझाव दूंगा। वे अभी भी संदर्भ से पारित हो जाएंगे, लेकिन आपके कोड को बहुत अधिक क्लीनर बना देंगे।

image2wbmp() फ़ंक्शन को हटा दिया गया

image2wbmp() एक्सटेंशन से image2wbmp() फ़ंक्शन का उपयोग WBMP (वायरलेस बिटमैप) प्रारूप में छवियों को आउटपुट करने के लिए किया जाता है। PHP 7.3 में, यह imagewbmp() फ़ंक्शन के पक्ष में imagewbmp() ।

यदि आप image2wbmp() उपयोग करते हैं, तो बस फ़ंक्शन नाम को imagewbmp बदल imagewbmp और सबकुछ ठीक हो जाएगा! 5,500 image2wbmp() से 5,500 image2wbmp() पर बनाम 39,300 imagewbmp() । ऐसा लगता है कि PHP की विकास टीम प्रभाव को कम करने के लिए कम उपयोग की जाने वाली सुविधाएँ ले रही है।

RFC , Externals.io पर चर्चा , कार्यान्वयन

पिछड़े संगतता प्रभाव

यदि आप image2wbmp() फ़ंक्शन का उपयोग करते हैं, तो कॉल को imagewbmp से imagewbmp । स्वचालन का लाभ उठाएं जो आपके लिए इसे बदल सकता है।

FILTER_FLAG_SCHEME_REQUIRED का उपयोग करते समय झंडे FILTER_FLAG_SCHEME_REQUIRED और FILTER_FLAG_HOST_REQUIRED

यह एक अग्रगामी आंदोलन है। जब आप filter_var($var, FILTER_VALIDATE_URL) , तो दो अतिरिक्त झंडे होते हैं, जो सख्त URL जाँच सुनिश्चित करने के लिए सेट किए जा सकते हैं: FILTER_FLAG_SCHEME_REQUIRED और FILTER_FLAG_HOST_REQUIRED ।
PHP 5.2.1 के साथ शुरू, इन दोनों झंडों को इस बात पर ध्यान दिए बिना लगाया जाता है कि वे सेट हैं या नहीं।

यदि आपका कोड इन झंडों का उपयोग करता है, तो उन्हें हटा दें और यह ठीक हो जाएगा। वर्तमान में 5,000 से अधिक गितुब खोज परिणाम उनका उपयोग कर रहे हैं।

RFC , Externals.io पर चर्चा , कार्यान्वयन

पिछड़े संगतता प्रभाव

चूंकि इन दोनों झंडों को हटा दिया गया है, इसलिए आपको एक अधिसूचना दिखाई देगी जैसे:

 Deprecated: filter_var(): explicit use of FILTER_FLAG_SCHEME_REQUIRED and FILTER_FLAG_HOST_REQUIRED is deprecated in ... 

आपको बस दो झंडे हटाने हैं, जैसे कि FILTER_VALIDATE_URL का उपयोग करते समय वे FILTER_VALIDATE_URL से FILTER_VALIDATE_URL निहित हैं।

पंजीकृत स्वतंत्र स्थिरांक

define() फ़ंक्शन आपको केस-असंवेदनशील मोड में एक निरंतर घोषित करने की अनुमति देता है। आपको स्पष्ट रूप से फ़ंक्शन के तीसरे पैरामीटर को true करके केस-संवेदी स्थिर घोषित करना चाहिए। यह डिफ़ॉल्ट व्यवहार नहीं है और शायद const कीवर्ड के माध्यम से const घोषित करने की क्षमता के अनुरूप नहीं है।

 define('Foo', 'Bar', true); 

उपरोक्त कोड एक अप्रचलन अधिसूचना को फेंक देगा: Deprecated: define(): Declaration of case-insensitive constants is deprecated in ...

इसके अलावा, जब आप Deprecated: Case-insensitive constants are deprecated. The correct casing for this constant is "Foo" ( FOO ) मोड में घोषित किए गए स्थिरांक तक पहुंचने का प्रयास करते हैं, तो आपको एक बहुत ही उपयोगी चेतावनी दिखाई देगी: Deprecated: Case-insensitive constants are deprecated. The correct casing for this constant is "Foo" Deprecated: Case-insensitive constants are deprecated. The correct casing for this constant is "Foo"

RFC , Externals.io पर चर्चा , कार्यान्वयन

पिछड़े संगतता प्रभाव

आपको आधार कोड पर जाना होगा, जहां रजिस्टर-स्वतंत्र स्थिरांक घोषित किए गए हैं और बाद में सही हैं। यह बेहद संभावना नहीं है कि इसके साथ कोई समस्या होगी, क्योंकि यह सभी उपयोग के मामलों को पकड़ने के लिए श्रमसाध्य है, लेकिन परिणामस्वरूप कोड स्पष्ट हो जाएगा।

मुझे जीथब पर इस उपयोग के कोई उदाहरण नहीं मिले हैं, लेकिन कम से कम द्रुपाल और वर्डप्रेस (दो काफी पुराने और परिपक्व PHP प्रोजेक्ट्स) में केस-इन्सेंसिव स्थिरांक हैं।

json_encode और json_decode में त्रुटियों के लिए वैकल्पिक अपवाद json_decode

मेरे पसंदीदा में से एक। इन सभी वर्षों के लिए, json_encode() और json_decode() PHP चर या json स्ट्रिंग्स में त्रुटियों के बारे json_decode() चुप json_decode() , जिसके कारण कोड को टैग किया गया था। यह मामला PHP की प्रसिद्ध आलोचना में भी था : खराब डिजाइन का एक भग्न ।

json_decode अमान्य इनपुट के लिए अशक्त रिटर्न देता है, जबकि null डीकोड किए गए JSON के लिए एक बिल्कुल सही वस्तु है। यह फ़ंक्शन पूरी तरह से अविश्वसनीय है, जब तक कि हर बार जब आप इसका उपयोग करते हैं तो आप json_last_error कहते हैं।

उस ब्लॉग पोस्ट के बाद 6 साल लग गए और हमें json की विफलताओं के बारे में एक त्रुटि प्राप्त करने का अवसर मिला:

 try { json_decode("{", false, 512, JSON_THROW_ON_ERROR); } catch (\JsonException $exception) { echo $exception->getMessage(); //  "Syntax error" } 

नया \JsonException का एक वंशज है, साथ ही JSON_THROW_ON_ERROR स्थिर और JsonException स्वयं वैश्विक नामस्थान में हैं।

मैं आपको इस सुविधा का उपयोग शुरू करने की अत्यधिक सलाह देता हूं। थर्ड-पार्टी लाइब्रेरी हैं, जैसे कि डेवरएम्ड / असाधारण-जसन , जो पीएचपी संस्करणों 7.2 और उससे नीचे के लिए समान कार्यक्षमता को लागू करते हैं। PHP कोर में इस फ़ंक्शन की उपस्थिति के साथ, आप इस पैकेज और टन बदसूरत टेम्पलेट कोड के टन को json_last_error() कॉल के साथ हर उस स्थान से हटा सकते हैं जहां आप json के साथ काम करते हैं।

RFC , Externals.io पर चर्चा , कार्यान्वयन

पिछड़े संगतता प्रभाव

कुछ भी नहीं अगर आप अपने स्वयं के अपवाद का उपयोग नहीं कर रहे हैं और / या एक ही नाम के साथ निरंतर।

is_countable() फ़ंक्शन को जोड़ना

PHP 7.2 में बहुत सारे अप्रचलित और छोटे कार्य हैं। यदि आप PHP 7.2 में हैं। कॉल count() एक गैर- countable चर का उपयोग करके, फिर PHP इस बारे में एक चेतावनी प्रदर्शित करेगा। सामान्य संपादन में, count() में उपयोग करने से पहले countable लिए परिणामी चर की जांच करने का प्रस्ताव था।

countable परिवर्तनीय एक सरणी या ऑब्जेक्ट है जो \Countable countable इंटरफ़ेस को लागू करता है। चूंकि सत्यापन के दौरान बहुत सारे बॉयलरप्लेट कोड का उपयोग किया जाएगा, PHP 7.3 ने एक नया फ़ंक्शन is_countable() , जो कि चर की जांच करता है ... अच्छी तरह से ... count() का उपयोग करने की संभावना।

मैंने is__countable () के लिए एक पॉलीफ़ाइल लिखा है यदि आप इस सुविधा का उपयोग शुरू करना चाहते हैं।

RFC , Externals.io पर चर्चा , कार्यान्वयन

पिछड़े संगतता प्रभाव

जब तक इसका अपना कार्य is_countable() , तब तक कोई समस्या नहीं होगी।

कार्यों को जोड़ना array_key_first() और array_key_last()

PHP में, सरणियों के साथ काम करने के लिए 75 अलग-अलग कार्य हैं, लेकिन अभी तक सरणी सूचक को बदलने या सभी कुंजियों पर ( array_keys() माध्यम से array_keys() परिवर्तित किए बिना किसी सरणी की पहली और अंतिम कुंजी प्राप्त करने का एक आसान तरीका नहीं है।

दो नए कार्य array_key_first() , array_key_first() और array_key_last() आपको ऐसा करने की अनुमति देता है।

RFC ने array_value_first() और array_value_last() जोड़ने का भी सुझाव दिया, लेकिन इस हिस्से ने वोट पास नहीं किया।

RFC , Externals.io पर चर्चा , कार्यान्वयन

पिछड़े संगतता प्रभाव

यदि आपने अपनी खुद की array_key_first() और array_key_last() फ़ंक्शन घोषित नहीं किए, तो कोई बात नहीं।

PCRE से PCRE2 में माइग्रेट करना

नियमित अभिव्यक्ति के साथ काम करने के लिए PHP लाइब्रेरी में पर्ल कम्पेटिबल रेगुलर एक्सप्रेशंस या शीघ्र ही पीसीआरई का उपयोग करता है। PHP 7.2 के बाद से, PCRE लिगेसी लाइब्रेरी के 8.x संस्करण का उपयोग किया गया है, और PHP में 7.3 PCRE2 पहले से ही उपयोग किया जाएगा। कृपया ध्यान दें कि PCRE2 को एक नया पुस्तकालय माना जाता है, हालाँकि यह PCRE (8.x) के साथ काफी हद तक संगत है।

नया पुस्तकालय पैटर्न सत्यापन में अधिक आक्रामक है और मौजूदा कोड में त्रुटियों को जन्म दे सकता है। निम्नलिखित स्निपेट PHP 7.3 के साथ अमान्य होगा:

 preg_match('/[\w-.]+/', ''); 

PHP एक चेतावनी फेंक देगी Warning: preg_match(): Compilation failed: invalid range in character class at offset 3 ।
पैटर्न के साथ समस्या: इसके लिए काम करने के लिए, हाइफ़न को अंत में ले जाना चाहिए या बच जाना चाहिए।

 preg_match('/[\w\-.]+/', ''); 

उपरोक्त कोड न केवल PHP 7.3 के साथ, बल्कि पुराने संस्करणों के साथ भी ठीक काम करेगा। नए पैटर्न में, हाइफ़न बच जाता है - to \- । यह सबसे आम समस्या है जिसका सामना आप संगतता समस्याओं को हल करते समय कर सकते हैं।

यह एक बहुत छोटा बदलाव है, लेकिन एक मौका है कि सब कुछ गलत हो जाएगा। त्रुटि संदेश नियमित अभिव्यक्ति में चरित्र की सटीक स्थिति को इंगित करता है। अपने कोड को ध्यान से देखें। Regex Buddy या अन्य समान सॉफ़्टवेयर के माध्यम से PCRE2 सिंटैक्स के साथ संगतता के लिए अपने नियमित अभिव्यक्तियों की जाँच करें। अधिक जानकारी के लिए PCRE2 सिंटैक्स और लीगेसी PCRE सिंटैक्स का वर्णन देखें।

RFC , Externals.io पर चर्चा , कार्यान्वयन

पिछड़े संगतता प्रभाव

चूंकि PCRE2 टेम्पलेट्स के बारे में अधिक चुस्त और सख्त है, इसलिए आपके कुछ प्रीग_मैच preg_match() और इसी तरह की कॉल काम नहीं कर सकती हैं। फिक्स केवल टेम्पलेट को अद्यतन करने से भिन्न होता है (उदाहरण के लिए, हाइफ़न से बचकर) पुन: टेम्प्लेट करना। सुनिश्चित करें कि आपके सभी परीक्षण पास हैं।