函数文档

wp_finalize_scraping_edited_file_errors()

💡 云策文档标注

概述

wp_finalize_scraping_edited_file_errors() 函数用于在 WordPress 中完成对编辑文件错误的抓取处理,主要输出错误信息或成功状态。

关键要点

  • 函数接受一个必需的参数 $scrape_key,作为抓取操作的标识符。
  • 通过 error_get_last() 获取最后发生的错误,并检查其类型是否为严重错误(如 E_CORE_ERROR、E_COMPILE_ERROR 等)。
  • 如果存在严重错误,会移除 ABSPATH 前缀后输出 JSON 编码的错误信息;否则输出 true 表示成功。
  • 输出结果被包裹在特定标记中,便于识别和处理。

代码示例

function wp_finalize_scraping_edited_file_errors( $scrape_key ) {
    $error = error_get_last();

    echo "n###### wp_scraping_result_start:$scrape_key ######n";

    if ( ! empty( $error )
        && in_array( $error['type'], array( E_CORE_ERROR, E_COMPILE_ERROR, E_ERROR, E_PARSE, E_USER_ERROR, E_RECOVERABLE_ERROR ), true )
    ) {
        $error = str_replace( ABSPATH, '', $error );
        echo wp_json_encode( $error );
    } else {
        echo wp_json_encode( true );
    }

    echo "n###### wp_scraping_result_end:$scrape_key ######n";
}

注意事项

  • 此函数主要用于内部错误处理,开发者应确保 $scrape_key 参数正确传递以匹配抓取上下文。
  • 错误类型检查基于 PHP 错误常量,需注意环境兼容性。
  • 输出格式固定,便于外部系统解析,不应随意修改标记结构。

📄 原文内容

Finalizes scraping for edited file errors.

Parameters

$scrape_keystringrequired
Scrape key.

Source

function wp_finalize_scraping_edited_file_errors( $scrape_key ) {
	$error = error_get_last();

	echo "n###### wp_scraping_result_start:$scrape_key ######n";

	if ( ! empty( $error )
		&& in_array( $error['type'], array( E_CORE_ERROR, E_COMPILE_ERROR, E_ERROR, E_PARSE, E_USER_ERROR, E_RECOVERABLE_ERROR ), true )
	) {
		$error = str_replace( ABSPATH, '', $error );
		echo wp_json_encode( $error );
	} else {
		echo wp_json_encode( true );
	}

	echo "n###### wp_scraping_result_end:$scrape_key ######n";
}

Changelog

Version Description
4.9.0 Introduced.