wp-cli/handbook
0
0
Fork 0
mirror of https://gh.wpcy.net/https://github.com/wp-cli/handbook.git synced 2026-04-28 05:59:29 +08:00
Code Issues Projects Packages Activity Actions
handbook/guides/doctor/doctor-default-checks.md
Pascal Birchler 264cb131bf
Fix handbook information architecture 
- Organize files in folders according to the desired structure
- Use directory iterator to loop through all files and folders (makes generation more robust)
2025-06-25 15:38:39 +02:00

2.5 KiB
Raw Permalink Blame History

Default doctor diagnostic checks

Although it's power comes from its ability to be customized, wp doctor includes a number of default diagnostic checks considered to be recommendations for production websites.

Use wp doctor list to view these default checks:

name description
autoload-options-size Warns when autoloaded options size exceeds threshold of 900 kb.
constant-savequeries-falsy Confirms expected state of the SAVEQUERIES constant.
constant-wp-debug-falsy Confirms expected state of the WP_DEBUG constant.
core-update Errors when new WordPress minor release is available; warns for major release.
core-verify-checksums Verifies WordPress files against published checksums; errors on failure.
cron-count Errors when there's an excess of 50 total cron jobs registered.
cron-duplicates Errors when there's an excess of 10 duplicate cron jobs registered.
file-eval Checks files on the filesystem for regex pattern `eval\(.*base64_decode\(.*`.
option-blog-public Confirms the expected value of the 'blog_public' option.
plugin-active-count Warns when there are greater than 80 plugins activated.
plugin-deactivated Warns when greater than 40% of plugins are deactivated.
plugin-update Warns when there are plugin updates available.
theme-update Warns when there are theme updates available.

To explain these further:

  • Autoloaded options are options that are automatically loaded in every request to WordPress. A size exceeding the recommended threshold could be a symptom of a larger problem.
  • Because SAVEQUERIES causes WordPress to save a backtrace for every SQL query, which is an expensive operation, using SAVEQUERIES in production is discouraged.
  • WordPress minor versions are typically security releases that should be applied immediately.

If you create a custom doctor.yml config file, you can use wp doctor list --config=<file> to view the diagnostic checks listed in the file.