Điểm của thẻ docblock php dư thừa như @static là gì?

Question

Khi sử dụng tự động thế hệ docblock php trong PhpStorm, tôi đã kết thúc với @static chú thích trên một phương pháp tĩnh:

/** 
* Reset the singleton instance, for the tests only 
* @static 
*/ 
public static function reset() { 
    self::$singletonInstance = null; 
} 

Có sử dụng cho các thẻ nếu họ có thể được suy ra từ mã? Tôi đang cố gắng quyết định xem tôi có nên bỏ nó hay loại bỏ nó (và làm như vậy ở mọi nơi để nó phù hợp).

Answer 1

Các thẻ này đã được giới thiệu cho mã PHP 4 cũ không cho phép sử dụng các từ khóa đó trong mã. Với PHP 5, mã có hiệu quả tự tài liệu, vì vậy các thẻ này thực sự thừa; Tôi không thấy lý do gì để giữ chúng xung quanh.

Thực tế, nếu bạn từng tạo tài liệu cho tệp nguồn PHP 5, phpDocumentor vẫn có thể xác định rằng đây là các phương thức tĩnh. Đây được đề cập trong phpDocumentor docs:

Chỉ cần sử dụng các từ khóa tĩnh trong mã của bạn là đủ cho phpDocumentor trên PHP5 để nhận ra các biến và phương pháp tĩnh, và phpDocumentor sẽ đánh dấu chúng là tĩnh.