云策 WordPress 开发者社区

函数文档

logIO()

查看官方原文 ↗
💡 云策文档标注

概述

logIO() 是一个已弃用的 WordPress 函数，用于将日志信息写入文件。它已被 error_log() 替代，主要用于 XML-RPC 日志记录。

关键要点

  • logIO() 函数在 WordPress 3.4.0 版本中被弃用，建议使用 error_log() 替代。
  • 该函数接受两个必需参数：$io（输入或输出标识）和 $msg（日志原因描述）。
  • 仅在全局变量 $GLOBALS['xmlrpc_logging'] 非空时，才会通过 error_log() 输出日志。
  • 函数内部调用 _deprecated_function() 来标记弃用状态。

代码示例

function logIO( $io, $msg ) {
    _deprecated_function( __FUNCTION__, '3.4.0', 'error_log()' );
    if ( ! empty( $GLOBALS['xmlrpc_logging'] ) ) {
        error_log( $io . ' - ' . $msg );
    }
}

注意事项

  • 自 WordPress 3.4.0 起，logIO() 已弃用，开发者应迁移到 error_log() 以避免兼容性问题。
  • 该函数主要用于 XML-RPC 相关日志记录，非 XML-RPC 场景可能无需使用。
📄 原文内容

logIO() – Writes logging info to a file.

Description

See also

Parameters

$iostringrequired
Whether input or output.
$msgstringrequired
Information describing logging reason.

Source

function logIO( $io, $msg ) {
	_deprecated_function( __FUNCTION__, '3.4.0', 'error_log()' );
	if ( ! empty( $GLOBALS['xmlrpc_logging'] ) ) {
		error_log( $io . ' - ' . $msg );
	}
}

View all references View on Trac View on GitHub

Uses Description
_deprecated_function()wp-includes/functions.php

Marks a function as deprecated and inform when it has been used.

Changelog

Version Description
3.4.0 Deprecated. Use error_log()
1.2.0 Introduced.