Làm cách nào để sửa lỗi triển khai Hook Hook không nên sao chép tài liệu @param.

Tôi đang sử dụng PhpStorm để thử nghiệm làm sạch mã của mình trong một mô-đun tùy chỉnh. Đối với chức năng sau, tôi nhận được cảnh báo này:

Hook triển khai không nên trùng lặp tài liệu @param.

/**
 * Implements hook_field_widget_form_alter().
 *
 * @param array $element
 * @param array $form_state
 * @param array $context
 */
function mymodule_field_widget_form_alter(&$element, $form_state, $context) {
  if ($context['widget'] instanceof \Drupal\text\Plugin\Field\FieldWidget\TextareaWidget) {
    $element['#after_build'][] = '_mymodule_remove_textarea_help';
  }
}

Tôi nên làm gì để khắc phục điều này? Tôi nghĩ rằng tôi cần phải xóa các @parambình luận, nhưng khi tôi làm điều đó, PhpStorm phàn nàn rằng tôi không có bất kỳ bình luận param nào.

Vấn đề là nếu bạn đang thực hiện một hook và bạn không cần phải viết nhiều hơn thế này:

/**
 * Implements hook_field_widget_form_alter().
 */

Bởi vì bạn sẽ có tất cả thông tin trong hook_field_widget_form_alter()định nghĩa, vì vậy chỉ cần viết luôn trong phần triển khai hook chỉ này:

/**
 * Implements hook_hook_name().
 */

Trong trường hợp của bạn:

/**
 * Implements hook_field_widget_form_alter().
 */
function mymodule_field_widget_form_alter(&$element, $form_state, $context) {
  if ($context['widget'] instanceof \Drupal\text\Plugin\Field\FieldWidget\TextareaWidget) {
    $element['#after_build'][] = '_mymodule_remove_textarea_help';
  }
}

Thêm một câu trả lời cho hậu thế; theo nhận xét của Clive:

Bạn cần tắt kiểm tra PHPStorm tích hợp để kiểm tra "Thiếu bình luận PHPDoc", sau đó bạn có thể xóa các @paramkhối của mình một cách an toàn .

Như những người khác đã nói, bạn cần đặt cấu hình PHPStorm để coi dự án của bạn là một dự án Drupal.

Thứ hai, hãy đứng dậy và chạy với Coder .

Khi bạn đã cài đặt các gói đó, bạn có thể kết nối chúng trong PHPStorm và thiết lập hệ thống tiêu chuẩn của bạn phù hợp hoặc chỉ chạy các báo cáo từ dòng lệnh. Điều này sẽ làm cho môi trường của bạn phù hợp hơn với các tiêu chuẩn mã hóa Drupal thay vì các tiêu chuẩn chung có PHPStorm ra khỏi cấu hình hộp.