Cách viết các phương thức ma thuật (_call và _callStatic) cho các IDE

Question

Sau nhiều năm hạnh phúc được viết mã trong notepad ++ và tuyệt vời, tôi đã khuyên bạn nên cung cấp một IDE PHP. Tôi đang thử phpStorm và nó có vẻ tốt đẹp. Hoàn thành mã và tài liệu là một tính năng tuyệt vời nhưng không hoạt động đối với tôi khi các phương pháp ma thuật được sử dụng. Có một công việc xung quanh để có được phpStorm để hiểu những gì đang xảy ra trong các phương pháp ma thuật?

tình hình của chúng tôi là một cái gì đó như thế này:

abstract class a { 
    public static function __callStatic($method,$args) 
    { 
     if(strpos($method,"get_by_") === 0) 
     { 
      //do stuff 
     } elseif(strpos($method,"get_first_by_") === 0) { 
      //do stuff 
     } elseif($method == "get_all") { 
      //do stuff 
     } 
    } 
} 

class b extends a { 
    // some more stuff 
} 

b::get_by_user_id(27); 
b::get_first_by_id(156); 
b::get_all(); 

Phương pháp callStatic ma thuật cho phép chúng tôi để có được một bộ sưu tập của các đối tượng thông qua 1 hay nhiều đối số tạo nên gọi hàm.

Tôi thấy rằng có một câu lệnh @method để sử dụng trong những trường hợp này nhưng phpStorm chỉ chọn lên đầu tiên của các câu lệnh này. Hơn nữa tôi chỉ có thể thiết lập kiểu trả về thành hỗn hợp khi tôi muốn có thể thiết lập nó như bất cứ lớp nào mà nó được gọi là (b trong ví dụ của tôi).

Bất kỳ ý tưởng hoặc đề xuất nào cũng sẽ rất biết ơn, cảm ơn.

Answer 1

Sử dụng lớp cấp PHPDoc bình luận - đặc biệt @method thẻ - hoạt động tốt trong PhpStorm:

/** 
* @method static someClass get_by_user_id(int $id) Bla-bla 
* @method static someClass get_first_by_id(int $id) 
*/ 
abstract class a { 
... 

Ở phía trên:

• @method - thẻ PHPDoc
• static - cho biết đây là phương pháp tĩnh
• someClass hoặc $this - kiểu trả
• get_by_user_id - Phương pháp tên
• (int $id) - Phương pháp chữ ký: ([[type] [parameter]<, ...>])
• Bla-bla - một số mô tả tùy chọn

Thông tin thêm về @method:

• http://www.phpdoc.org/docs/latest/references/phpdoc/tags/method.html
• https://github.com/phpDocumentor/phpDocumentor2/blob/develop/docs/PSR.md#711-method

P.S. Trong khi @method static hoạt động tốt trong PhpStorm (nói với IDE rằng phương thức là tĩnh) có thể không (chưa?) Được hỗ trợ bởi công cụ phpDocumentor thực tế (xin lỗi, đã không sử dụng nó một lúc).

---

Ngoài ra: (trong PhpStorm, tất nhiên) Settings | Inspections | PHP | Undefined | Undefined method --> Downgrade severity if __magic methods are present in class - nó sẽ không giúp đỡ hoàn thành mã cho các phương pháp như vậy trong bất kỳ cách nào, nhưng sẽ không đánh dấu những phương pháp kỳ diệu như lỗi "phương pháp xác định".vé

---

phpDocumentor của liên quan đến sử dụng RegEx/tên một phần cho @property/@method thẻ (làm thế nào nó có thể hữu ích cho các tài liệu và làm thế nào chút giúp đỡ nó có thể mang đến cho IDE thực tế khi đối phó với hoàn code):

• https://github.com/phpDocumentor/phpDocumentor2/issues/689

Answer 2

Hơi liên quan đến câu hỏi ban đầu:

Bạn cũng có thể xác định điều này trong tệp meta phpstorm. Dưới đây là ví dụ về phương pháp nhà máy (v2016.3):

// Define in .phpstorm.meta.php 
namespace PHPSTORM_META { 
    $STATIC_METHOD_TYPES = [ 
     \Factory::create('') => [], 
    ]; 
} 

// Then use in code 
$factory = new \Factory(); 
$user = $factory->create(\User::class); 
// Here you get autocomplete. 
$user->subscribe(); 

Bằng cách này bạn không cần phải bỏ qua mọi khả năng xảy ra ma thuật.

Có một số docs để biết chi tiết.