Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Wrong docblock parsed

Abierto
#230 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
48/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Estancado
Stack tecnológico
php
Área
tooling

Línea de trabajo

Empieza reproduciendo el comportamiento del parser con el snippet cancel_action y rastrea cómo se conserva el docblock /** @var \wpdb $wpdb */ a través de los tipos de nodo posteriores. Se considera terminado cuando el docblock no se asigna a la llamada do_action(), mientras que las asignaciones válidas a tipos de nodo compatibles permanecen intactas.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

public function cancel_action( $action_id ) {
        /** @var \wpdb $wpdb */
        global $wpdb;
        
        $updated = $wpdb->update(
	        $wpdb->actionscheduler_actions,
	        array( 'status' => self::STATUS_CANCELED ),
	        array( 'action_id' => $action_id ),
	        array( '%s' ),
	        array( '%d' )
        );
        if ( empty( $updated ) ) {
	        /* translators: %s: action ID */
	        throw new \InvalidArgumentException( sprintf( __( 'Unidentified action %s', 'woocommerce' ), $action_id ) );
        }
        do_action( 'action_scheduler_canceled_action', $action_id );
}

it assigns the /** @var \wpdb $wpdb */ docblock to the do_action( 'action_scheduler_canceled_action', $action_id ); which is completely wrong.

If type is not FuncCall/Return_/Variable/Echo_ it must reset the last_doc to null to fix this issue.

Lenguaje dominante
PHP
Estrellas
239
Forks
81
Merge medio
1 d 22 h
PR fusionados (30 d)
5

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de WordPress/phpdoc-parser

Todos los issues de WordPress/phpdoc-parser

Issues similares

Más issues de PHP

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.