[wordpress插件] Bang System Logging爆炸系统记录

Enable system logging for WordPress plugin and theme development.

为WordPress插件和主题开发启用系统日志记录。

This can make it easier to know what your code is doing.

这样可以更轻松地知道您的代码在做什么。

Features include:

功能包括：

• Log to the system log or to a file
• 登录到系统日志或文件

• Easily append or embed any value in log messages
• 轻松在日志消息中附加或嵌入任何值

• Coloured logs indicating strings, numbers, arrays, objects, null values etc.
• 表示字符串，数字，数组，对象，空值等的彩色日志。

• Extract values from arrays of objects
• 从对象数组中提取值

• Optionally exclude AJAX, Javascripts, CSS and any other pattern of URLs.
• （可选）排除AJAX，JavaScript，CSS和其他任何形式的URL。

• Intercept PHP errors and log strict warnings
• 拦截PHP错误并记录严格警告

• Measure memory usage between two points, or the time taken by various parts of your code
• 测量两点之间的内存使用情况，或代码各部分所花费的时间

• Easy to switch off for production sites
• 易于关闭生产站点

How to use

使用方法

Using it is as simple as calling the 'log' action in your templates or plugin.

使用它就像在模板或插件中调用'log'操作一样简单。

  <？php do_action（'log'，'Some log message'）; 
?>
？>
 
This will produce a line in your system log:
这将在系统日志中产生一行：
Jun  4 11:23:08 myserver php/mysite.com[1553]: b8e mysite.com/path-to-page: Some log message
  6月4日11:23:08 myserver php / mysite.com [1553]：b8e mysite.com/路径到页面：一些日志消息
 
This includes:
这包括：
Jun  4 11:23:08 – The date and time of the log message
  6月4日11:23:08  –日志消息的日期和时间
myserver – The name of this computer
  myserver  –此计算机的名称
php – The program that produced the message
  php  –产生消息的程序
mysite.com – The domain name of the site
  mysite.com  –网站的域名
1553 – The process ID of the running PHP process
  1553  –正在运行的PHP进程的进程ID 
b8e – A random 3-digit code identifying each page request
  b8e  –标识每个页面请求的3位随机代码
mysite.com/path-to-page – The URL of the request
  mysite.com/path-to-page  –请求的URL 
Some log message – Your message
 一些日志消息 –您的消息
For more detailed instructions, see the How to use tab.
有关详细说明，请参见使用方法标签。
How to use
使用方法
To log a message, use the 'log' action in your templates or plugins:
要记录消息，请在模板或插件中使用'log'操作：
  <？php do_action（'log'，'Some log message'）; 
?>
？>
 
This will output the log message:
这将输出日志消息：
Some log message
 一些日志消息
 
Embedding values
嵌入值
If you include extra parameters, they’ll be added at the end of the log message:
如果您包含其他参数，则将它们添加到日志消息的末尾：
  <？php do_action（'log'，'A number and a string'，17，'foo'）; 
?>
？>
 
This will produce the log message:
这将产生日志消息：
A number and a string: 17, foo
 数字和字符串：17，foo
 
The value will be formatted correctly depending on its type: integers, strings, arrays, objects, booleans etc.
该值将根据其类型正确格式化：整数，字符串，数组，对象，布尔值等。
You don’t need to check if values are null or empty, they’ll still be output safely.
您无需检查值是否为null或为空，它们仍将安全输出。
If you put the code %s into your log message, then one of the arguments will be dropped into the message:
如果将代码％s 放入日志消息中，则其中一个参数将被放入消息中：
  <？php do_action（'log'，'我有％s个数字'，count（$ numbers），$ numbers）; 
?>
？>
 
This will produce the log message:
这将产生日志消息：
I have 4 numbers: [9, 16, 307, 1]
 我有4个数字：[9、16、307、1]
 
Selecting fields
选择字段
Logging a complete object – such as a WordPress post – can be very large, and sometimes it’s only one or two fields you need.
记录一个完整的对象（例如WordPress帖子）可能非常大，有时只需要一两个字段。
If you put a string starting with an exclamation point "!" followed by a list of field names, they will be selected from the following object.
如果您输入的字符串以感叹号“！” 开头，后跟字段名称列表，则将从以下对象中选择它们。
The following will only show the ID and post_title fields of the post:
以下内容仅显示帖子的 ID 和 post_title 字段：
  <？php do_action（'log'，'Loaded the post'，'！ID，post_title'，$ post）; 
?>
？>
 
This will produce the log message:
这将产生日志消息：
Loaded the post: {ID: 1932, post_title: Test page}
 已加载该帖子：{ID：1932，post_title：测试页}
 
If you do this with an array of objects, those fields will be selected from each of them.
如果使用对象数组执行此操作，将从每个字段中选择这些字段。
The following will output a list of post IDs:
以下将输出帖子 ID 的列表：
  <？php do_action（'log'，'Loaded％s posts'，count（$ posts），'！ID'，$ posts）; 
?>
？>
 
This will produce the log message:
这将产生日志消息：
Loaded 3 posts: [1932, 1594, 1103]
 已加载3个帖子：[1932、1594、1103]
 
Coloured logs
彩色日志
If you have coloured logging switched on, values will appear in different colours to indicate their type.
如果已打开彩色日志记录，则值将以不同的颜色显示以指示其类型。
This can make for quicker scanning of log files.
这样可以更快地扫描日志文件。
To enable coloured logs, tick the Coloured logs checkbox on the settings page.
要启用彩色日志，请在设置页面上选中彩色日志复选框。
Then use the log.sh script, included with this plugin, to decode and display the coloured log files.
然后，使用此插件随附的 log.sh 脚本解码并显示彩色的日志文件。