Hướng dẫn phpdoc intellij - phpdoc intellij

Đối với nhận xét tài liệu, IntelliJ & NBSP; IDEA cung cấp hoàn thành được bật theo mặc định. Intellij & nbsp; Idea tạo ra các cuống của các khối PHPDOC khi bạn nhập thẻ mở /** và nhấn enter, hoặc nhấn Alt+chèn và chỉ định cấu trúc mã (một lớp, một phương thức, một hàm, v.v.) vào tài liệu. Tùy thuộc vào sự lựa chọn của bạn, IntelliJ & NBSP; IDEA sẽ tạo các thẻ cần thiết hoặc thêm một sơ khai tài liệu trống.

Nếu bạn cần các thẻ cụ thể PHP bổ sung, IntelliJ & NBSP; Idea cung cấp hoàn thành mã cho thấy các tên thẻ có liên quan trong bối cảnh hiện tại. Nếu một thẻ nhất định có nhiều giá trị, hoàn thành mã cung cấp một danh sách các giá trị có sẵn.

Trong các bình luận của PHPDOC, IntelliJ & NBSP; IDEA hỗ trợ các tùy chọn định dạng tuân thủ các tiêu chuẩn mã hóa khác nhau, PEAR và các tiêu chuẩn mã hóa khác.

Nhận xét của PHPDOC trong mã nguồn của bạn có sẵn để tra cứu tài liệu nhanh, giúp bạn có được thông tin nhanh chóng cho bất kỳ biểu tượng được ghi chép nào. Bạn có thể mở chúng để xem xét trong cửa sổ Công cụ Tài liệu bằng cách nhấn Ctrl+Q.

Cài đặt plugin PHP

Chức năng này dựa trên plugin PHP cần được cài đặt và bật trong IDE của bạn.

Plugin chỉ có sẵn trong IntelliJ & nbsp; Idea Ultimate.

  1. Nhấn CTRL+ALT+S để mở cài đặt IDE và chọn.

  2. Chuyển sang tab Marketplace và sử dụng trường tìm kiếm để tìm plugin PHP.Marketplace tab and use the search field to find the PHP plugin.

  3. Nhấp vào Cài đặt và khởi động lại IDE nếu được nhắc.Install and restart the IDE if prompted.

Kích hoạt ý kiến ​​tài liệu

  1. Nhấn CTRL+ALT+S để mở cài đặt IDE và chọn.

  2. Chuyển sang tab Marketplace và sử dụng trường tìm kiếm để tìm plugin PHP.Enter section, select or clear Insert documentation comment stub checkbox.

Nhấp vào Cài đặt và khởi động lại IDE nếu được nhắc.

  1. Kích hoạt ý kiến ​​tài liệu

    • Trong phần Enter, chọn hoặc xóa Chèn tài liệu Nhận xét STUB STUB.

    • Tạo khối PHPDOC cho cấu trúc mã

    • Để gọi thế hệ của một khối PHPDOC, hãy thực hiện một trong những điều sau đây:Generate PHPDoc blocks, and choose the code construct to generate PHPDoc comments for.

    Hướng dẫn phpdoc intellij - phpdoc intellij

    Đặt Caret trước cấu trúc mã cần thiết (lớp, phương thức, chức năng, v.v.), nhập nhận xét khối mở /** và nhấn Enter.

  2. Trong menu ngữ cảnh trình chỉnh sửa, chọn và chọn cấu trúc mã để tạo các nhận xét PHPDoc cho.

Nhấn Alt+Chèn, sau đó chọn Tạo các khối PHPDOC và chọn cấu trúc mã để tạo các nhận xét PHPDoc cho.

Intellij & nbsp; Idea phân tích cấu trúc mã được chỉ định, trích xuất dữ liệu cho các tham số, giá trị trả về, biến hoặc trường nếu có thể và trên cơ sở này tạo ra một sơ khai của một khối tài liệu.

  1. Mô tả các tham số được liệt kê và trả về giá trị khi cần thiết. Intellij & nbsp; kiểm tra ý tưởng và xử lý cú pháp trong các bình luận theo cài đặt kiểm tra mã.

  2. Tạo thẻ trong khối bình luận PHPDoc

  3. Intellij & nbsp; Idea phân tích cấu trúc mã được chỉ định, trích xuất dữ liệu cho các tham số, giá trị trả về, biến hoặc trường nếu có thể và trên cơ sở này tạo ra một sơ khai của một khối tài liệu. Nếu cần thiết, bạn có thể điền vào thông tin bị thiếu.

Trong một khối PHPDOC, chọn dòng trống mong muốn và nhấn không gian Ctrl+.

Chọn thẻ có liên quan từ danh sách đề xuất.

  1. Nếu thẻ đã nhập có một số giá trị, hãy nhấn Ctrl+Space và chọn giá trị mong muốn từ danh sách đề xuất.Settings/Preferences dialog (Ctrl+Alt+S), go to .

  2. Định cấu hình định dạng bên trong các bình luận của PHPDOCPHPDoc tab an configure the desired appearance options by selecting or clearing the checkboxes.

  3. Bạn có thể định cấu hình sự xuất hiện của các nhận xét PHPDOC, trình bày tên lớp và thứ tự sắp xếp thẻ mặc định. Lưu ý rằng thẻ cho các thuộc tính không còn có thể định cấu hình, thẻ @var mặc định được chèn tự động. Xem https://github.com/phpdocumentor/fig-standards/pull/55 để biết chi tiết.return and throws values, and so on, by selecting or clearing the Use fully-qualified class names checkbox.

  4. Trong hộp thoại Cài đặt/Tùy chọn (CTRL+ALT+S), hãy truy cập.Sort PHPDoc tags checkbox.

    • Chuyển sang tab PHPDOC Một cấu hình các tùy chọn xuất hiện mong muốn bằng cách chọn hoặc xóa các hộp kiểm. and to add or remove the PHPDoc tag entries from the list.

    • Chỉ định cách bạn muốn IntelliJ & NBSP; Ý tưởng trình bày tên lớp cho các thuộc tính, tham số chức năng, trả về và ném các giá trị, v.v., bằng cách chọn hoặc xóa hộp kiểm Sử dụng tên lớp có đủ điều kiện đầy đủ. and to arrange the PHPDoc tag entries order.

Nếu cần thiết, hãy xác định cách các thẻ PHPDOC được tạo nên được sắp xếp bằng cách chọn hộp kiểm sắp xếp thẻ PHPDOC.

Sử dụng và để thêm hoặc xóa các mục thẻ PHPDOC khỏi danh sách.

Sử dụng và để sắp xếp các mục nhập thẻ PHPDOC.

  1. Sử dụng kiểm tra mã PHPDOCSettings/Preferences dialog (Ctrl+Alt+S), select .

  2. Intellij & nbsp; Idea cung cấp một bộ kiểm tra mã được xác định trước được nhắm mục tiêu tại các khối PHPDOC. Các kiểm tra này kiểm tra xem các lớp, phương thức, chức năng, biến và hằng số có được cung cấp nhận xét PHPDoc hay không và liệu các thẻ trong bình luận có khớp với mục được ghi lại hay không.PHPDoc node under PHP.

  3. Bật hoặc tắt kiểm tra PHPDOC

Trong hộp thoại Cài đặt/Tùy chọn (CTRL+ALT+S), chọn.

  1. Cho phép kiểm tra nhận xét PHPDOC bị thiếu.Missing PHPDoc Comment inspection.

  2. Trong khu vực tùy chọn, chọn các hộp kiểm bên cạnh loại phần tử cần thiết: lớp, phương thức, chức năng, biến hoặc hằng số.Options area, select the checkboxes next to the required element type: class, method, function, variable, or constant.

    Để ngăn chặn báo cáo lỗi nhận xét PHPDOC bị thiếu nếu phương thức hoặc hàm không chứa bất kỳ tham số hoặc giá trị trả về nào, hãy chọn PhpDoc bỏ qua hộp kiểm @param/ @return.Missing PHPDoc Comment error if a method or function does not contain any parameters or return values, select the Ignore PHPDoc without @param/@return checkbox.

Sửa đổi lần cuối: 14 tháng 7 năm 2022