คำแนะนำประเภทตัวแปรใน Netbeans (PHP)

แค่อยากรู้ว่ามีวิธีใน netbeans ที่จะให้คำแนะนำประเภทสำหรับตัวแปรปกติหรือไม่เพื่อให้ intellisense หยิบมันขึ้นมา ฉันรู้ว่าคุณสามารถทำได้สำหรับคุณสมบัติคลาสพารามิเตอร์ฟังก์ชันประเภทการส่งคืน ฯลฯ แต่ฉันคิดไม่ออกว่าจะทำอย่างไรกับตัวแปรปกติ เป็นสิ่งที่จะช่วยได้มากในสถานการณ์ที่คุณมีเมธอดที่สามารถส่งคืนอ็อบเจ็กต์ประเภทต่างๆ (เช่นตัวระบุตำแหน่งบริการ)

เช่น:

/**
 * @var Some_Service $someService
 */
$someService = ServiceLocator::locate('someService');

ในกรณีที่ใช้ $ someService หลังจากนั้น netbeans จะจัดเตรียมวิธีการที่มีอยู่ทั้งหมดที่กำหนดไว้ในคลาส Some_Service

บรรทัดเดียวคือสิ่งที่คุณต้องการ:

/* @var $varName Type_Name */

ดูบทความนี้ในบล็อก PHP ของ NetBeans: https://blogs.oracle.com/netbeansphp/entry/defining_a_variable_type_in

หมายเหตุ: อย่างน้อยในเวอร์ชัน 8.2; คีย์น่าจะเป็น:

• เครื่องหมายดอกจันเดียว ( /*แทน/**)
• การวางประเภทไว้หลังชื่อตัวแปร
• ไม่มีอะไรเลยก่อนและหลังการบอกใบ้ประเภท (ยกเว้นเว้นวรรคสีขาว แต่ก็ไม่ได้รับอนุญาตเมื่อความคิดเห็นไม่อยู่ในบรรทัดเดียว)

ฉันรู้ว่านี่เป็นคำถามที่เก่ากว่า แต่ฉันกำลังมองหาคำตอบที่คล้ายกันสำหรับ Eclipse / Zend Studio และสิ่งนี้ก็แก้ไขได้เช่นกัน

** โปรดทราบว่าต้องอยู่ในบรรทัดเดียวโดยมีการเปิดและปิดอย่างชัดเจนในลักษณะนี้ ...

/* @var $varName Type_Name */

ไม่มีรูปแบบอื่นไม่ว่า ...

/**
 * @var $varName Type_Name
 */ 

หรือ...

// @var $varName Type_Name

ดูเหมือนจะได้ผลเลย หวังว่าจะช่วยใครบางคน

คุณต้องการบันทึกตัวแปรเวทมนตร์ที่น่ารำคาญเหล่านั้นหรือไม่? (ฉันตอบคำถามนี้อยู่ในอันดับต้น ๆ ของผลลัพธ์ใน Google ฉันหวังว่านี่จะช่วยใครบางคนได้!)

@propertyแท็กช่วยให้คุณสามารถเอกสารมายากลตัวแปร PHP - ผู้ดำเนินการใช้และ__get() __set()ควรใช้แท็กในเอกสารที่นำหน้านิยามคลาสทันที:

/**
 * Class Contact
 * @property string $firstName
 * @property string $lastName
 */
class Contact extends Model {
   ...

สัญกรณ์นี้ทริกเกอร์การเติมข้อความอัตโนมัติทดสอบใน Netbeans 8.1 และ PhpStorm 2016.1

ตามรายงานข้อผิดพลาดนี้ไวยากรณ์จะเปลี่ยนไปในNetBeans 9 :

/* @var $variable VarType */    // vdoc1 (legacy syntax)
/** @var VarType $variable */   // vdoc (new syntax)

นอกจากนี้คุณควรต่อท้าย[]ชื่อคลาสเพื่อระบุอาร์เรย์ของวัตถุ:

/* @var $foos Foo[] */
$foos = // ...

foreach ($foos as $foo) {
    // $foo will be hinted as Foo here
}

และอย่าลืมuseคำพูดของคุณเช่นuse Foo;

ใน netbeans 8.0.2 เทมเพลตvdocให้สิ่งนี้แก่คุณ:

/* @var $variable type */

อย่างไรก็ตาม Netbeans จะไม่รู้จักสิ่งนี้และจะไม่ให้รายการเติมข้อความอัตโนมัติที่ถูกต้องสำหรับวัตถุของคุณ แทนที่จะใช้สิ่งนี้ก่อนการประกาศตัวแปรของคุณ:

/** @var objectType $varName */

ฉันไม่เคยเห็นการใช้งานที่ยอดเยี่ยมสำหรับสต็อกvdoc Template โดยเฉพาะอย่างยิ่งสำหรับตัวแปรคลาสที่จะใช้เป็นวัตถุ PDO หรือ PDOStatement

วิธีแก้ปัญหาหนึ่งที่ฉันใช้คือไปที่ Tools / Options / Editor / Code Templates (โดยเลือก PHP เป็นภาษาของคุณ) และเพิ่ม Template ใหม่ ผมเรียกว่าเหมืองแบะท่า จากนั้นภายใต้ข้อความที่ขยายให้ใช้เทมเพลตต่อไปนี้:

/** @var ${VAR_TYPE variableFromNextAssignmentType default="ClassName"} $$${VARIABLE variableFromNextAssignmentName default="variable"} */

สำหรับ NetBeans IDE 8.2 ไวยากรณ์จะเป็นดังนี้:

class foobar{
    /** @var string $myvar: optional description here **/
    protected static $myvar;
}

สิ่งนี้จะให้คำแนะนำประเภทอย่างเหมาะสมสำหรับตัวแปรคงที่อย่างน้อยที่สุด