Error_Handler

Class for error handling

Description

This class handles errors triggered by incorrect plugin usage.

Source

File: src/error-handler.php

class Error_Handler extends Error_Handler_Base {

	/**
	 * Marks something as being incorrectly called.
	 *
	 * @since 1.0.0
	 * @access public
	 *
	 * @param string $function The function that was called.
	 * @param string $message  A message explaining what has been done incorrectly.
	 * @param string $version  The version of the plugin where the message was added.
	 */
	public function doing_it_wrong( $function, $message, $version ) {
		do_action( 'doing_it_wrong_run', $function, $message, $version );

		if ( WP_DEBUG && apply_filters( 'doing_it_wrong_trigger_error', true ) ) {
			if ( is_null( $version ) ) {
				$version = '';
			} else {
				$version = ' ' . sprintf( $this->get_translation( 'added_in_version' ), $version );
			}

			$message = sprintf( $this->get_translation( 'called_incorrectly' ), $function, $message . $version );

			torro()->logger()->debug( $message );
		}
	}

	/**
	 * Marks a function as deprecated and inform when it has been used.
	 *
	 * @since 1.0.0
	 * @access public
	 *
	 * @param string $function    The function that was called.
	 * @param string $version     The version of the plugin that deprecated the function.
	 * @param string $replacement Optional. The function that should have been called. Default null.
	 */
	public function deprecated_function( $function, $version, $replacement = null ) {
		do_action( 'deprecated_function_run', $function, $replacement, $version );

		if ( WP_DEBUG && apply_filters( 'deprecated_function_trigger_error', true ) ) {
			if ( ! is_null( $replacement ) ) {
				$message = sprintf( $this->get_translation( 'deprecated_function' ), $function, $version, $replacement );
			} else {
				$message = sprintf( $this->get_translation( 'deprecated_function_no_alt' ), $function, $version );
			}

			torro()->logger()->debug( $message, array( 'deprecated' => true ) );
		}
	}

	/**
	 * Marks a function argument as deprecated and inform when it has been used.
	 *
	 * @since 1.0.0
	 * @access public
	 *
	 * @param string $function The function that was called.
	 * @param string $version  The version of the plugin that deprecated the argument used.
	 * @param string $message  Optional. A message regarding the change. Default null.
	 */
	public function deprecated_argument( $function, $version, $message = null ) {
		do_action( 'deprecated_argument_run', $function, $message, $version );

		if ( WP_DEBUG && apply_filters( 'deprecated_argument_trigger_error', true ) ) {
			if ( ! is_null( $message ) ) {
				$message = sprintf( $this->get_translation( 'deprecated_argument' ), $function, $version, $message );
			} else {
				$message = sprintf( $this->get_translation( 'deprecated_argument_no_alt' ), $function, $version );
			}

			torro()->logger()->debug( $message, array( 'deprecated' => true ) );
		}
	}

	/**
	 * Marks a deprecated action or filter hook as deprecated and throws a notice.
	 *
	 * @since 1.0.0
	 * @access public
	 *
	 * @param string $hook        The hook that was used.
	 * @param string $version     The version of the plugin that deprecated the hook.
	 * @param string $replacement Optional. The hook that should have been used.
	 * @param string $message     Optional. A message regarding the change.
	 */
	public function deprecated_hook( $hook, $version, $replacement = null, $message = null ) {
		do_action( 'deprecated_hook_run', $hook, $replacement, $version, $message );

		if ( WP_DEBUG && apply_filters( 'deprecated_hook_trigger_error', true ) ) {
			$message = empty( $message ) ? '' : ' ' . $message;

			if ( ! is_null( $replacement ) ) {
				$message = sprintf( $this->get_translation( 'deprecated_hook' ), $hook, $version, $replacement ) . $message;
			} else {
				$message = sprintf( $this->get_translation( 'deprecated_hook_no_alt' ), $hook, $version ) . $message;
			}

			torro()->logger()->debug( $message, array( 'deprecated' => true ) );
		}
	}

	/**
	 * Marks a shortcode as deprecated and inform when it has been used.
	 *
	 * @since 1.0.0
	 *
	 * @param string $shortcode   The shortcode that was called.
	 * @param string $version     The version of the plugin that deprecated the shortcode.
	 * @param string $replacement Optional. The shortcode that should have been called. Default null.
	 */
	public function deprecated_shortcode( $shortcode, $version, $replacement = null ) {
		do_action( 'deprecated_shortcode_run', $shortcode, $replacement, $version );

		if ( WP_DEBUG && apply_filters( 'deprecated_shortcode_trigger_error', true ) ) {
			if ( ! is_null( $replacement ) ) {
				$message = sprintf( $this->get_translation( 'deprecated_shortcode' ), $shortcode, $version, $replacement );
			} else {
				$message = sprintf( $this->get_translation( 'deprecated_shortcode_no_alt' ), $shortcode, $version );
			}

			torro()->logger()->debug( $message, array( 'deprecated' => true ) );
		}
	}
}

Changelog

Changelog
Version Description
1.0.0 Introduced.

Methods

  • deprecated_argument — Marks a function argument as deprecated and inform when it has been used.
  • deprecated_function — Marks a function as deprecated and inform when it has been used.
  • deprecated_hook — Marks a deprecated action or filter hook as deprecated and throws a notice.
  • deprecated_shortcode — Marks a shortcode as deprecated and inform when it has been used.
  • doing_it_wrong — Marks something as being incorrectly called.