Ticket #42151: 42151.7.diff

src/wp-includes/wp-db.php

@@ -180 +180 @@
          * @since 1.5.0
          * @since 2.5.0 The third element in each query log was added to record the calling functions.
          * @since 5.1.0 The fourth element in each query log was added to record the start time.
+         * @since 5.3.0 The fifth element in each query log was added to record custom data.
          *
          * @var array[] {
          *     Array of queries that were executed.
@@ -191 +192 @@
          *         @type float  $1 Total time spent on the query, in seconds.
          *         @type string $2 Comma separated list of the calling functions.
          *         @type float  $3 Unix timestamp of the time at the start of the query.
+         *         @type array  $4 Custom query data.
          *     }
          * }
          */
@@ -2014 +2016 @@
                 $this->num_queries++;
 
                 if ( defined( 'SAVEQUERIES' ) && SAVEQUERIES ) {
-                        $this->queries[] = array(
-                                $query,
-                                $this->timer_stop(),
-                                $this->get_caller(),
-                                $this->time_start,
+                        $this->log_query(
+                                array(
+                                        $query,
+                                        $this->timer_stop(),
+                                        $this->get_caller(),
+                                        array(),
+                                )
                         );
                 }
         }
 
+        /**
+         * Logs query data.
+         *
+         * @since 5.3.0
+         *
+         * @param array $query_data {
+         *     Data for the query.
+         *
+         *     @type string $0 The query's SQL.
+         *     @type float  $1 Total time spent on the query, in seconds.
+         *     @type string $2 Comma separated list of the calling functions.
+         *     @type float  $3 Unix timestamp of the time at the start of the query.
+         *     @type array  $4 Custom query data.
+         * }
+         */
+        public function log_query( $query_data ) {
+                /**
+                 * Filters the query data being logged.
+                 *
+                 * Caution should be used when modifying any of this data, it is recommended that any additional
+                 * information you need to store about a query be added as a new associative entry to the fourth
+                 * element $query_data.
+                 *
+                 * @since 5.3.0
+                 *
+                 * @param array $query_data {
+                 *     Data for the query.
+                 *
+                 *     @type string $0 The query's SQL.
+                 *     @type float  $1 Total time spent on the query, in seconds.
+                 *     @type string $2 Comma separated list of the calling functions.
+                 *     @type float  $3 Unix timestamp of the time at the start of the query.
+                 *     @type array  $4 Custom query data.
+                 * }
+                 */
+                $this->queries[] = apply_filters( 'log_query_data', $query_data );
+        }
+
         /**
          * Generates and returns a placeholder escape string for use in queries returned by ::prepare().
          *