Có một DocBlock PHP nào mà tôi có thể sử dụng để biểu thị một thuộc tính phương thức ma thuật được thêm vào sau khi khởi tạo không?

Question

Tôi đang gửi các đối tượng PHP tới các tệp mẫu và rất thích viết tài liệu ở đầu tệp mẫu của tôi những thuộc tính của đối tượng (sử dụng __get) sẵn có và chúng là gì và làm cho chúng có sẵn để tìm kiếm mã.

Đây là một ví dụ.

Trong điều khiển của tôi:

$obj = new Template("welcomePage"); 
$obj->title = "Welcome!"; 
$obj->render(); 

Theo quan điểm của tôi/mẫu:

<?php 
/** 
* @var  $obj   Template The template data wrapper 
* @property $obj->title string  The page header text 
/* ?> 
<h1><?php echo $obj->title; ?></h1> 

Có một cái gì đó tương tự như sau đó sẽ làm việc? Cách tôi có nó bây giờ sẽ không tự động hoàn thành nếu tôi bắt đầu gõ $obj->, có nghĩa là tôi (hoặc một thành viên trong nhóm) cần tham khảo phần đầu của mẫu để tìm mỗi thuộc tính có sẵn.

Tôi đang cân nhắc việc mở rộng lớp Mẫu cho từng loại mẫu, nhưng có vẻ như chi phí không cần thiết vì tôi chỉ có thể thêm chuỗi và một mảng trên mỗi trang và tạo một lớp riêng biệt cho mỗi mẫu, mẫu từng phần và kết hợp của cả hai có vẻ hơi ngớ ngẩn.

Cảm ơn bạn ~

Answer 1

số lớp DocBlocks tài liệu, chứ không phải trường hợp.

Nói rằng, phpDocumentor có số lượng thẻ chú thích lớp cấp để lộ một số sự kỳ diệu:

• @property
• @property-read
• @property-write
• @method

Nhưng nó sẽ không hoạt động đối với các thuộc tính/phương thức dynamicall y được thêm vào lúc chạy vì các thuộc tính khác nhau giữa các cá thể.