Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

DocBlock for hooks not parsed correctly in some cases

Đang mở
#217 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
45/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Công nghệ
php
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu bằng cách tái hiện vấn đề với hai đoạn mã PHP trong issue và theo dõi cách các DocBlock của hook được phân tích. Công việc được xem là hoàn tất khi thẻ inline @since 1.2.3 được liên kết với hook đã import, còn các thẻ @since từ DocBlock ở cấp tệp thì không.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

While parsing the source for a plugin, I came across a case where the DocBlock for a hook isn't parsed correctly.

The code contains the following:

/**
 * Filters the filename to be required.
 *
 * @since 1.2.3
 *
 * @param string $filename The filename to require.
 */
require apply_filters( 'my-filter', 'some filename' );

The hook gets imported (including the description), but for some reason the @since tag is not. Instead, @since tags from the file-level DocBlock are associated with the hook.

Changing the code to the equivalent:

/**
 * Filters the filename to be required.
 *
 * @since 1.2.3
 *
 * @param string $filename The filename to require.
 */
$filename = apply_filters( 'my-filter', 'some filename' );
require $filename;

works just fine.

Ngôn ngữ chính
PHP
Star
239
Fork
81
Merge trung bình
16 giờ 29 phút
Pull request đã merge (30 ngày)
8

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của WordPress/phpdoc-parser

Tất cả issue của WordPress/phpdoc-parser

Issue tương tự

Thêm issue về PHP

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.