WP-Debugger

The ultimate WordPress Rescue & Troubleshooting tool.

WP debugger & Rescue Tool

A powerful, single-file PHP emergency kit (wp-debugger.php) designed for developers and sysadmins to recover WordPress installations suffering from critical errors or to perform rapid maintenance tasks.

⚠️ IMPORTANT: Security Warning

This script provides deep access to the WordPress database and file system.

  • Immediately change the password in the TOOL_PASSWORD constant at the top of the script.
  • Delete this script from the server as soon as your troubleshooting is complete.
  • Use at your own risk. Always perform a backup before using bulk actions.

✨ Key Features

  • One-Click Subdirectory to Root Move: Move a complete website from a subfolder to the root directory. The script automatically handles file relocation and updates the siteurl and home options in the database.
  • DB Recovery: Update wp-config.php credentials and fix connection strings.
  • Access Management: Instantly create a new admin user or reset existing passwords.
  • Plugin & Theme Manager: Toggle problematic plugins or themes without dashboard access.
  • Core Reinstall: Replace corrupted WordPress core files with a single click.
  • System Tools: Clear LSCache/Object Cache, restore default .htaccess, and fix file permissions (755 for dirs, 600 for wp-config).
  • Security Scan: Detect unauthorized PHP files in the uploads folder (potential malware).
  • Search & Replace: Migrate database URLs with 'Dry Run' support.

🚀 Installation & Usage

  1. Download the file as wp-debugger.php.
  2. Upload it to the directory of your WordPress installation.
  3. Navigate to yourdomain.com/wp-debugger.php in your browser.
  4. Log in using the password you defined in the script.

🛠 Configuration

Open the script and modify the following lines:


define('TOOL_PASSWORD', 'your-secure-password'); // Change this immediately!
define('DEFAULT_USER', 'support');           // Default admin username to be created

Changelog

Changelog

[1.0.0] - 05-02-2026

  • New Subdirectory to Root Migrator: Added a one-click tool to move the entire WordPress installation from a subfolder to the root directory, including automatic database URL updates for siteurl and home.
  • New Core Reinstaller: Added the ability to download and overwrite WordPress core files with a fresh copy while preserving the wp-content folder and configuration.
  • New C86 Rescue Admin: Added a quick-action button to create a new administrator account (C86-support) or reset existing user passwords to regain dashboard access.
  • New Security Malware Scanner: Integrated a scanner that checks the uploads directory for unauthorized PHP files often used in web shells or malware.
  • New Multi-Site Discovery: The script now scans the server for other WordPress installations, allowing you to switch the "Target Path" and manage multiple sites from one interface.
  • New Database Search & Replace: Added a powerful search and replace engine with "Dry Run" support, specifically designed to handle site migrations and SSL updates.
  • Improvement WP_DEBUG Integration: Added a toggle to enable/disable WordPress debugging and a live viewer for the debug.log file directly in the tool.
  • Improvement Performance & Cache: Added dedicated tools to flush LSCache, delete Object Cache files, and clear database transients.
  • Improvement Server Environment: Added a function to automatically generate or update .user.ini files to increase PHP memory limits and execution times.
  • Improvement UI/UX: Developed a balanced, dark-mode dashboard using Tailwind CSS for better responsiveness and clarity during emergency situations.
Copied to clipboard!