Activación del evento WP cron, pero no alcanza el punto de interrupción en la depuración

Tengo un problema que no puedo resolver. Configuré un cronograma de WP personalizado y un evento cron de WP con ese cronograma. Estoy usando PHPStorm para depurar y he establecido un punto de interrupción dentro del gancho check_mail(). El punto de interrupción nunca se alcanza, sin embargo, el código dentro de check_mail() se ejecuta ya que puedo ver la entrada en mi archivo de registro (“¡Tengo que verificar_mail()!”)

Todos los demás puntos de interrupción funcionan bien y la rutina check_mail() tiene solo dos líneas de código: la escritura de registro y un retorno.

¿Cómo sucede que el código se ejecuta pero mi punto de interrupción nunca se alcanza?

En el constructor:

add_action( 'check_mail', array($this, 'check_mail' ), 10, 0);

if ( !defined( 'DOING_AJAX' ) || !DOING_AJAX ) {
    add_action( 'init', array( $this, 'schedule_wp_cron' ), 10, 0 );
}

Las rutinas de apoyo:

public function schedule_wp_cron()
{
    /**
     * Avoid rescheduling cron if it's already scheduled.
     */

    $args = array( );

    if ( !wp_next_scheduled( 'check_mail' )) {

        /**
         * Schedule mail server polling.
         */
        wp_schedule_event( time(), 'custom_interval', 'check_mail');

        }

    }

    public function check_mail( )
    {

        // **BREAKPOINT SET ON NEXT LINE**
        write_log( 'emails', 'Got to check_mail()!' );

        //... do something ...

        return;

    }


    public function custom_cron_schedule( $schedules )
    {

        $schedules[ 'custom_interval' ] = array(
            'interval' => 300,
            'display'  => 'Custom Interval',
        );

        return $schedules;
    }

Las tareas de WP Cron se ejecutan en un proceso separado mediante una solicitud POST remota. PhpStrom no se detendrá en ningún punto de interrupción establecido en su código, porque el parámetro de inicio de sesión de depuración no está presente en la solicitud.

Aquí está la solución. El filtro agregará parámetros adicionales a todas las solicitudes de WP Cron. Reemplazar XDEBUG_SESSION_START valor al suyo (he usado el valor predeterminado) y coloque el código debajo de su complemento o código de tema. PhpStorm se detendrá en cualquier punto de interrupción, incluso para tareas cron.

add_filter( 'cron_request', 'wp_cron_debug', 10, 2 );
function wp_cron_debug( $args, $doing_cron ) {

    $args['url'] = add_query_arg( array(
        'XDEBUG_SESSION_START' => 'PHPSTORM' // <== replace PHPSTORM with your key
    ), $args['url'] );

    return $args;

}

Ubicación del valor clave de PhpStrom IDE

¡Espero eso ayude!

La respuesta de Pavel funcionó a las mil maravillas para mí y he estado buscando una respuesta a esto durante varios días.

Pero cuanto más lo pensaba, quería una solución más general… una en la que no tuviera que codificar una clave IDE específica.

Esto es lo que se me ocurrió:

add_action ('cron_request', 'so_add_cron_xdebug_cookie', 10, 2) ;

/**
 * Allow debugging of wp_cron jobs
 *
 * @param array $cron_request_array
 * @param string $doing_wp_cron
 *
 * @return array $cron_request_array with the current XDEBUG_SESSION cookie added if set
 */
function
so_add_cron_xdebug_cookie ($cron_request_array, $doing_wp_cron)
{
    if (empty ($_COOKIE['XDEBUG_SESSION'])) {
        return ($cron_request_array) ;
        }

    if (empty ($cron_request_array['args']['cookies'])) {
        $cron_request_array['args']['cookies'] = array () ;
        }
    $cron_request_array['args']['cookies']['XDEBUG_SESSION'] = $_COOKIE['XDEBUG_SESSION'] ;

    return ($cron_request_array) ;
}