├── readme.txt
└── static-404.php


/readme.txt:
--------------------------------------------------------------------------------
 1 | === Static 404 ===
 2 | Contributors: bradparbs, surfboards
 3 | Tags: performance, 404, errors
 4 | Requires at least: 5.2
 5 | Tested up to: 6.6
 6 | Stable tag: 1.1.0
 7 | License: GPLv2 or later
 8 | Requires PHP: 5.6
 9 | 
10 | A WordPress plugin to quickly send a 404 for missing static files.
11 | 
12 | == Description ==
13 | 
14 | Quickly output a 404 for static files that aren't found, rather than loading the normal 404 page.
15 | 
16 | Any static files ( images, text, pdfs, etc ) that don't exist will 404 as soon as possible, rather than loading the entire WordPress application.
17 | 
18 | == Availiable filters ==
19 | 
20 | By default, the list of extensions to check are the results of `wp_get_ext_types`, but can be filtered with `static_404_extensions`.
21 | 
22 | The output is a static page with the text `404 Not Found`, this text can be edited by filtering `static_404_message`.
23 | 
24 | A 404 status code will be used, but can be filtered with `static_404_response_code`.
25 | 
26 | Passing true to `static_404_should_process_request` will short-circuit and skip processing the request. This filter gets passed the current request.
27 | 
28 | 
29 | == Installation ==
30 | 
31 |  - Install the plugin.
32 |  - Magically have faster and less expensive 404s!
33 | 
34 | 
35 | == Changelog ==
36 | 
37 | = 1.1.0 =
38 |  * Added more filters
39 | 
40 | = 1.0.3 =
41 |  * Initial release
42 | 


--------------------------------------------------------------------------------
/static-404.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * Plugin Name: Static 404
  4 |  * Description: Quickly output a 404 for static files that aren't found, rather than loading the normal 404 page.
  5 |  * Version:     1.1.0
  6 |  * Author:      Brad Parbs
  7 |  * Author URI:  https://bradparbs.com/
  8 |  * License:     GPLv2
  9 |  * Text Domain: static-404
 10 |  * Domain Path: /lang/
 11 |  *
 12 |  * @package static-404
 13 |  */
 14 | 
 15 | namespace Static404;
 16 | 
 17 | defined( 'ABSPATH' ) || die();
 18 | 
 19 | /**
 20 |  *
 21 |  * If the plugin is installed as an mu-plugin, then we can hook in earlier,
 22 |  * otherwise we need to wait until plugins_loaded.
 23 |  */
 24 | add_action( get_early_action_to_use(), __NAMESPACE__ . '\\process_request' );
 25 | 
 26 | /**
 27 |  * If a request comes in for a static file and the webserver hasn't already
 28 |  * handled it, then we want to 404 as quickly as possible without loading WordPress.
 29 |  */
 30 | function process_request() {
 31 | 	// If we don't have a request, then bail out.
 32 | 	// We'll be parsing this request to determine
 33 | 	// if a static file is being requested.
 34 | 	if ( ! isset( $_SERVER['REQUEST_URI'] ) ) {
 35 | 		return;
 36 | 	}
 37 | 
 38 | 	// Allow short-circuiting the logic.
 39 | 	if ( should_process_request() ) {
 40 | 		return;
 41 | 	}
 42 | 
 43 | 	// Bail out if we don't have an extension or if the extension isn't in the list.
 44 | 	$req_ext = get_request_extension();
 45 | 	if ( ! $req_ext || ! in_array( $req_ext, get_extensions(), true ) ) {
 46 | 		return;
 47 | 	}
 48 | 
 49 | 	// Set a 404.
 50 | 	http_response_code( apply_filters( 'static_404_response_code', 404 ) );
 51 | 
 52 | 	// Kill the request.
 53 | 	// phpcs:ignore
 54 | 	wp_die( get_message() );
 55 | }
 56 | 
 57 | /**
 58 |  * Determine the earliest `loaded` action we can use. If we're in an mu-plugin,
 59 |  * then fire it on mu-plugins_loaded, otherwise we need to wait until plugins_loaded.
 60 |  *
 61 |  * @return string Action to use.
 62 |  */
 63 | function get_early_action_to_use() {
 64 | 	if ( ! did_action( 'muplugins_loaded' ) ) {
 65 | 		return 'muplugins_loaded';
 66 | 	}
 67 | 
 68 | 	return 'plugins_loaded';
 69 | }
 70 | 
 71 | /**
 72 |  * Get the extension of the request.
 73 |  *
 74 |  * @return string The extension of the request.
 75 |  */
 76 | function get_request_extension() {
 77 | 	// Grab the file extension from our request.
 78 | 	$request = wp_check_filetype( wp_parse_url( $_SERVER['REQUEST_URI'], PHP_URL_PATH ) );
 79 | 
 80 | 	// If we have a file extension, then return it.
 81 | 	return isset( $request['ext'] ) ? $request['ext'] : '';
 82 | }
 83 | 
 84 | /**
 85 |  * Get the list of file extensions that should be checked.
 86 |  * filter `static_404_file_extensions` to modify.
 87 |  *
 88 |  * @return array Array of file extensions that could be static-404ed.
 89 |  */
 90 | function get_extensions() {
 91 | 	$wp_ext_types = wp_get_ext_types();
 92 | 	$extensions   = [];
 93 | 
 94 | 	// Flatten the array from [ 'image', 'audio', ... ] to one
 95 | 	// array with all the of the extensions.
 96 | 	foreach ( array_keys( $wp_ext_types ) as $ext_type ) {
 97 | 		$extensions = array_merge( $extensions, $wp_ext_types[ $ext_type ] );
 98 | 	}
 99 | 
100 | 	// Unset commonly used extensions that a user might have in a url for normal pages.
101 | 	unset( $extensions['html'] );
102 | 	unset( $extensions['htm'] );
103 | 	unset( $extensions['php'] );
104 | 
105 | 	// Add / remove extensions if you'd like!
106 | 	return apply_filters( 'static_404_extensions', $extensions );
107 | }
108 | 
109 | /**
110 |  * Get the error message. Default is '404 - Not Found'.
111 |  *
112 |  * @return string 404 error message.
113 |  */
114 | function get_message() {
115 | 	return apply_filters( 'static_404_message', '404 ' . get_status_header_desc( 404 ) );
116 | }
117 | 
118 | /**
119 |  * Allow filters to determine if we should process the request.
120 |  *
121 |  * @return bool Default is false unless filtered.
122 |  */
123 | function should_process_request() {
124 | 	return apply_filters( 'static_404_should_process_request', $_SERVER['REQUEST_URI'], false );
125 | }
126 | 


--------------------------------------------------------------------------------