# custom-404-pro/trunk/tests/bootstrap.php

Custom 404 Pro, version trunk. 311 lines.

- Page: https://pluginprobe.com/plugins/custom-404-pro/trunk/code/tests/bootstrap.php
- Raw: https://pluginprobe.com/plugins/custom-404-pro/trunk/raw/tests/bootstrap.php
- Modified: 2026-08-30T02:41:10+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/custom-404-pro/trunk/code/tests/bootstrap.php#L10-L20`.

```php
<?php
/**
 * Test bootstrap: stubs $wpdb so class constructors can reference it without WordPress loaded.
 *
 * @package Custom_404_Pro
 */

global $wpdb;
$wpdb         = new stdClass(); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- intentional stub for unit tests
$wpdb->prefix = 'wp_';

// Simple filter/action registries used by stubs below.
$GLOBALS['_test_filters']                 = array();
$GLOBALS['_test_actions']                 = array();
$GLOBALS['_load_plugin_textdomain_calls'] = array();
$GLOBALS['_test_options']                 = array();
$GLOBALS['_test_transients']              = array();
$GLOBALS['_test_is_404']                  = false;
$GLOBALS['_test_permalinks']              = array();
$GLOBALS['_test_redirect_url']            = null;
$GLOBALS['_test_redirect_status']         = null;

// WordPress time constants.
if ( ! defined( 'MINUTE_IN_SECONDS' ) ) {
	define( 'MINUTE_IN_SECONDS', 60 );
}
if ( ! defined( 'HOUR_IN_SECONDS' ) ) {
	define( 'HOUR_IN_SECONDS', 3600 );
}
if ( ! defined( 'DAY_IN_SECONDS' ) ) {
	define( 'DAY_IN_SECONDS', 86400 );
}

// Mirror the plugin version constant, read from the plugin file rather than
// hardcoded, so version-dependent behaviour (asset cache busting, the db-version
// upgrade gate) is testable without loading WordPress.
if ( ! defined( 'CUSTOM_404_PRO_VERSION' ) ) {
	$_c404p_main = file_get_contents( dirname( __DIR__ ) . '/custom-404-pro.php' );
	preg_match( "/define\(\s*'CUSTOM_404_PRO_VERSION',\s*'([^']+)'\s*\)/", $_c404p_main, $_c404p_match );
	define( 'CUSTOM_404_PRO_VERSION', $_c404p_match[1] ?? '0.0.0' );
	unset( $_c404p_main, $_c404p_match );
}

/**
 * Stub for WordPress apply_filters().
 *
 * Runs any callbacks registered via add_filter() for $tag.
 *
 * @param string $tag   The filter hook name.
 * @param mixed  $value The value to filter.
 * @param mixed  ...$args Additional arguments passed to callbacks.
 * @return mixed The filtered value.
 */
function apply_filters( string $tag, $value, ...$args ) { // phpcs:ignore Universal.NamingConventions.NoReservedKeywordParameterNames.matchFound
	if ( isset( $GLOBALS['_test_filters'][ $tag ] ) ) {
		foreach ( $GLOBALS['_test_filters'][ $tag ] as $callback ) {
			$value = $callback( $value, ...$args );
		}
	}
	return $value;
}

/**
 * Stub for WordPress add_filter().
 *
 * @param string   $tag      The filter hook name.
 * @param callable $callback The callback to register.
 */
function add_filter( string $tag, callable $callback ) {
	$GLOBALS['_test_filters'][ $tag ][] = $callback;
}

/**
 * Stub for WordPress has_filter().
 *
 * Returns true when at least one callback is registered for $tag via add_filter().
 *
 * @param string $tag The filter hook name.
 * @return bool
 */
function has_filter( string $tag ): bool {
	return ! empty( $GLOBALS['_test_filters'][ $tag ] );
}

/**
 * Stub for Polylang pll_get_post().
 *
 * Returns the value of $GLOBALS['_pll_get_post_return']; defaults to false.
 *
 * @param int    $post_id The post ID to translate.
 * @param string $lang    The target language slug.
 * @return int|false
 */
function pll_get_post( int $post_id, string $lang ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
	return $GLOBALS['_pll_get_post_return'] ?? false;
}

/**
 * Stub for Polylang pll_current_language().
 *
 * Returns the value of $GLOBALS['_pll_current_language']; defaults to 'en'.
 *
 * @return string
 */
function pll_current_language(): string {
	return $GLOBALS['_pll_current_language'] ?? 'en';
}

/**
 * Stub for Polylang pll_default_language().
 *
 * Returns the value of $GLOBALS['_pll_default_language']; defaults to 'en'.
 *
 * @return string
 */
function pll_default_language(): string {
	return $GLOBALS['_pll_default_language'] ?? 'en';
}

/**
 * Stub for WordPress add_action().
 *
 * @param string   $tag      The action hook name.
 * @param callable $callback The callback to register.
 * @param mixed    ...$args  Additional arguments (priority, accepted_args) — ignored by stub.
 */
function add_action( string $tag, $callback, ...$args ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
	$GLOBALS['_test_actions'][ $tag ][] = array( $callback );
}

/**
 * Stub for WordPress plugin_dir_path().
 *
 * @param string $file Absolute path to the reference file.
 * @return string Trailing-slashed directory path.
 */
function plugin_dir_path( string $file ): string {
	return rtrim( dirname( $file ), DIRECTORY_SEPARATOR ) . DIRECTORY_SEPARATOR;
}

/**
 * Stub for WordPress plugin_basename().
 *
 * Returns a path relative to the plugin root (two levels up from $file).
 *
 * @param string $file Absolute path.
 * @return string Relative plugin basename.
 */
function plugin_basename( string $file ): string {
	$plugins_dir = dirname( dirname( $file ) );
	return ltrim( str_replace( $plugins_dir, '', $file ), DIRECTORY_SEPARATOR );
}

/**
 * Stub for WordPress load_plugin_textdomain().
 *
 * Records the call so tests can assert on the arguments passed.
 *
 * @param string       $domain      Text domain.
 * @param string|false $deprecated  Deprecated — always false.
 * @param string|false $plugin_rel_path Relative path to the languages directory.
 */
function load_plugin_textdomain( string $domain, $deprecated = false, $plugin_rel_path = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
	$GLOBALS['_load_plugin_textdomain_calls'][] = array(
		'domain'          => $domain,
		'plugin_rel_path' => $plugin_rel_path,
	);
}

/**
 * Stub for WordPress get_option().
 *
 * Returns the value stored in the test options registry, or $default if not set.
 *
 * @param string $option  Option name.
 * @param mixed  $default Default value.
 * @return mixed
 */
function get_option( string $option, $default = false ) {
	return array_key_exists( $option, $GLOBALS['_test_options'] )
		? $GLOBALS['_test_options'][ $option ]
		: $default;
}

/**
 * Stub for WordPress update_option().
 *
 * Stores a value in the test options registry.
 *
 * @param string $option Option name.
 * @param mixed  $value  Value to store.
 * @return bool Always true.
 */
function update_option( string $option, $value ) {
	$GLOBALS['_test_options'][ $option ] = $value;
	return true;
}

/**
 * Stub for WordPress add_option().
 *
 * Stores a value only when the option is not already set (mirrors WordPress behaviour).
 *
 * @param string $option Option name.
 * @param mixed  $value  Value to store.
 * @return bool True if the option was added, false if it already existed.
 */
function add_option( string $option, $value ) {
	if ( array_key_exists( $option, $GLOBALS['_test_options'] ) ) {
		return false;
	}
	$GLOBALS['_test_options'][ $option ] = $value;
	return true;
}

/**
 * Stub for WordPress delete_option().
 *
 * Removes a value from the test options registry.
 *
 * @param string $option Option name.
 * @return bool Always true.
 */
function delete_option( string $option ): bool {
	unset( $GLOBALS['_test_options'][ $option ] );
	return true;
}

/**
 * Stub for WordPress get_transient().
 *
 * Returns the value stored in the test transient registry, or false if not set.
 *
 * @param string $transient Transient name.
 * @return mixed Stored value, or false if not set.
 */
function get_transient( string $transient ) {
	return $GLOBALS['_test_transients'][ $transient ] ?? false;
}

/**
 * Stub for WordPress set_transient().
 *
 * Stores a value in the test transient registry.
 *
 * @param string $transient  Transient name.
 * @param mixed  $value      Value to store.
 * @param int    $expiration Ignored in unit tests.
 * @return bool Always true.
 */
function set_transient( string $transient, $value, int $expiration = 0 ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
	$GLOBALS['_test_transients'][ $transient ] = $value;
	return true;
}

/**
 * Stub for WordPress delete_transient().
 *
 * Removes a value from the test transient registry.
 *
 * @param string $transient Transient name.
 * @return bool Always true.
 */
function delete_transient( string $transient ): bool {
	unset( $GLOBALS['_test_transients'][ $transient ] );
	return true;
}

/**
 * Stub for WordPress is_404().
 *
 * Returns the value of $GLOBALS['_test_is_404']; defaults to false.
 *
 * @return bool
 */
function is_404(): bool {
	return $GLOBALS['_test_is_404'] ?? false;
}

/**
 * Stub for WordPress get_permalink().
 *
 * Returns the value from $GLOBALS['_test_permalinks'][$post_id], or false if not set.
 *
 * @param int $post_id Post ID.
 * @return string|false
 */
function get_permalink( $post_id = 0 ) {
	return $GLOBALS['_test_permalinks'][ $post_id ] ?? false;
}

/**
 * Stub for WordPress wp_safe_redirect().
 *
 * Captures the redirect URL and status in globals and returns false so that
 * the gated exit( ) in custom_404_pro_redirect() does not terminate the process.
 *
 * @param string $location Redirect URL.
 * @param int    $status   HTTP status code.
 * @return bool Always false.
 */
function wp_safe_redirect( string $location, int $status = 302 ): bool {
	$GLOBALS['_test_redirect_url']    = $location;
	$GLOBALS['_test_redirect_status'] = $status;
	return false;
}

require_once dirname( __DIR__ ) . '/admin/class-helpers.php';
require_once dirname( __DIR__ ) . '/admin/class-adminclass.php';
require_once dirname( __DIR__ ) . '/includes/class-pluginclass.php';

```