Title: Debug Logger
Author: Andrew Woods
Published: <strong>2021 年 4 月 30 日</strong>
Last modified: 2021 年 5 月 3 日

---

搜尋外掛

這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個
外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。

![](https://s.w.org/plugins/geopattern-icon/debug-logger.svg)

# Debug Logger

 由 [Andrew Woods](https://profiles.wordpress.org/awoods/) 開發

[下載](https://downloads.wordpress.org/plugin/debug-logger.0.3.0.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/debug-logger/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/debug-logger/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/debug-logger/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/debug-logger/#developers)

 [技術支援](https://wordpress.org/support/plugin/debug-logger/)

## 外掛說明

As PHP moves forward, so must WordPress. This plugin helps WordPress use the tools
of modern PHP. Monolog — PHP’s most popular logging package — is a composer package.
Since WordPress doesn’t currently have a universal way to support composer, this
WordPress plugin is meant to start bridging the gap. This logger is [PSR-3](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-3-logger-interface.md)
compliant, a PHP standard which Monolog also uses.

### Logging Levels

There are 8 logging levels available, [defined by RFC 5424](https://tools.ietf.org/html/rfc5424).
The levels specified in
 order from the most severe to the least severe:

 * **Emergency**: system is unusable
 * **Alert**: action must be taken immediately
 * **Critical**: critical conditions
 * **Error**: error conditions
 * **Warning**: warning conditions
 * **Notice**: normal but significant condition
 * **Info**: informational messages
 * **Debug**: debug-level messages

## 安裝方式

This section describes how to install the plugin and get it working.

 1. Upload the `wp-debug-logger` folder to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Enable debugging in your `wp-config.php`
 4. // in your wp-config.php
     define( ‘WP_DEBUG’, true ); define( ‘WP_DEBUG_DISPLAY’,
    false ); define( ‘WP_DEBUG_LOG’, true ); define( ‘WP_DEBUG_MINIMUM_LEVEL’, ‘debug’);
 5. // For good measure, this will hide errors from being displayed on-screen
     @ini_set(‘
    display_errors’, 0);
 6. As you write your code, sprinkle in these Log methods.

#### Minimum Level

WP_DEBUG_MINIMUM_LEVEL is a new constant that determines the minimum severity level
you wish to write to your _wp-content/debug.log_ file. In your _development_ environment,
I recommend using `debug` so you can see all the errors being written. For your 
_production_ environment, I’d recommend the `error` level, so you can capture all
the significant problems. Here are the values to use: **emergency, alert, critical,
error, warning, notice, info, debug**. Note: they’re all lowercase, as the value
is case-sensitive.

#### Displaying Errors

In your **development** environment, you may choose to set `WP_DEBUG_DISPLAY` to`
true`, so the error messages show in your browser. However, I **strongly recommend**
that you do not change it, for your _production_ environment. These settings can
be placed anywhere above the line.

    ```
    /* That’s all, stop editing! Happy blogging. */
    ```

## 常見問題集

### Why not just use the error_log function?

You still can. However, the plugin will add value to your logging efforts. Using
this logger will add structure io the debug.log file, _and_ give you a modern PHP
interface to control the amount of logging in your website. The logging methods 
in this plugin also provide information about the severity of the error.

### Where can I find more documentation?

This project is [developed on Github](https://github.com/andrewwoods/wp-debug-logger).
There is a more complete readme there, with links to supplemental information.

### Why use PSR-3?

A PSR is a PHP Standard Recommendation. PSRs are use to create and maintain interoperability
between PHP-based frameworks and content management systems.

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈Debug Logger〉的開發相關工作。

參與者

 *   [ Andrew Woods ](https://profiles.wordpress.org/awoods/)

[將〈Debug Logger〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/debug-logger)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/debug-logger/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/debug-logger/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/debug-logger/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/debug-logger/)。

## 變更記錄

#### 0.3.0

 * Add the ability to log WP_Error objects
    - Add `Log::wp_error()` and its corresponding `Logger->log_wp_error` method
    - Add method Logger->has_level() to ensure a level exists

#### 0.2.0

 * Add `Log::print()` and `Log::dump()` methods
 * Improve documentation

#### 0.1.0

 * Import PSR-3 from PHP FIG into `lib` directory
 * Create Logger class to write log
 * Create Log class to statically interact with Logger class
 * Add usage instructions and logging levels

## 中繼資料

 *  版本 **0.3.0**
 *  最後更新 **5 年前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 5.7 或更新版本 **
 *  已測試相容的 WordPress 版本 **5.7.15**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/debug-logger/)
 * 標籤:
 * [debug](https://tw.wordpress.org/plugins/tags/debug/)[logging](https://tw.wordpress.org/plugins/tags/logging/)
   [logs](https://tw.wordpress.org/plugins/tags/logs/)
 *  [進階檢視](https://tw.wordpress.org/plugins/debug-logger/advanced/)

## 評分

這個項目尚無任何評論記錄。

[Your review](https://wordpress.org/support/plugin/debug-logger/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/debug-logger/reviews/)

## 參與者

 *   [ Andrew Woods ](https://profiles.wordpress.org/awoods/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/debug-logger/)