Gợi ý kiểu biến trong Netbeans (PHP)

Bạn chỉ cần tò mò nếu có cách nào trong netbeans để đưa ra gợi ý kiểu cho các biến thông thường, để intellisense chọn nó. Tôi biết bạn có thể làm điều đó cho các thuộc tính lớp, tham số hàm, kiểu trả về, v.v. nhưng tôi không thể tìm ra cách làm điều đó cho các biến thông thường. Đó là thứ thực sự hữu ích trong những tình huống mà bạn có một phương thức có thể trả về các kiểu đối tượng khác nhau (như bộ định vị dịch vụ).

ví dụ như:

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

Khi sử dụng $ someService sau đó, netbeans sẽ cung cấp tất cả các phương thức có sẵn được xác định trong lớp Some_Service.

Một dòng duy nhất là tất cả những gì bạn cần:

/* @var $varName Type_Name */

Xem bài viết này trong Blog NetBeans PHP: https://blogs.oracle.com/netbeansphp/entry/defining_a_variable_type_in

Lưu ý: Ít nhất, trong phiên bản 8.2; Chìa khóa dường như là:

• Dấu hoa thị đơn ( /*thay vì /**).
• Đặt kiểu sau tên biến.
• Không có gì trước và sau gợi ý kiểu (ngoại trừ khoảng trắng, nhưng ngay cả điều đó cũng không được phép khi chú thích không nằm trong một dòng).

Tôi biết đây là một câu hỏi cũ hơn, nhưng tôi đã tìm kiếm một câu trả lời tương tự cho Eclipse / Zend Studio và điều này cũng đã giải quyết được nó.

** Tuy nhiên, lưu ý rằng nó phải nằm trên một dòng với việc mở và đóng rõ ràng theo kiểu này ...

/* @var $varName Type_Name */

Không có định dạng nào khác cho dù ...

/**
 * @var $varName Type_Name
 */ 

hoặc là...

// @var $varName Type_Name

dường như hoạt động ở tất cả. Hy vọng rằng sẽ giúp một ai đó.

Bạn đang muốn ghi lại những biến số ma thuật khó chịu đó? (Tôi đã làm; Câu hỏi này hiện xếp hạng kết quả hàng đầu cho câu hỏi đó trên Google. Tôi hy vọng điều này sẽ giúp ích cho ai đó!)

Các @propertythẻ cho phép bạn ghi lại ma thuật biến php - những triển khai sử dụng __get()và __set(). Thẻ nên được sử dụng trong tài liệu ngay trước định nghĩa lớp:

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

Ký hiệu này kích hoạt tính năng tự động hoàn thành, được thử nghiệm trong Netbeans 8.1 và PhpStorm 2016.1.

Theo báo cáo lỗi này , cú pháp sẽ thay đổi trong NetBeans 9 :

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

Ngoài ra, điều đáng nói là bạn có thể thêm []vào một tên lớp để chỉ ra một mảng các đối tượng:

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

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

Và đừng quên usetuyên bố của bạn , ví dụ:use Foo;

Trong netbeans 8.0.2, mẫu vdoc cung cấp cho bạn điều này:

/* @var $variable type */

Tuy nhiên, Netbeans sẽ không nhận ra điều này và sẽ không cung cấp cho bạn danh sách tự động hoàn thành chính xác cho các đối tượng của bạn. Thay vào đó, hãy sử dụng điều này, ngay trước khai báo biến của bạn:

/** @var objectType $varName */

Tôi đã không thực sự thấy một cách sử dụng tuyệt vời cho Mẫu vdoc cổ phiếu , đặc biệt là đối với các biến lớp sẽ được sử dụng làm đối tượng PDO hoặc PDOStatement.

Một giải pháp mà tôi sử dụng thực sự là vào Công cụ / Tùy chọn / Trình chỉnh sửa / Mẫu mã (với PHP được chọn làm Ngôn ngữ của bạn) và thêm Mẫu mới. Tôi đã gọi gợi ý của mình . Sau đó, trong Văn bản mở rộng, hãy sử dụng mẫu sau:

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

Đối với NetBeans IDE 8.2, cú pháp như sau:

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

Điều này ít nhất sẽ cung cấp gợi ý kiểu phù hợp cho các biến tĩnh.