Release 1.3.9

feat(debug): Added wp-redirect-log.php mu-plugin

Author: jordantrizz

CHANGELOG.md

@@ -1,4 +1,8 @@
 # Changelog
+## Release 1.3.9
+* feat(debug): Added wp-redirect-log.php mu-plugin
+
+
 ## Relase 1.3.8
 * feat(debug): Added php-memory.php
 

README-snippets.md

@@ -49,6 +49,7 @@
 | [PHP Memory Info](./debug/php-memory.php) | mu-plugin | :white_check_mark: | Adds a Tools -> PHP Memory page to display PHP ini and WordPress memory settings and current usage. |
 | [show-browser-cookies.php](./debug/show-browser-cookies.php) | snippet | :white_check_mark: |  * Description Shows your browsers cookies |
 | [Application Logs](./debug/show-logs-admin.php) | Plugin | :white_check_mark: | Displays top 10 lines from a log file in the WordPress admin section. |
+| [WP Redirect Log](./debug/wp-redirect-log.php) | mu-plugin | :white_check_mark: | Logs all wp_redirect and wp_safe_redirect calls to a log file in the uploads directory. |
 
 ## [development](development)
 

README.md

@@ -63,6 +63,7 @@ The status field is used to indicate the current status of the snippet. This is
 | [PHP Memory Info](./debug/php-memory.php) | mu-plugin | :white_check_mark: | Adds a Tools -> PHP Memory page to display PHP ini and WordPress memory settings and current usage. |
 | [show-browser-cookies.php](./debug/show-browser-cookies.php) | snippet | :white_check_mark: |  * Description Shows your browsers cookies |
 | [Application Logs](./debug/show-logs-admin.php) | Plugin | :white_check_mark: | Displays top 10 lines from a log file in the WordPress admin section. |
+| [WP Redirect Log](./debug/wp-redirect-log.php) | mu-plugin | :white_check_mark: | Logs all wp_redirect and wp_safe_redirect calls to a log file in the uploads directory. |
 
 ## [development](development)
 
@@ -137,6 +138,10 @@ The status field is used to indicate the current status of the snippet. This is
 | [Failover Status Monitor](./wp-failover/wp-failover.php) | Plugin | :white_check_mark: | Monitors failover status and provides notifications. |
 
 # Changelog
+## Release 1.3.9
+* feat(debug): Added wp-redirect-log.php mu-plugin
+
+
 ## Relase 1.3.8
 * feat(debug): Added php-memory.php
 

VERSION

@@ -1 +1 @@
-1.3.8
+1.3.9

debug/wp-redirect-log.php

@@ -0,0 +1,96 @@
+<?php
+/**
+ * Plugin Name: WP Redirect Log
+ * Description: Logs all wp_redirect and wp_safe_redirect calls to a log file in the uploads directory.
+ * Version: 1.0
+ * Author: ManagingWP
+ * Author URI: https://github.com/managingwp/wordpress-code-snippets
+ * Type: mu-plugin
+ * Status: Complete
+*/
+
+if ( ! defined( 'ABSPATH' ) ) {
+    exit;
+}
+
+// Hook into WP redirects
+add_filter( 'wp_redirect',      'wprl_log_redirect', 10, 2 );
+add_filter( 'wp_safe_redirect', 'wprl_log_redirect', 10, 2 );
+
+// Also catch raw Location headers
+add_filter( 'wp_headers', 'wprl_log_raw_header' );
+
+/**
+ * Get full path to our log file in uploads/
+ *
+ * @return string
+ */
+function wprl_get_log_file() {
+    $uploads = wp_upload_dir();
+    $basedir = trailingslashit( $uploads['basedir'] );
+    $file    = $basedir . 'wp-redirects.log';
+
+    if ( ! file_exists( $file ) ) {
+        @touch( $file );
+        @chmod( $file, 0664 );
+    }
+
+    return $file;
+}
+
+/**
+ * Append a line to our log file
+ *
+ * @param string $line
+ * @return void
+ */
+function wprl_write_log( $line ) {
+    $file = wprl_get_log_file();
+    file_put_contents( $file, $line . PHP_EOL, FILE_APPEND | LOCK_EX );
+}
+
+/**
+ * Log wp_redirect / wp_safe_redirect usage
+ *
+ * @param string $location
+ * @param int    $status
+ * @return string
+ */
+function wprl_log_redirect( $location, $status ) {
+    // short backtrace to find caller
+    $trace      = debug_backtrace( DEBUG_BACKTRACE_IGNORE_ARGS, 5 );
+    $caller     = isset( $trace[2] ) ? $trace[2] : $trace[1];
+    $caller_info = '';
+    if ( ! empty( $caller['file'] ) ) {
+        $caller_info = wp_basename( $caller['file'] ) . ':' . ( $caller['line'] ?? 0 );
+    }
+
+    $msg = sprintf(
+        "[WP-REDIRECT] %s → %s (status %d) called by %s",
+        $_SERVER['REQUEST_URI'] ?? 'unknown',
+        $location,
+        $status,
+        $caller_info
+    );
+    wprl_write_log( $msg );
+
+    return $location;
+}
+
+/**
+ * Log any raw Location headers before send
+ *
+ * @param array $headers
+ * @return array
+ */
+function wprl_log_raw_header( $headers ) {
+    if ( ! empty( $headers['Location'] ) ) {
+        $msg = sprintf(
+            "[WP-HEADER] sending Location: %s (on %s)",
+            $headers['Location'],
+            $_SERVER['REQUEST_URI'] ?? 'unknown'
+        );
+        wprl_write_log( $msg );
+    }
+    return $headers;
+}