Ctags: पीएचपी हेरेडोक (<<

को निर्मित 20 नव॰ 2020 · 8टिप्पणियाँ · स्रोत: universal-ctags/ctags

सारांश:

किसी फ़ाइल में PHP heredoc ( <<< ) सिंटैक्स का सामना करने पर टैग बनाना बंद हो जाता है। चूंकि nowdoc PHP सिंटैक्स मूल रूप से वही है, यह एक और भाषा तत्व है जो फ़ाइल पार्सिंग को तोड़ देता है।

पार्सर का नाम:

इस बारे में निश्चित नहीं है। पीएचपी मानते हुए

ctags चलाने के लिए आप जिस कमांड लाइन का उपयोग करते हैं:

$ ctags --options=NONE foo.php

इनपुट फ़ाइल की सामग्री:

<?php

class LivingBeings {

    public function doSomething()
    {
        $foo = <<<FOO
        FOO;
    }

    public function doSomethingElse()
    {
    }
}

टैग आउटपुट से आप संतुष्ट नहीं हैं:

फ़ाइल में doSomethingElse विधि सूचीबद्ध नहीं है। जैसे ही मैं heredoc भाग पर टिप्पणी करता हूं, विधि सामान्य रूप से अनुक्रमित होती है, जैसा कि आप आगे "अपेक्षित आउटपुट" अनुभाग में देख सकते हैं।

!_TAG_FILE_FORMAT   2   /extended format; --format=1 will not append ;" to lines/
!_TAG_FILE_SORTED   1   /0=unsorted, 1=sorted, 2=foldcase/
!_TAG_OUTPUT_EXCMD  mixed   /number, pattern, mixed, or combine/
!_TAG_OUTPUT_FILESEP    slash   /slash or backslash/
!_TAG_OUTPUT_MODE   u-ctags /u-ctags or e-ctags/
!_TAG_PATTERN_LENGTH_LIMIT  96  /0 for no limit/
!_TAG_PROC_CWD  /tmp/   //
!_TAG_PROGRAM_AUTHOR    Universal Ctags Team    //
!_TAG_PROGRAM_NAME  Universal Ctags /Derived from Exuberant Ctags/
!_TAG_PROGRAM_URL   https://ctags.io/   /official site/
!_TAG_PROGRAM_VERSION   5.9.0   /5a136315/
LivingBeings    foo.php /^class LivingBeings {$/;"  c
doSomething foo.php /^    public function doSomething()$/;" f   class:LivingBeings

आपके द्वारा अपेक्षित टैग आउटपुट:

!_TAG_FILE_FORMAT   2   /extended format; --format=1 will not append ;" to lines/
!_TAG_FILE_SORTED   1   /0=unsorted, 1=sorted, 2=foldcase/
!_TAG_OUTPUT_EXCMD  mixed   /number, pattern, mixed, or combine/
!_TAG_OUTPUT_FILESEP    slash   /slash or backslash/
!_TAG_OUTPUT_MODE   u-ctags /u-ctags or e-ctags/
!_TAG_PATTERN_LENGTH_LIMIT  96  /0 for no limit/
!_TAG_PROC_CWD  /tmp/   //
!_TAG_PROGRAM_AUTHOR    Universal Ctags Team    //
!_TAG_PROGRAM_NAME  Universal Ctags /Derived from Exuberant Ctags/
!_TAG_PROGRAM_URL   https://ctags.io/   /official site/
!_TAG_PROGRAM_VERSION   5.9.0   /5a136315/
LivingBeings    foo.php /^class LivingBeings {$/;"  c
doSomething foo.php /^    public function doSomething()$/;" f   class:LivingBeings
doSomethingElse foo.php /^    public function doSomethingElse()$/;" f   class:LivingBeings

ctags का संस्करण:

$ ctags --version
Universal Ctags 5.9.0(5a136315), Copyright (C) 2015 Universal Ctags Team
Universal Ctags is derived from Exuberant Ctags.
Exuberant Ctags 5.8, Copyright (C) 1996-2009 Darren Hiebert
  Compiled: Nov 20 2020, 11:46:20
  URL: https://ctags.io/
  Optional compiled features: +wildcards, +regex, +iconv, +option-directory, +xpath, +yaml, +packcc

आप ctags बाइनरी कैसे प्राप्त करते हैं:

इसे स्थानीय रूप से बनाना:

$ cd ctags_source
$ make clean && make distclean
$ ./autogen.sh
$ ./configure --prefix=$HOME
$ make
$ make install

Parser buenhancement

स्रोत

jespinal

सभी 8 टिप्पणियाँ

@jespinal , क्या आप इस बदलाव के बारे में बात कर रहे हैं: https://wiki.php.net/rfc/flexible_heredoc_nowdoc_syntaxes ?

masatake 21 नव॰ 2020

$ git diff |cat
git diff |cat
diff --git a/parsers/php.c b/parsers/php.c
index e3fdc241..ace25561 100644
--- a/parsers/php.c
+++ b/parsers/php.c
@@ -682,6 +682,8 @@ static void parseHeredoc (vString *const string)
            int extra = EOF;

            c = getcFromInputFile ();
+           if (c == ' ' || c == '\t')
+               c = getcFromInputFile ();
            for (len = 0; c != 0 && (c - delimiter[len]) == 0; len++)
                c = getcFromInputFile ();

$ cat input.php
cat input.php
<?php
// Taken from https://github.com/universal-ctags/ctags/issues/2717
// submitted by <strong i="5">@jespinal</strong>
class LivingBeings {

    public function doSomething()
    {
        $foo = <<<FOO
        FOO;
    }

    public function doSomethingElse()
    {
    }
}
$ u-ctags -o - input.php
u-ctags -o - input.php
LivingBeings    input.php   /^class LivingBeings {$/;"  c
doSomething input.php   /^    public function doSomething()$/;" f   class:LivingBeings
$

masatake 24 नव॰ 2020

@masatake यह पर्याप्त नहीं है, क्योंकि अंतिम मार्कर को अपनी लाइन पर होना

मैं जिस कार्यान्वयन का प्रस्ताव कर रहा हूं वह यह देखने के लिए जांच कर इस समस्या से बचाता है कि क्या पाया गया मार्कर की निरंतरता मौजूद है, और यदि ऐसा है, तो यदि यह एक वैध पहचानकर्ता बनाता है।

लेकिन मैं कहूंगा कि इसका मतलब यह है कि जब तक टर्मिनेटिंग मार्कर के साथ प्रीफ़िक्स्ड लाइन के बाद कोई आइडेंटिफ़ायर कैरेक्टर न हो, यह वास्तव में एक टर्मिनेटिंग मार्कर है। तो END; एक समाप्ति है (यह देखते हुए कि मार्कर END ), लेकिन ENDFOO नहीं है।

बीटीडब्लू, क्योंकि यह एक पिछड़ा असंगत वाक्य रचनात्मक परिवर्तन है, मुझे नहीं पता कि हम इसके बारे में क्या करना चाहते हैं। लेकिन मुझे लगता है कि अगर PHP इसे तोड़कर खुश है, तो हम भी कर सकते हैं, खासकर जब यह समस्या पैदा करने की काफी संभावना नहीं है। आदर्श रूप से मुझे लगता है कि हम *.php[1-6] लिए वर्तमान सिंटैक्स का उपयोग करेंगे और बाकी के लिए नया, लेकिन इसके लायक होने के लिए यह बहुत अधिक परेशानी हो सकती है।

b4n 24 नव॰ 2020

👍1

@jespinal , क्या आप इस बदलाव के बारे में बात कर रहे हैं: https://wiki.php.net/rfc/flexible_heredoc_nowdoc_syntaxes ?

क्षमा करें, @masatake , किसी कारण से मुझे आपके प्रश्न के बारे में सूचित नहीं किया गया था।

जी हां, मैं उस बदलाव की बात कर रहा हूं। लेकिन वह वास्तव में PHP 7.3 में लागू किया गया था (वर्तमान स्थिर संस्करण 7.4 है, और संस्करण 8 हाथ में है)। मुझे यकीन नहीं है कि ctags और PHP दोनों के विशाल उपयोगकर्ता-आधार को देखते हुए इसकी सूचना पहले क्यों नहीं दी गई थी।

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

इस उदाहरण में, ' TEXT ' (दूसरा वाला) अंतिम मार्कर है। तो, तीसरा वाला ' TEXT; पार्सर की दृष्टि में वाक्यात्मक रूप से अमान्य स्ट्रिंग है, क्योंकि यह केवल अर्धविराम या अल्पविराम की अपेक्षा करेगा:

test-001-2020-11-24 22-33-30

पिछले एक जैसा ही मामला:
test-003-2020-11-24 22-37-04

अगर यह अर्धविराम या अल्पविराम होता, तो PHP पार्सर खुश होता। उदाहरण के लिए

        echo <<<TEXT
            some string 
        TEXT, 'some other string';

पार्सर की नजर में, यह वही है:

    echo 'some string', 'some other string';

निम्नलिखित एक मान्य उदाहरण है, क्योंकि पार्सर जानता है कि ' TEXT ' और ' TEXTUAL ' दो अलग-अलग तार हैं:

test-002-2020-11-24 22-36-25

यहां गलत इंडेंटेशन के कारण कुछ अमान्य स्निपेट दिए गए हैं। विशेष रूप से, आरएफसी कथन के लिए: "यदि समापन मार्कर को शरीर की किसी भी रेखा से आगे इंडेंट किया जाता है, तो एक ParseError फेंक दिया जाएगा:"

test-004-2020-11-24 22-38-11

test-005-2020-11-24 22-39-38

jespinal 25 नव॰ 2020

@jespinal धन्यवाद, लेकिन अगर आपके पास मानक पाठ है जो और भी बेहतर है :) केवल कुछ मामलों पर आधारित तर्क का अनुमान लगाना हमेशा मुश्किल होता है, जबकि यदि हमारे पास मानक पाठ है तो हम इसे लागू कर सकते हैं और इसे उम्मीद से काम करना चाहिए। और वास्तव में, मुझे लगता है कि हमारे पास @masatake के लिंक और आपकी जानकारी के साथ पर्याप्त है: +1:

@masatake मैं हाल ही में मिले थोड़े समय के बाद कुछ भी वादा नहीं करता, लेकिन मैं इसे जल्द ही देखने की कोशिश करूंगा जब तक - आप मुझे हरा नहीं देते :)

BTW @jespinal अगर किसी ने शिकायत नहीं की तो मुझे वास्तव में लगता है कि ऐसा इसलिए है क्योंकि उन सिंटैक्स का बहुत कम उपयोग है, और हम प्री-7.3 सिंटैक्स का समर्थन करते हैं, इसलिए केवल एक ही मामले में कोई समस्या दिखाई देगी, वह 7.3+ सिंटैक्स उपयोग के साथ है, जिसका अर्थ है neredoc/nowdoc पहली जगह में :)

b4n 25 नव॰ 2020

👍1

आप कुछ समय के लिए निष्क्रिय थे। इसलिए मुझे आपसे कोई टिप्पणी मिलने की उम्मीद नहीं थी।
लेकिन, अब हमें आपसे "स्वयं-असाइन किया गया" चिह्न मिलता है। @ b4n , पेशकश के लिए धन्यवाद।

masatake 25 नव॰ 2020

@masatake आप बुद्धिमान थे कि मुझसे ज्यादा उम्मीद न करें, क्योंकि मुझे वास्तव में हाल ही में बहुत अधिक UCtags/Geany योगदान के लिए समय नहीं मिला: निराश:। मैं यह पता लगाने की कोशिश कर रहा हूं कि यहां फिर से समय कैसे आवंटित किया जाए, इसलिए मुझे उम्मीद है कि मैं फिर से और अधिक सक्रिय हो जाऊंगा, लेकिन मैं अभी वादा नहीं कर सकता।

फिर भी, समस्या के समाधान के लिए #2734 देखें :)

b4n 26 नव॰ 2020

धन्यवाद!

masatake 28 नव॰ 2020

क्या यह पृष्ठ उपयोगी था?

0 / 5 - 0 रेटिंग्स

Ctags: पीएचपी हेरेडोक (&lt;&lt;