Lưu thứ tự chức năng trong phpdoc

Question

Tôi đang chạy phpdoc trên dự án của mình và có tệp (tệp chỉ có ý nghĩa), trong đó thứ tự các phương pháp quan trọng đối với các phương pháp nhóm. Làm cách nào tôi có thể có cùng thứ tự các hàm trong tài liệu được tạo như trong tệp nguồn?

Thực ra, tôi đã sẵn sàng thay đổi khung tài liệu, nếu nó giúp.

Answer 1

Tôi nghĩ rằng không thể khai báo một đơn đặt hàng cụ thể.

Có thể xây dựng @package s tho, có nghĩa là cho không gian tên trong PHP (afaik ..).

Nếu bạn đã khai báo @package, bạn có thể xác định @subpackage s cho các phương pháp/chức năng nhóm.

<?php 
namespace Stackexchange\Stackoverflow; 
/** 
* My Answer 
* @package Stackexchange\Stackoverflow 
* @see http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.subpackage.pkg.html 
*/ 

class Answer 
{ 
    /** 
    * @subpackage SomeSubGroup 
    * @return $this 
    */ 
    public function doSomething { 
     return $this; 
    } 

    /** 
    * @subpackage SomeOtherSubGroup 
    * @return $this 
    */ 
    public function doSomethingDifferent { 
     return $this; 
    } 
} 

Bên cạnh tính năng nhóm, bạn nên cố gắng cải thiện chương trình của mình bằng cách chia lớp học ngữ nghĩa và logic thành các phần kinh doanh nhỏ hơn.

Answer 2

kiểm tra url dưới đây để biết các bước để ghi lại một chương trình PHP,

http://pear.php.net/manual/en/package.php.phpdocumentor.intro.php

Answer 3

Thật không may, nó không xuất hiện ở đó là một cách để nói với Documenter gì để liệt kê các phương pháp trong.

Tuy nhiên, @see có thể hữu ích để bạn thu hút sự chú ý đến các chức năng liên quan. Điều đó kết hợp với một lưu ý trong mô tả đầy đủ về thứ tự cần thiết, hoặc một số ngoại lệ đặt hàng có thể là công cụ tốt nhất hiện có thể cung cấp.