Header send 500 error php - Исправление ошибок и поиск оптимальных решений проблем

Содержание

Send a 500 Internal Server Error header with PHP.
http_response_code
Description
Parameters
Return Values
Examples
See Also
User Contributed Notes 18 notes

This is a short guide on how to send a 500 Internal Server Error header to the client using PHP. This is useful because it allows us to tell the client that the server has encountered an unexpected condition and that it cannot fulfill the request.

Below, I have created a custom PHP function called internal_error.

When the PHP function above is called, the script’s execution is halted and “Something went wrong!” is printed out onto the page.

Furthermore, if you inspect the HTTP headers with your browser’s developer console, you will see that the function is returning a 500 Internal Server Error status code:

Google’s Developer Tools showing the 500 Internal Server Error status that was returned.

To send the 500 status code, we used PHP’s header function like so:

Note that we used the SERVER_PROTOCOL variable in this case because the client might be using HTTP 1.0 instead of HTTP 1.1. In other examples, you will find developers making the assumption that the client will always be using HTTP 1.1.

This is not the case.

The problem with PHP is that it doesn’t always send a 500 Internal Server Error when an exception is thrown or a fatal error occurs.

This can cause a number of issues:

It becomes more difficult to handle failed Ajax calls, as the server in question is still responding with a 200 OK status. For example: The JQuery Ajax error handling functions will not be called.
Search engines such as Google may index your error pages. If this happens, your website may lose its rankings.
Other HTTP clients might think that everything is A-OK when it is not.

Note that if you are using PHP version 5.4 or above, you can use the http_response_code function:

Источник

http_response_code

(PHP 5 >= 5.4.0, PHP 7, PHP

http_response_code — Get or Set the HTTP response code

Description

Gets or sets the HTTP response status code.

Parameters

The optional response_code will set the response code.

Return Values

If response_code is provided, then the previous status code will be returned. If response_code is not provided, then the current status code will be returned. Both of these values will default to a 200 status code if used in a web server environment.

false will be returned if response_code is not provided and it is not invoked in a web server environment (such as from a CLI application). true will be returned if response_code is provided and it is not invoked in a web server environment (but only when no previous response status has been set).

Examples

Example #1 Using http_response_code() in a web server environment

// Get the current response code and set a new one
var_dump ( http_response_code ( 404 ));

// Get the new response code
var_dump ( http_response_code ());
?>

The above example will output:

Example #2 Using http_response_code() in a CLI environment

// Get the current default response code
var_dump ( http_response_code ());

// Set a response code
var_dump ( http_response_code ( 201 ));

// Get the new response code
var_dump ( http_response_code ());
?>

The above example will output:

User Contributed Notes 18 notes

If your version of PHP does not include this function:

if (! function_exists ( ‘http_response_code’ )) <
function http_response_code ( $code = NULL ) <

switch ( $code ) <
case 100 : $text = ‘Continue’ ; break;
case 101 : $text = ‘Switching Protocols’ ; break;
case 200 : $text = ‘OK’ ; break;
case 201 : $text = ‘Created’ ; break;
case 202 : $text = ‘Accepted’ ; break;
case 203 : $text = ‘Non-Authoritative Information’ ; break;
case 204 : $text = ‘No Content’ ; break;
case 205 : $text = ‘Reset Content’ ; break;
case 206 : $text = ‘Partial Content’ ; break;
case 300 : $text = ‘Multiple Choices’ ; break;
case 301 : $text = ‘Moved Permanently’ ; break;
case 302 : $text = ‘Moved Temporarily’ ; break;
case 303 : $text = ‘See Other’ ; break;
case 304 : $text = ‘Not Modified’ ; break;
case 305 : $text = ‘Use Proxy’ ; break;
case 400 : $text = ‘Bad Request’ ; break;
case 401 : $text = ‘Unauthorized’ ; break;
case 402 : $text = ‘Payment Required’ ; break;
case 403 : $text = ‘Forbidden’ ; break;
case 404 : $text = ‘Not Found’ ; break;
case 405 : $text = ‘Method Not Allowed’ ; break;
case 406 : $text = ‘Not Acceptable’ ; break;
case 407 : $text = ‘Proxy Authentication Required’ ; break;
case 408 : $text = ‘Request Time-out’ ; break;
case 409 : $text = ‘Conflict’ ; break;
case 410 : $text = ‘Gone’ ; break;
case 411 : $text = ‘Length Required’ ; break;
case 412 : $text = ‘Precondition Failed’ ; break;
case 413 : $text = ‘Request Entity Too Large’ ; break;
case 414 : $text = ‘Request-URI Too Large’ ; break;
case 415 : $text = ‘Unsupported Media Type’ ; break;
case 500 : $text = ‘Internal Server Error’ ; break;
case 501 : $text = ‘Not Implemented’ ; break;
case 502 : $text = ‘Bad Gateway’ ; break;
case 503 : $text = ‘Service Unavailable’ ; break;
case 504 : $text = ‘Gateway Time-out’ ; break;
case 505 : $text = ‘HTTP Version not supported’ ; break;
default:
exit( ‘Unknown http status code «‘ . htmlentities ( $code ) . ‘»‘ );
break;
>

$protocol = (isset( $_SERVER [ ‘SERVER_PROTOCOL’ ]) ? $_SERVER [ ‘SERVER_PROTOCOL’ ] : ‘HTTP/1.0’ );

header ( $protocol . ‘ ‘ . $code . ‘ ‘ . $text );

$GLOBALS [ ‘http_response_code’ ] = $code ;

$code = (isset( $GLOBALS [ ‘http_response_code’ ]) ? $GLOBALS [ ‘http_response_code’ ] : 200 );

In this example I am using $GLOBALS, but you can use whatever storage mechanism you like. I don’t think there is a way to return the current status code:

For reference the error codes I got from PHP’s source code:

And how the current http header is sent, with the variables it uses:

Note that you can NOT set arbitrary response codes with this function, only those that are known to PHP (or the SAPI PHP is running on).

The following codes currently work as expected (with PHP running as Apache module):
200 – 208, 226
300 – 305, 307, 308
400 – 417, 422 – 424, 426, 428 – 429, 431
500 – 508, 510 – 511

Codes 0, 100, 101, and 102 will be sent as «200 OK».

Everything else will result in «500 Internal Server Error».

If you want to send responses with a freestyle status line, you need to use the `header()` function:

( «HTTP/1.0 418 I’m A Teapot» ); ?>

When setting the response code to non-standard ones like 420, Apache outputs 500 Internal Server Error.

This happens when using header(0,0,420) and http_response_code(420).
Use header(‘HTTP/1.1 420 Enhance Your Calm’) instead.

Note that the response code in the string IS interpreted and used in the access log and output via http_response_code().

Status codes as an array:

= array( 100 => «Continue» , 101 => «Switching Protocols» , 102 => «Processing» , 200 => «OK» , 201 => «Created» , 202 => «Accepted» , 203 => «Non-Authoritative Information» , 204 => «No Content» , 205 => «Reset Content» , 206 => «Partial Content» , 207 => «Multi-Status» , 300 => «Multiple Choices» , 301 => «Moved Permanently» , 302 => «Found» , 303 => «See Other» , 304 => «Not Modified» , 305 => «Use Proxy» , 306 => «(Unused)» , 307 => «Temporary Redirect» , 308 => «Permanent Redirect» , 400 => «Bad Request» , 401 => «Unauthorized» , 402 => «Payment Required» , 403 => «Forbidden» , 404 => «Not Found» , 405 => «Method Not Allowed» , 406 => «Not Acceptable» , 407 => «Proxy Authentication Required» , 408 => «Request Timeout» , 409 => «Conflict» , 410 => «Gone» , 411 => «Length Required» , 412 => «Precondition Failed» , 413 => «Request Entity Too Large» , 414 => «Request-URI Too Long» , 415 => «Unsupported Media Type» , 416 => «Requested Range Not Satisfiable» , 417 => «Expectation Failed» , 418 => «I’m a teapot» , 419 => «Authentication Timeout» , 420 => «Enhance Your Calm» , 422 => «Unprocessable Entity» , 423 => «Locked» , 424 => «Failed Dependency» , 424 => «Method Failure» , 425 => «Unordered Collection» , 426 => «Upgrade Required» , 428 => «Precondition Required» , 429 => «Too Many Requests» , 431 => «Request Header Fields Too Large» , 444 => «No Response» , 449 => «Retry With» , 450 => «Blocked by Windows Parental Controls» , 451 => «Unavailable For Legal Reasons» , 494 => «Request Header Too Large» , 495 => «Cert Error» , 496 => «No Cert» , 497 => «HTTP to HTTPS» , 499 => «Client Closed Request» , 500 => «Internal Server Error» , 501 => «Not Implemented» , 502 => «Bad Gateway» , 503 => «Service Unavailable» , 504 => «Gateway Timeout» , 505 => «HTTP Version Not Supported» , 506 => «Variant Also Negotiates» , 507 => «Insufficient Storage» , 508 => «Loop Detected» , 509 => «Bandwidth Limit Exceeded» , 510 => «Not Extended» , 511 => «Network Authentication Required» , 598 => «Network read timeout error» , 599 => «Network connect timeout error» );
?>

Source: Wikipedia «List_of_HTTP_status_codes»

Do not mix the use of http_response_code() and manually setting the response code header because the actual HTTP status code being returned by the web server may not end up as expected. http_response_code() does not work if the response code has previously been set using the header() function. Example:

( ‘HTTP/1.1 401 Unauthorized’ );
http_response_code ( 403 );
print( http_response_code ());
?>

The raw HTTP response will be (notice the actual status code on the first line does not match the printed http_response_code in the body):

HTTP/1.1 401 Unauthorized
Date: Tue, 24 Nov 2020 13:49:08 GMT
Server: Apache
Connection: Upgrade, Keep-Alive
Keep-Alive: timeout=5, max=100
Transfer-Encoding: chunked
Content-Type: text/html; charset=UTF-8

I only tested it on Apache. I am not sure if this behavior is specific to Apache or common to all PHP distributions.

You can also create a enum by extending the SplEnum class.
/** HTTP status codes */
class HttpStatusCode extends SplEnum <
const __default = self :: OK ;

const SWITCHING_PROTOCOLS = 101 ;
const OK = 200 ;
const CREATED = 201 ;
const ACCEPTED = 202 ;
const NONAUTHORITATIVE_INFORMATION = 203 ;
const NO_CONTENT = 204 ;
const RESET_CONTENT = 205 ;
const PARTIAL_CONTENT = 206 ;
const MULTIPLE_CHOICES = 300 ;
const MOVED_PERMANENTLY = 301 ;
const MOVED_TEMPORARILY = 302 ;
const SEE_OTHER = 303 ;
const NOT_MODIFIED = 304 ;
const USE_PROXY = 305 ;
const BAD_REQUEST = 400 ;
const UNAUTHORIZED = 401 ;
const PAYMENT_REQUIRED = 402 ;
const FORBIDDEN = 403 ;
const NOT_FOUND = 404 ;
const METHOD_NOT_ALLOWED = 405 ;
const NOT_ACCEPTABLE = 406 ;
const PROXY_AUTHENTICATION_REQUIRED = 407 ;
const REQUEST_TIMEOUT = 408 ;
const CONFLICT = 408 ;
const GONE = 410 ;
const LENGTH_REQUIRED = 411 ;
const PRECONDITION_FAILED = 412 ;
const REQUEST_ENTITY_TOO_LARGE = 413 ;
const REQUESTURI_TOO_LARGE = 414 ;
const UNSUPPORTED_MEDIA_TYPE = 415 ;
const REQUESTED_RANGE_NOT_SATISFIABLE = 416 ;
const EXPECTATION_FAILED = 417 ;
const IM_A_TEAPOT = 418 ;
const INTERNAL_SERVER_ERROR = 500 ;
const NOT_IMPLEMENTED = 501 ;
const BAD_GATEWAY = 502 ;
const SERVICE_UNAVAILABLE = 503 ;
const GATEWAY_TIMEOUT = 504 ;
const HTTP_VERSION_NOT_SUPPORTED = 505 ;
>

if you need a response code not supported by http_response_code(), such as WebDAV / RFC4918’s «HTTP 507 Insufficient Storage», try:

( $_SERVER [ ‘SERVER_PROTOCOL’ ] . ‘ 507 Insufficient Storage’ );
?>
result: something like

HTTP/1.1 507 Insufficient Storage

The note above from «Anonymous» is wrong. I’m running this behind the AWS Elastic Loadbalancer and trying the header(‘:’.$error_code. ) method mentioned above is treated as invalid HTTP.

The documentation for the header() function has the right way to implement this if you’re still on ( «HTTP/1.0 404 Not Found» );
?>

At least on my side with php-fpm and nginx this method does not change the text in the response, only the code.

// HTTP/1.1 404 Not Found
http_response_code ( 404 );

The resulting response is HTTP/1.1 404 OK

http_response_code is basically a shorthand way of writing a http status header, with the added bonus that PHP will work out a suitable Reason Phrase to provide by matching your response code to one of the values in an enumeration it maintains within php-src/main/http_status_codes.h. Note that this means your response code must match a response code that PHP knows about. You can’t create your own response codes using this method, however you can using the header method.

In summary — The differences between «http_response_code» and «header» for setting response codes:

1. Using http_response_code will cause PHP to match and apply a Reason Phrase from a list of Reason Phrases that are hard-coded into the PHP source code.

2. Because of point 1 above, if you use http_response_code you must set a code that PHP knows about. You can’t set your own custom code, however you can set a custom code (and Reason Phrase) if you use the header method.

It’s not mentioned explicitly, but the return value when SETTING, is the OLD status code.
e.g.
= http_response_code ();
$b = http_response_code ( 202 );
$c = http_response_code ();

var_dump ( $a , $b , $c );

http_response_code() does not actually send HTTP headers, it only prepares the header list to be sent later on.
So you can call http_reponse_code() to set, get and reset the HTTP response code before it gets sent.

http_response_code(500); // set the code
var_dump(headers_sent()); // check if headers are sent
http_response_code(200); // avoid a default browser page

On PHP 5.3 version, If you want to set HTTP response code. You can try this type of below trick 🙂

( ‘Temporary-Header: True’ , true , 404 );
header_remove ( ‘Temporary-Header’ );

@craig at craigfrancis dot co dot uk@ wrote the function that replaces the original. It is very usefull, but has a bug. The original http_response_code always returns the previous or current code, not the code you are setting now. Here is my fixed version. I also use $GLOBALS to store the current code, but trigger_error() instead of exit. So now, how the function will behave in the case of error lies on the error handler. Or you can change it back to exit().

if (!function_exists(‘http_response_code’)) <
function http_response_code($code = NULL) <
$prev_code = (isset($GLOBALS[‘http_response_code’]) ? $GLOBALS[‘http_response_code’] : 200);

if ($code === NULL) <
return $prev_code;
>

switch ($code) <
case 100: $text = ‘Continue’; break;
case 101: $text = ‘Switching Protocols’; break;
case 200: $text = ‘OK’; break;
case 201: $text = ‘Created’; break;
case 202: $text = ‘Accepted’; break;
case 203: $text = ‘Non-Authoritative Information’; break;
case 204: $text = ‘No Content’; break;
case 205: $text = ‘Reset Content’; break;
case 206: $text = ‘Partial Content’; break;
case 300: $text = ‘Multiple Choices’; break;
case 301: $text = ‘Moved Permanently’; break;
case 302: $text = ‘Moved Temporarily’; break;
case 303: $text = ‘See Other’; break;
case 304: $text = ‘Not Modified’; break;
case 305: $text = ‘Use Proxy’; break;
case 400: $text = ‘Bad Request’; break;
case 401: $text = ‘Unauthorized’; break;
case 402: $text = ‘Payment Required’; break;
case 403: $text = ‘Forbidden’; break;
case 404: $text = ‘Not Found’; break;
case 405: $text = ‘Method Not Allowed’; break;
case 406: $text = ‘Not Acceptable’; break;
case 407: $text = ‘Proxy Authentication Required’; break;
case 408: $text = ‘Request Time-out’; break;
case 409: $text = ‘Conflict’; break;
case 410: $text = ‘Gone’; break;
case 411: $text = ‘Length Required’; break;
case 412: $text = ‘Precondition Failed’; break;
case 413: $text = ‘Request Entity Too Large’; break;
case 414: $text = ‘Request-URI Too Large’; break;
case 415: $text = ‘Unsupported Media Type’; break;
case 500: $text = ‘Internal Server Error’; break;
case 501: $text = ‘Not Implemented’; break;
case 502: $text = ‘Bad Gateway’; break;
case 503: $text = ‘Service Unavailable’; break;
case 504: $text = ‘Gateway Time-out’; break;
case 505: $text = ‘HTTP Version not supported’; break;
default:
trigger_error(‘Unknown http status code ‘ . $code, E_USER_ERROR); // exit(‘Unknown http status code «‘ . htmlentities($code) . ‘»‘);
return $prev_code;
>

$protocol = (isset($_SERVER[‘SERVER_PROTOCOL’]) ? $_SERVER[‘SERVER_PROTOCOL’] : ‘HTTP/1.0’);
header($protocol . ‘ ‘ . $code . ‘ ‘ . $text);
$GLOBALS[‘http_response_code’] = $code;

// original function always returns the previous or current code
return $prev_code;
>
>

Источник

Below, I have created a custom PHP function called internal_error.

//Function that sends a 500 Internal Server Error status code to
//the client before killing the script.
function internal_error(){
    header($_SERVER["SERVER_PROTOCOL"] . ' 500 Internal Server Error', true, 500);
    echo '<h1>Something went wrong!</h1>';
    exit;
}

When the PHP function above is called, the script’s execution is halted and “Something went wrong!” is printed out onto the page.

Furthermore, if you inspect the HTTP headers with your browser’s developer console, you will see that the function is returning a 500 Internal Server Error status code:

Google’s Developer Tools showing the 500 Internal Server Error status that was returned.

To send the 500 status code, we used PHP’s header function like so:

//Send a 500 status code using PHP's header function
header($_SERVER["SERVER_PROTOCOL"] . ' 500 Internal Server Error', true, 500);

This is not the case.

The problem with PHP is that it doesn’t always send a 500 Internal Server Error when an exception is thrown or a fatal error occurs.

This can cause a number of issues:

It becomes more difficult to handle failed Ajax calls, as the server in question is still responding with a 200 OK status. For example: The JQuery Ajax error handling functions will not be called.
Search engines such as Google may index your error pages. If this happens, your website may lose its rankings.
Other HTTP clients might think that everything is A-OK when it is not.

Note that if you are using PHP version 5.4 or above, you can use the http_response_code function:

//Using http_response_code
http_response_code(500);

Far more concise!

Источник

(PHP 5 >= 5.4.0, PHP 7, PHP

http_response_code — Get or Set the HTTP response code

Description

http_response_code(int $response_code = 0): int|bool

Parameters

response_code: The optional response_code will set the response code.

Return Values

If response_code is provided, then the previous
status code will be returned. If response_code is not
provided, then the current status code will be returned. Both of these
values will default to a 200 status code if used in a web
server environment.

false will be returned if response_code is not
provided and it is not invoked in a web server environment (such as from a
CLI application). true will be returned if
response_code is provided and it is not invoked in a
web server environment (but only when no previous response status has been
set).

Examples

Example #1 Using http_response_code() in a web server environment

<?php// Get the current response code and set a new one var_dump(http_response_code(404));// Get the new response code var_dump(http_response_code()); ?>

The above example will output:

Example #2 Using http_response_code() in a CLI environment

<?php// Get the current default response code var_dump(http_response_code());// Set a response code var_dump(http_response_code(201));// Get the new response code var_dump(http_response_code()); ?>

The above example will output:

bool(false)
bool(true)
int(201)


<?phpif (!function_exists('http_response_code')) {
        function http_response_code($code = NULL) {



  


                       
  




            if (
$code !== NULL) {
                switch (
$code) {
                    case 100: $text = 'Continue'; break;
                    case 101: $text = 'Switching Protocols'; break;
                    case 200: $text = 'OK'; break;
                    case 201: $text = 'Created'; break;
                    case 202: $text = 'Accepted'; break;
                    case 203: $text = 'Non-Authoritative Information'; break;
                    case 204: $text = 'No Content'; break;
                    case 205: $text = 'Reset Content'; break;
                    case 206: $text = 'Partial Content'; break;
                    case 300: $text = 'Multiple Choices'; break;
                    case 301: $text = 'Moved Permanently'; break;
                    case 302: $text = 'Moved Temporarily'; break;
                    case 303: $text = 'See Other'; break;
                    case 304: $text = 'Not Modified'; break;
                    case 305: $text = 'Use Proxy'; break;
                    case 400: $text = 'Bad Request'; break;
                    case 401: $text = 'Unauthorized'; break;
                    case 402: $text = 'Payment Required'; break;
                    case 403: $text = 'Forbidden'; break;
                    case 404: $text = 'Not Found'; break;
                    case 405: $text = 'Method Not Allowed'; break;
                    case 406: $text = 'Not Acceptable'; break;
                    case 407: $text = 'Proxy Authentication Required'; break;
                    case 408: $text = 'Request Time-out'; break;
                    case 409: $text = 'Conflict'; break;
                    case 410: $text = 'Gone'; break;
                    case 411: $text = 'Length Required'; break;
                    case 412: $text = 'Precondition Failed'; break;
                    case 413: $text = 'Request Entity Too Large'; break;
                    case 414: $text = 'Request-URI Too Large'; break;
                    case 415: $text = 'Unsupported Media Type'; break;
                    case 500: $text = 'Internal Server Error'; break;
                    case 501: $text = 'Not Implemented'; break;
                    case 502: $text = 'Bad Gateway'; break;
                    case 503: $text = 'Service Unavailable'; break;
                    case 504: $text = 'Gateway Time-out'; break;
                    case 505: $text = 'HTTP Version not supported'; break;
                    default:
                        exit('Unknown http status code "' . htmlentities($code) . '"');
                    break;
                }$protocol = (isset($_SERVER['SERVER_PROTOCOL']) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0');header($protocol . ' ' . $code . ' ' . $text);$GLOBALS['http_response_code'] = $code;
            } else {
$code = (isset($GLOBALS['http_response_code']) ? $GLOBALS['http_response_code'] : 200);
            }
            return 
$code;
        }
    }



  


                       
  




?>

In this example I am using $GLOBALS, but you can use whatever storage mechanism you like... I don't think there is a way to return the current status code:
https://bugs.php.net/bug.php?id=52555
For reference the error codes I got from PHP's source code:
http://lxr.php.net/opengrok/xref/PHP_5_4/sapi/cgi/cgi_main.c#354
And how the current http header is sent, with the variables it uses:
http://lxr.php.net/opengrok/xref/PHP_5_4/main/SAPI.c#856

Stefan W ¶

8 years ago

Note that you can NOT set arbitrary response codes with this function, only those that are known to PHP (or the SAPI PHP is running on).


The following codes currently work as expected (with PHP running as Apache module):
200 – 208, 226
300 – 305, 307, 308
400 – 417, 422 – 424, 426, 428 – 429, 431
500 – 508, 510 – 511
Codes 0, 100, 101, and 102 will be sent as "200 OK".
Everything else will result in "500 Internal Server Error".
If you want to send responses with a freestyle status line, you need to use the `header()` function:
<?php header("HTTP/1.0 418 I'm A Teapot"); ?>

Thomas A. P. ¶

7 years ago

When setting the response code to non-standard ones like 420, Apache outputs 500 Internal Server Error.


This happens when using header(0,0,420) and http_response_code(420).
Use header('HTTP/1.1 420 Enhance Your Calm') instead.
Note that the response code in the string IS interpreted and used in the access log and output via http_response_code().

Anonymous ¶

9 years ago

Status codes as an array:


<?php
$http_status_codes = array(100 => "Continue", 101 => "Switching Protocols", 102 => "Processing", 200 => "OK", 201 => "Created", 202 => "Accepted", 203 => "Non-Authoritative Information", 204 => "No Content", 205 => "Reset Content", 206 => "Partial Content", 207 => "Multi-Status", 300 => "Multiple Choices", 301 => "Moved Permanently", 302 => "Found", 303 => "See Other", 304 => "Not Modified", 305 => "Use Proxy", 306 => "(Unused)", 307 => "Temporary Redirect", 308 => "Permanent Redirect", 400 => "Bad Request", 401 => "Unauthorized", 402 => "Payment Required", 403 => "Forbidden", 404 => "Not Found", 405 => "Method Not Allowed", 406 => "Not Acceptable", 407 => "Proxy Authentication Required", 408 => "Request Timeout", 409 => "Conflict", 410 => "Gone", 411 => "Length Required", 412 => "Precondition Failed", 413 => "Request Entity Too Large", 414 => "Request-URI Too Long", 415 => "Unsupported Media Type", 416 => "Requested Range Not Satisfiable", 417 => "Expectation Failed", 418 => "I'm a teapot", 419 => "Authentication Timeout", 420 => "Enhance Your Calm", 422 => "Unprocessable Entity", 423 => "Locked", 424 => "Failed Dependency", 424 => "Method Failure", 425 => "Unordered Collection", 426 => "Upgrade Required", 428 => "Precondition Required", 429 => "Too Many Requests", 431 => "Request Header Fields Too Large", 444 => "No Response", 449 => "Retry With", 450 => "Blocked by Windows Parental Controls", 451 => "Unavailable For Legal Reasons", 494 => "Request Header Too Large", 495 => "Cert Error", 496 => "No Cert", 497 => "HTTP to HTTPS", 499 => "Client Closed Request", 500 => "Internal Server Error", 501 => "Not Implemented", 502 => "Bad Gateway", 503 => "Service Unavailable", 504 => "Gateway Timeout", 505 => "HTTP Version Not Supported", 506 => "Variant Also Negotiates", 507 => "Insufficient Storage", 508 => "Loop Detected", 509 => "Bandwidth Limit Exceeded", 510 => "Not Extended", 511 => "Network Authentication Required", 598 => "Network read timeout error", 599 => "Network connect timeout error");
?>

Source: Wikipedia "List_of_HTTP_status_codes"

viaujoc at videotron dot ca ¶

2 years ago

Do not mix the use of http_response_code() and manually setting the response code header because the actual HTTP status code being returned by the web server may not end up as expected. http_response_code() does not work if the response code has previously been set using the header() function. Example:


<?php
header('HTTP/1.1 401 Unauthorized');
http_response_code(403);
print(http_response_code());
?>

The raw HTTP response will be (notice the actual status code on the first line does not match the printed http_response_code in the body):
HTTP/1.1 401 Unauthorized
Date: Tue, 24 Nov 2020 13:49:08 GMT
Server: Apache
Connection: Upgrade, Keep-Alive
Keep-Alive: timeout=5, max=100
Transfer-Encoding: chunked
Content-Type: text/html; charset=UTF-8
403
I only tested it on Apache. I am not sure if this behavior is specific to Apache or common to all PHP distributions.

Anonymous ¶

8 years ago

You can also create a enum by extending the SplEnum class. <?php/** HTTP status codes */ class HttpStatusCode extends SplEnum { const __default = self::OK;


        const

SWITCHING_PROTOCOLS = 101; const OK = 200; const CREATED = 201; const ACCEPTED = 202; const NONAUTHORITATIVE_INFORMATION = 203; const NO_CONTENT = 204; const RESET_CONTENT = 205; const PARTIAL_CONTENT = 206; const MULTIPLE_CHOICES = 300; const MOVED_PERMANENTLY = 301; const MOVED_TEMPORARILY = 302; const SEE_OTHER = 303; const NOT_MODIFIED = 304; const USE_PROXY = 305; const BAD_REQUEST = 400; const UNAUTHORIZED = 401; const PAYMENT_REQUIRED = 402; const FORBIDDEN = 403; const NOT_FOUND = 404; const METHOD_NOT_ALLOWED = 405; const NOT_ACCEPTABLE = 406; const PROXY_AUTHENTICATION_REQUIRED = 407; const REQUEST_TIMEOUT = 408; const CONFLICT = 408; const GONE = 410; const LENGTH_REQUIRED = 411; const PRECONDITION_FAILED = 412; const REQUEST_ENTITY_TOO_LARGE = 413; const REQUESTURI_TOO_LARGE = 414; const UNSUPPORTED_MEDIA_TYPE = 415; const REQUESTED_RANGE_NOT_SATISFIABLE = 416; const EXPECTATION_FAILED = 417; const IM_A_TEAPOT = 418; const INTERNAL_SERVER_ERROR = 500; const NOT_IMPLEMENTED = 501; const BAD_GATEWAY = 502; const SERVICE_UNAVAILABLE = 503; const GATEWAY_TIMEOUT = 504; const HTTP_VERSION_NOT_SUPPORTED = 505; }

Rob Zazueta ¶

9 years ago

The note above from "Anonymous" is wrong. I'm running this behind the AWS Elastic Loadbalancer and trying the header(':'.$error_code...) method mentioned above is treated as invalid HTTP.


The documentation for the header() function has the right way to implement this if you're still on < php 5.4:



  


                       
  




<?php
header("HTTP/1.0 404 Not Found");
?>

Anonymous ¶

10 years ago

If you don't have PHP 5.4 and want to change the returned status code, you can simply write: <?php header(':', true, $statusCode); ?> The ':' are mandatory, or it won't work

divinity76 at gmail dot com ¶

2 years ago

if you need a response code not supported by http_response_code(), such as WebDAV / RFC4918's "HTTP 507 Insufficient Storage", try:





  


                       
  




<?php
header($_SERVER['SERVER_PROTOCOL'] . ' 507 Insufficient Storage');
?>
result: something like
HTTP/1.1 507 Insufficient Storage

Steven ¶

7 years ago

http_response_code is basically a shorthand way of writing a http status header, with the added bonus that PHP will work out a suitable Reason Phrase to provide by matching your response code to one of the values in an enumeration it maintains within php-src/main/http_status_codes.h. Note that this means your response code must match a response code that PHP knows about. You can't create your own response codes using this method, however you can using the header method.


In summary - The differences between "http_response_code" and "header" for setting response codes:
1. Using http_response_code will cause PHP to match and apply a Reason Phrase from a list of Reason Phrases that are hard-coded into the PHP source code.
2. Because of point 1 above, if you use http_response_code you must set a code that PHP knows about. You can't set your own custom code, however you can set a custom code (and Reason Phrase) if you use the header method.

Richard F. ¶

9 years ago

At least on my side with php-fpm and nginx this method does not change the text in the response, only the code.


<?php// HTTP/1.1 404 Not Found
http_response_code(404);?>

The resulting response is HTTP/1.1 404 OK

stephen at bobs-bits dot com ¶

8 years ago

It's not mentioned explicitly, but the return value when SETTING, is the OLD status code. e.g. <?php

$a

= http_response_code(); $b = http_response_code(202); $c = http_response_code();var_dump($a, $b, $c);// Result: // int(200) // int(200) // int(202) ?>

Chandra Nakka ¶

5 years ago

On PHP 5.3 version, If you want to set HTTP response code. You can try this type of below trick :)


<?php
header
('Temporary-Header: True', true, 404);
header_remove('Temporary-Header');?>

yefremov {dot} sasha () gmail {dot} com ¶

8 years ago

@craig at craigfrancis dot co dot uk@ wrote the function that replaces the original. It is very usefull, but has a bug. The original http_response_code always returns the previous or current code, not the code you are setting now. Here is my fixed version. I also use $GLOBALS to store the current code, but trigger_error() instead of exit. So now, how the function will behave in the case of error lies on the error handler. Or you can change it back to exit().


if (!function_exists('http_response_code')) {
    function http_response_code($code = NULL) {     
        $prev_code = (isset($GLOBALS['http_response_code']) ? $GLOBALS['http_response_code'] : 200);
        if ($code === NULL) {
            return $prev_code;
        }
        switch ($code) {
            case 100: $text = 'Continue'; break;
            case 101: $text = 'Switching Protocols'; break;
            case 200: $text = 'OK'; break;
            case 201: $text = 'Created'; break;
            case 202: $text = 'Accepted'; break;
            case 203: $text = 'Non-Authoritative Information'; break;
            case 204: $text = 'No Content'; break;
            case 205: $text = 'Reset Content'; break;
            case 206: $text = 'Partial Content'; break;
            case 300: $text = 'Multiple Choices'; break;
            case 301: $text = 'Moved Permanently'; break;
            case 302: $text = 'Moved Temporarily'; break;
            case 303: $text = 'See Other'; break;
            case 304: $text = 'Not Modified'; break;
            case 305: $text = 'Use Proxy'; break;
            case 400: $text = 'Bad Request'; break;
            case 401: $text = 'Unauthorized'; break;
            case 402: $text = 'Payment Required'; break;
            case 403: $text = 'Forbidden'; break;
            case 404: $text = 'Not Found'; break;
            case 405: $text = 'Method Not Allowed'; break;
            case 406: $text = 'Not Acceptable'; break;
            case 407: $text = 'Proxy Authentication Required'; break;
            case 408: $text = 'Request Time-out'; break;
            case 409: $text = 'Conflict'; break;
            case 410: $text = 'Gone'; break;
            case 411: $text = 'Length Required'; break;
            case 412: $text = 'Precondition Failed'; break;
            case 413: $text = 'Request Entity Too Large'; break;
            case 414: $text = 'Request-URI Too Large'; break;
            case 415: $text = 'Unsupported Media Type'; break;
            case 500: $text = 'Internal Server Error'; break;
            case 501: $text = 'Not Implemented'; break;
            case 502: $text = 'Bad Gateway'; break;
            case 503: $text = 'Service Unavailable'; break;
            case 504: $text = 'Gateway Time-out'; break;
            case 505: $text = 'HTTP Version not supported'; break;
            default:
                trigger_error('Unknown http status code ' . $code, E_USER_ERROR); // exit('Unknown http status code "' . htmlentities($code) . '"');
                return $prev_code;
        }
        $protocol = (isset($_SERVER['SERVER_PROTOCOL']) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0');
        header($protocol . ' ' . $code . ' ' . $text);
        $GLOBALS['http_response_code'] = $code;
        // original function always returns the previous or current code
        return $prev_code;
    }
}

Anonymous ¶

4 years ago

http_response_code() does not actually send HTTP headers, it only prepares the header list to be sent later on. So you can call http_reponse_code() to set, get and reset the HTTP response code before it gets sent.


Test code:
<php
http_response_code(500);  // set the code
var_dump(headers_sent());  // check if headers are sent
http_response_code(200);  // avoid a default browser page

Kubo2 ¶

6 years ago

If you want to set a HTTP response code without the need of specifying a protocol version, you can actually do it without http_response_code():


<?php
header
('Status: 404', TRUE, 404);?>

zweibieren at yahoo dot com ¶

7 years ago

The limited list given by Stefan W is out of date. I have just tested 301 and 302 and both work.

divinity76 at gmail dot com ¶

6 years ago

warning, it does not check if headers are already sent (if it is, it won't *actually* change the code, but a subsequent call will imply that it did!!),


you might wanna do something like 
function ehttp_response_code(int $response_code = NULL): int {
    if ($response_code === NULL) {
        return http_response_code();
    }
    if (headers_sent()) {
        throw new Exception('tried to change http response code after sending headers!');
    }
    return http_response_code($response_code);
}

Источник

Home
http headers — How to send 500 Internal Server Error error from a PHP script

71 votes

6 answers

Get the solution ↓↓↓

I need to send «500 Internal Server Error» from an PHP script under certain conditions. The script is supposed to be called by a third party app. The script contains a couple ofdie("this happend") statements for which I need to send the500 Internal Server Error response code instead of the usual200 OK. The third party script will re-send the request under certain conditions which include not receiving the200 OK response code.

Second part of the question: I need to setup my script like this:

<?php
    custom_header( "500 Internal Server Error" );

    if ( that_happened ) {
        die( "that happened" )
    }

    if ( something_else_happened ) {
        die( "something else happened" )
    }

    update_database( );

    // the script can also fail on the above line
    // e.g. a mysql error occurred

    remove_header( "500" );
?>

I need to send200 header only after the last line has been executed.

Edit

A side question: can I send strange 500 headers such as these:

HTTP/1.1 500 No Record Found
HTTP/1.1 500 Script Generated Error (E_RECORD_NOT_FOUND)
HTTP/1.1 500 Conditions Failed on Line 23

Will such errors get logged by the webserver?

2022-08-20

Write your answer

votes

Answer

Solution:

header($_SERVER['SERVER_PROTOCOL'] . ' 500 Internal Server Error', true, 500);

661

votes

Answer

Solution:

PHP 5.4 has a function called http_response_code, so if you’re using PHP 5.4 you can just do:

http_response_code(500);

I’ve written a polyfill for this function (Gist) if you’re running a version of PHP under 5.4.

To answer your follow-up question, the HTTP 1.1 RFC says:

The reason phrases listed here are only recommendations — they MAY be
replaced by local equivalents without affecting the protocol.

That means you can use whatever text you want (excluding carriage returns or line feeds) after the code itself, and it’ll work. Generally, though, there’s usually a better response code to use. For example, instead of using a 500 for no record found, you could send a 404 (not found), and for something like «conditions failed» (I’m guessing a validation error), you could send something like a 422 (unprocessable entity).

585

votes

Answer

Solution:

You may use the following function to send a status change:

function header_status($statusCode) {
    static $status_codes = null;

    if ($status_codes === null) {
        $status_codes = array (
            100 => 'Continue',
            101 => 'Switching Protocols',
            102 => 'Processing',
            200 => 'OK',
            201 => 'Created',
            202 => 'Accepted',
            203 => 'Non-Authoritative Information',
            204 => 'No Content',
            205 => 'Reset Content',
            206 => 'Partial Content',
            207 => 'Multi-Status',
            300 => 'Multiple Choices',
            301 => 'Moved Permanently',
            302 => 'Found',
            303 => 'See Other',
            304 => 'Not Modified',
            305 => 'Use Proxy',
            307 => 'Temporary Redirect',
            400 => 'Bad Request',
            401 => 'Unauthorized',
            402 => 'Payment Required',
            403 => 'Forbidden',
            404 => 'Not Found',
            405 => 'Method Not Allowed',
            406 => 'Not Acceptable',
            407 => 'Proxy Authentication Required',
            408 => 'Request Timeout',
            409 => 'Conflict',
            410 => 'Gone',
            411 => 'Length Required',
            412 => 'Precondition Failed',
            413 => 'Request Entity Too Large',
            414 => 'Request-URI Too Long',
            415 => 'Unsupported Media Type',
            416 => 'Requested Range Not Satisfiable',
            417 => 'Expectation Failed',
            422 => 'Unprocessable Entity',
            423 => 'Locked',
            424 => 'Failed Dependency',
            426 => 'Upgrade Required',
            500 => 'Internal Server Error',
            501 => 'Not Implemented',
            502 => 'Bad Gateway',
            503 => 'Service Unavailable',
            504 => 'Gateway Timeout',
            505 => 'HTTP Version Not Supported',
            506 => 'Variant Also Negotiates',
            507 => 'Insufficient Storage',
            509 => 'Bandwidth Limit Exceeded',
            510 => 'Not Extended'
        );
    }

    if ($status_codes[$statusCode] !== null) {
        $status_string = $statusCode . ' ' . $status_codes[$statusCode];
        header($_SERVER['SERVER_PROTOCOL'] . ' ' . $status_string, true, $statusCode);
    }
}

You may use it as such:

<?php
header_status(500);

if (that_happened) {
    die("that happened")
}

if (something_else_happened) {
    die("something else happened")
}

update_database();

header_status(200);

768

votes

Answer

Solution:

You can just put:

header("HTTP/1.0 500 Internal Server Error");

inside your conditions like:

if (that happened) {
    header("HTTP/1.0 500 Internal Server Error");
}

As for the database query, you can just do that like this:

$result = mysql_query("..query string..") or header("HTTP/1.0 500 Internal Server Error");

You should remember that you have to put this code before any html tag (or output).

508

votes

Answer

Solution:

You can simplify it like this:

if ( that_happened || something_else_happened )
{
    header('X-Error-Message: Incorrect username or password', true, 500);
    die;
}

It will return following header:

HTTP/1.1 500 Internal Server Error
...
X-Error-Message: Incorrect username or password
...

Added: If you need to know exactly what went wrong, do something like this:

if ( that_happened )
{
    header('X-Error-Message: Incorrect username', true, 500);
    die('Incorrect username');
}

if ( something_else_happened )
{
    header('X-Error-Message: Incorrect password', true, 500);
    die('Incorrect password');
}

168

votes

Answer

Solution:

Your code should look like:

<?php
if ( that_happened ) {
    header("HTTP/1.0 500 Internal Server Error");
    die();
}

if ( something_else_happened ) {
    header("HTTP/1.0 500 Internal Server Error");
    die();
}

// Your function should return FALSE if something goes wrong
if ( !update_database() ) {
    header("HTTP/1.0 500 Internal Server Error");
    die();
}

// the script can also fail on the above line
// e.g. a mysql error occurred


header('HTTP/1.1 200 OK');
?>

I assume you stop execution if something goes wrong.

Share solution ↓

Additional Information:

Date the issue was resolved:

2022-08-20

Link To Source

Link To Answer
People are also looking for solutions of the problem: constant expression contains invalid operations

Didn’t find the answer?

Our community is visited by hundreds of web development professionals every day. Ask your question and get a quick answer for free.

Write quick answer

Do you know the answer to this question? Write a quick response to it. With your help, we will make our community stronger.

About the technologies asked in this question

PHP

PHP (from the English Hypertext Preprocessor — hypertext preprocessor) is a scripting programming language for developing web applications. Supported by most hosting providers, it is one of the most popular tools for creating dynamic websites.
The PHP scripting language has gained wide popularity due to its processing speed, simplicity, cross-platform, functionality and distribution of source codes under its own license.
https://www.php.net/

MySQL

DBMS is a database management system. It is designed to change, search, add and delete information in the database. There are many DBMSs designed for similar purposes with different features. One of the most popular is MySQL.
It is a software tool designed to work with relational SQL databases. It is easy to learn even for site owners who are not professional programmers or administrators. MySQL DBMS also allows you to export and import data, which is convenient when moving large amounts of information.
https://www.mysql.com/

HTML

HTML (English «hyper text markup language» — hypertext markup language) is a special markup language that is used to create sites on the Internet.
Browsers understand html perfectly and can interpret it in an understandable way. In general, any page on the site is html-code, which the browser translates into a user-friendly form. By the way, the code of any page is available to everyone.
https://www.w3.org/html/

Welcome to programmierfrage.com

programmierfrage.com is a question and answer site for professional web developers, programming enthusiasts and website builders. Site created and operated by the community. Together with you, we create a free library of detailed answers to any question on programming, web development, website creation and website administration.

Get answers to specific questions

Ask about the real problem you are facing. Describe in detail what you are doing and what you want to achieve.

Help Others Solve Their Issues

Our goal is to create a strong community in which everyone will support each other. If you find a question and know the answer to it, help others with your knowledge.

Источник

Программирование
>
php
>
Коды ответа сервера

Как изменить код ответа сервера
Если требуется перенаправить на другой url
Заголовки кодировки и языка
Модификация заголовков для управления контентом
Как влиять на СЕО

При серьезной разработке сайта возникает необходимость выдавать корректные http заголовки php средствами.
Вы спросите — зачем? Затем, что корректность HTTP-заголовков влияет на то, как будут понимать поисковые роботы получаемую с вашего сайта информацию, что напрямую влияет на продвижение сайта, т.е. на «СЕО».

ВАЖНО ПОМНИТЬ!
мордифицировать HTTP header с помощью языка php возможно только если директива header выводится на клиента до формировании страницы, то есть до вывода любой иной инофрмации.
В противном случае назначение нового статуса HTTP заголовку / header выдает ошибку.

Как изменить код ответа сервера.

В большинстве случаев заголовки изменяются непосредственно в ваших php функциях (методах).

<?php
function checkUrl( $url )
{
if( preg_match( «/^http.*/i», $url ) == false )
header( ‘Location: http://www.ru/404.html’ );
}
…
?>

Рассмотрим несколько примеров модификации HTTP заголовков.

Страница выполнена корректно

header( ‘HTTP/1.1 200 OK’ );

Запрашиваемая страница не найдена

header( ‘HTTP/1.1 404 Not Found’ );

Доступ запрещен:

header( ‘HTTP/1.1 403 Forbidden’ );

Страница перемещена навсегда.

Используется для корректировки урлов поисковых серверов.

header( ‘HTTP/1.1 301 Moved Permanently’ );

Сервер выполнил скрипт с ошибкой

header( ‘HTTP/1.1 500 Internal Server Error’ );

Если требуется перенаправить на другой url

Перенаправление на указанный адресу

header( ‘Location: http://www.ru/’ );

Перенаправление на указанный адрес с задержкой в 5 секунд

в принципе это калька HTML тега
<meta http-equiv=»refresh» content=»5;http://www.ru/ />

header( ‘Refresh: 5; url=http://www.ru/’ );

Заголовки кодировки и языка

Содержимое страницы использует язык:

header( ‘Content-language: en’ ); // en = English

Как поменять кодировку

header(‘Content-Type: text/html; charset=utf-8’);

Модификация заголовков для управления контентом

header( ‘Content-Type: application/octet-stream’ );
header( ‘Content-Disposition: attachment; filename=»example.zip»‘ );
header( ‘Content-Transfer-Encoding: binary’ );

Установка content type

header(‘Content-Type: text/plain’); // plain text file
header(‘Content-Type: image/jpeg’); // JPG picture
header(‘Content-Type: audio/mpeg’); // Audio MPEG (MP3,…) file
header(‘Content-Type: application/x-shockwave-flash’); // Flash animation

Иные манипуляции с заголовками

как средствами php изменять header для поисковых роботов

Содержимое страницы последний раз изменялось

header( ‘Last-Modified: ‘.gmdate( ‘D, d M Y H:i:s’, ( time() — 60 ) ).’ GMT’ );

Длинна содержимого страницы

header( ‘Content-Length: 2048’ );

Отключение кеширования страницы:

header( ‘Cache-Control: no-cache, no-store, max-age=0, must-revalidate’ );
header( ‘Expires: Mon, 1 Apr 2001 01:02:03 GMT’ );
header( ‘Pragma: no-cache’ );

Программирование
>
php
>
Коды ответа сервера

Источник

Предыдующая статья: Делаем собственную страницу ошибки 404

2019-12-01

Здравствуйте, уважаемый посетитель!

Сегодня в рамах рассмотрения системы обработки ошибок выполним необходимые действия по выводу пользователю сообщения о возникновении внутренней ошибки сервера Internal Server Error, соответствующей статусу HTTP 500.

Это необходимо сделать, так как никто не застрахован от возникновения подобных проблем. В таких случаях, если не предпринять соответстующих мер, пользователь в своем браузере будет видеть только лишь какой-нибудь ущербный, неполноценный вариант веб-страницы. Либо вообще пустой экран или страницу в несколько строк с непонятными для него техническими терминами.

И вот для того, чтобы упорядочить работу сайта, обеспечивая пользователя при любых ситуациях необходимой информацией, мы создадим собственную страницу 500.

А затем, для обеспечения на нее перенаправления, сформируем пользовательский обработчик фатальных ошибок PHP. Который в дальнейшем поможет нам обеспечить и другие возможности создаваемого механизма, такие как сохранение логов и отправка сообщений по email.

Создание страницы 500
Перехват и обработка фатальных ошибок PHP
Буферизация вывода в PHP
Дополнение файла .htaccess
Проверка работы сайта при внутренней ошибке сервера
Исходные файлы сайта

Создание страницы 500

В первую очередь создадим в корне сайта новый файл с соответствующим именем, например «page_500.php». И поместим в него код страницы, которая будет отображаться при возникновении ошибки 500. А выполним это аналогично тому, как мы это делали в предыдущей статье при создании страницы 404.

Правда, сделаем это с некоторым отличием, заключающимся в том, что в этот раз при ее формировании будем использовать только разметку HTML, исключая какое-либо использование PHP.

Ведь не логично применять фрагменты кода, которые в случае возникновения фатальной ошибки PHP могут повлиять на отправку страницы, предназначенную, как раз, для обработки таких нестандартных ситуаций.

Конечно, это не относится к применению функции header(), с помощью которой отправляется HTTP заголовок с кодом 500, соответствующий внутренней ошибки сервера (строка 2 в приведенном ниже коде).

kak-vyvesti-stranicu-oshibki-500_1

Рис.1 Файл «page_500.php» с HTML-кодом страницы 500

Как видно, данный вариант по структуре полностью соответствует предыдущей странице 404, но выполнен на чистом HTML. Причем все общие блоки: шапка, меню, основное содержание и футер включены непосредственно, без применения подключающих инструкций PHP.

Что касается оформления, то в данном случае этого не требуется, так HTML-код страницы мало чем отличается от предыдущей. И как следствие, все необходимые свойства уже ранее назначены и добавлены в таблицу стилей CSS.

И в этом можно убедиться, если сейчас открыть созданную страницу через адресную строку браузера, добавив к доменному имени ее адрес /page_500.php. Как и в предыдущем случае в начале сделаем это в обычном, десктопном варианте пользовательского устройства.

Рис.2 Вид созданной страницы 500

А теперь посмотрим как это будет выглядеть при малом разрешении экрана в одно колоночном исполнении.

Рис.3 Вид страницы 500 при малом разрешении экрана

Как видно, полученная страница по форме схожа с предыдущей 404. За исключением содержания, отражающего теперь информацию о возникновении внутренней ошибки сервера, соответствующей статусу 500 протокола HTTP.

Таким образом необходимая страница создана. И теперь осталось только обеспечить на нее перенаправление.

Перехват и обработка фатальных ошибок PHP

Как ранее отмечалось, внутренняя ошибка сервера наиболее часто возникает в следствии фатальных ошибок PHP. Причем такие случаи обычно сопровождаются остановкой скрипта. Отчего идентифицировать такую ошибку с помощью того же самого скрипта не получится. Так как в этом случае выполнение в нем каких-либо последующих действий не представляется возможным.

Как вариант решения этой проблемы — применение встроенной функции обратного вызова register_shutdown_function(), предназначенной для регистрации специальной пользовательской функции, не связанной с работой скрипта. И, следовательно, способной выполнить дальнейшие преобразования, несмотря на то, что сам скрипт остановлен.

И таким образом, в случае возникновения фатальной ошибки управление передается этой зарегистрированной функции, являющейся в данном случае обработчиком.

Как может выглядеть регистрация пользовательской функции и перехват в ней последней ошибки, остановившей работу скрипта, показано в следующем фрагменте PHP-кода.

//—-Перехват и обработка фатальных ошибок PHP—-
function fatal_php(){ //Пользовательская функция
$error = error_get_last(); //Получение информации о последней произошедшей ошибке
if ($error !== NULL && in_array($error[‘type’], array(E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR))){ //Если ошибка произошла и ее тип соответствует фатальной ошибке
$domen = ‘http://’.$_SERVER[‘SERVER_NAME’]; //Домен сайта
header(«Location: $domen/page_500.php»); //Редирект на страницу 500
exit; //Прекращение выполнения текущего скрипта
}
}
register_shutdown_function(‘fatal_php’); //Регистрация пользовательской функции обработчика фатальных ошибок PHP
?>

Рис.4 Перехват и обработка фатальных ошибок PHP

Здесь все строки кода сопровождаются комментариями, поэтому подробно описывать каждую из них, нет смысла.

Можно лишь отметить, что регистрация пользовательской функции выполняется, как ранее было отмечено, с помощью register_shutdown_function(), расположенной в строке 11.

А сама функция обработчика с именем fatal_php() (поз.3÷10) в начале возвращает ассоциативный массив с описанием последней произошедшей ошибки (функция error_get_last() поз.4). А затем в случае, если выявленная ошибка относится к одному из четырех необходимых типов (E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR), то с помощью функции отправки HTTP-заголовка header() (поз.7) выполняется редирект по указанному аргументом «Location» адресу, соответствующему странице 500.

В случае, если фатальная ошибка PHP возникает в процессе формирования тела страницы при отправленном HTTP-заголовке, то при установках по умолчанию, в соответствии с протоколом HTTP должна возникнуть ошибка Cannot modify header information — headers already sent by (), означающая невозможность изменения заголовка после его отправки. Более подробно об этом и о том, как решить эту проблему мы посмотрим в следующем разделе статьи.

Таким образом при использовании созданной пользовательской функции, в случае, если из-за какой-то критической ошибки PHP-скрипт остановлен, обработчик ее обнаружит и выполнит необходимые действия по ее идентификации и дальнейшей обработке.

В данном случае обработка заключается всего лишь в выполнении редиректа на страницу 500. Но в дальнейшем, когда мы перейдем к сохранению логов и оправке сообщений по email, то здесь же будем использовать и другие, необходимые для этого преобразования.

И последнее, на что необходимо обратить внимание, функция обработчика должна быть расположена в самом начале кода шаблона главной страницы файла index.php. Иными словами, чтобы все остальные PHP-инструкции, используемые при формировании веб-страницы, выполнялись только после ее регистрации. В противном случае при остановке скрипта обработчик не будет вызван и, соответственно, не сможет выполнить свою задачу.

Буферизация вывода в PHP

В созданном обработчике фатальных ошибок PHP (рис.2) с помощью функции HTTP-заголовка header() (поз.7) предусматривается редирект на страницу 500.

Однако, здесь следует учесть одно обстоятельство, а именно: в случае редиректа, выполняемого в момент формирования тела веб-страницы, уже после отправки HTTP-заголовка, непременно должна последовать ошибка Cannot modify header information — headers already sent by ().

Обусловлено это следующим. По умолчанию сервер отправляет в браузер данные веб-страницы по мере их готовности, в процессе выполнения PHP-скрипта. При этом в соответствии с протоколом HTTP, сервер в ответ на запрос должен в первую очередь отправить служебные заголовки, а уж только потом код самого тела страницы. И протоколом HTTP не допускается ситуация, когда в момент передачи тела страницы производится повторная оправка HTTP-заголовка. О чем и говорит описание вышеуказанной ошибки.

В подтверждение этому можно проверить работу созданного обработчика по состоянию на данный момент, с заведомо внесенной критической ошибкой PHP.

На скриншоте показан вариант вывода страницы «Получить скидку», у которой в код PHP файла poluchit-skidku.php специально внесена синтаксическая ошибка.

Рис.5 Ошибка при изменении заголовка после его отправки

Как видно, здесь в области основного содержания, при обнаружении в ней фатальной ошибки Parse error и остановки скрипта, присутствует также и ошибка Cannot modify header information — headers already sent by (), означающая невозможность изменения заголовка в момент передачи кода данного блока веб-страницы.

А для того, чтобы решить эту проблему и иметь возможность изменять в любой момент HTTP-заголовки, применяется, так называемая буферизация вывода в PHP.

Суть ее в том, что в этом случае при выполнении PHP, сервер не оправляет страницу по мере ее готовности, а складывает полученный код в определенный буфер, параллельно формируя HTTP-заголовки, которые в обычном режиме не допускается оправлять в момент передачи тела страницы.

И только после того, как скрипт выполнит все заложенные в него операции, то всё, что в конечном итоге оказалось в буфере, разом отправляется в браузер пользователя в правильном порядке, как это определенно протоколом HTTP — сначала заголовки, а уж потом страница, сформированная скриптом.

В PHP существуют несколько функций, предназначенных для работы с буфером. Но для данной задачи мы будем использовать только две из них ob_start() — для включения буферизации вывода и ob_end_flush() — для отправки данных из буфера и отключения буферизации.

Схематично для генерируемой HTML-страницы это можно представить следующим образом.

kak-vyvesti-stranicu-oshibki-500_2

Рис.6 Буферизация вывода в PHP

А ниже показано, как в итоге будет выглядеть код шаблона главной страницы в файле index.php после дополнения его обработчиком фатальных ошибок PHP и элементами буферизации вывода PHP (светлым фоном обозначены дополнительные фрагмента кода).

kak-vyvesti-stranicu-oshibki-500_3

Рис.7 Файл index.php с обработчиком ошибок и буферизацией вывода

Следует отметить, что для оптимизации файла index.php, ранее размещенный в начале шаблона главной страницы PHP-код, предназначенный для получения данных при формировании динамической страницы, перенесен в файл start.php, который подключается соответствующей инструкцией в строке 13.

Таким образом буферизацию вывода HTML-страницы, генерированной скриптом PHP, мы выполнили. Однако, для полноценной работы сайта при обработке ошибки 500 необходимо сделать еще одно небольшое дополнение, которые мы сейчас и рассмотрим.

Дополнение файла .htaccess

Приведенные выше преобразования предназначены для выполнения редиректа на страницу 500 в случае прерывания работы скрипта при фатальных ошибках PHP.

Но для того, чтобы это происходило и в других случаях внутренней ошибки сервера, необходимо в файл .htaccess добавить директиву ErrorDocument, аналогичную той, которую мы использовали ранее при редиректе на страницу 404. Только теперь в ней должен быть указан соответствующий адрес /page_500.php.

А заодно, в целях безопасности полезно будет вообще отключить отображение системных сообщений на экране пользователя. Так как теперь возникающие по каким-либо причинам ошибки будут фиксироваться собственным механизмом обработки ошибок и нет необходимости их выводить в браузер. Тем более, что в определенных случаях такая излишняя для пользователя информация может быть использована недоброжелателями в качестве уязвимости сайта.

В итоге файл .htaccess следует дополнить следующими директивами, которые обеспечат выполнение вышеперечисленных действий.

ErrorDocument 500 /page_500.php
php_flag display_errors 0

Рис.8 Редирект 500 в файле .htaccess

Таким образом мы сделали все необходимые преобразования для вывода страницы 500. И теперь можно проверить, как это в реальности будет работать.

Проверка работы сайта при внутренней ошибке сервера

Проверку обработки внутренней ошибки сервера выполним на примере возникновения фатальной ошибки PHP, что позволит удостовериться в корректной работе, как созданного обработчики фатальных ошибок, так и процесса буферизации вывода генерируемой страницы и редиректа на страницу 500.

Для этого в код PHP временно внесем ту же самую синтаксическую ошибку, которую ранее мы делали на промежуточном этапе (рис.5). И посмотрим, как теперь будет обработана такая ситуация.

Рис.9 Вывод страницы 500 при фатальной ошибке PHP

Как видно, теперь критическая ошибка отработана должным образом, с перенаправлением на страницу ошибки 500.

При желании, можно проверить работу сайта и при других искусственно созданных фатальных ошибках. И во всех случаях результат должен быть один — отображение собственной страницы 500. Что в итоге и требовалось получить.

В следующей статье мы создадим механизм обработки не фатальных ошибок PHP, где с помощью собственного обработчика будет обеспечиваться их перехват и сохранение сообщений в соответствующем журнале.

Исходные файлы сайта

Исходные файлы сайта с обновлениями, которые были сделаны в данной статье, можно скачать из прилагаемых дополнительных материалов:

Файлы каталога www
Таблицы базы данных MySQL

Дополнительные материалы бесплатно предоставляются только зарегистрированным пользователям.

Для скачивания исходных файлов необходимо авторизоваться под своим аккаунтом через соответствующую форму.

Для тех кто не зарегистрирован, можно это сделать на вкладке Регистрация.

С уважением,

Следующая сатья: Перехват и обработка не фатальных ошибок PHP

Если у Вас возникли вопросы, или есть какие-либо пожелания по представлению материала, либо заметили какие-нибудь ошибки, а быть может просто хотите выразить свое мнение, пожалуйста, оставьте свои комментарии. Такая обратная связь очень важна для возможности учета мнения посетителей.

Буду Вам за это очень признателен!

Источник

<?php /* 参考自： http://darklaunch.com/2010/09/01/http-status-codes-in-php-http-header-response-code-function http://snipplr.com/view/68099/ */ function HTTPStatus($num) { $http = array( 100 => ‘HTTP/1.1 100 Continue’, 101 => ‘HTTP/1.1 101 Switching Protocols’, 200 => ‘HTTP/1.1 200 OK’, 201 => ‘HTTP/1.1 201 Created’, 202 => ‘HTTP/1.1 202 Accepted’, 203 => ‘HTTP/1.1 203 Non-Authoritative Information’, 204 => ‘HTTP/1.1 204 No Content’, 205 => ‘HTTP/1.1 205 Reset Content’, 206 => ‘HTTP/1.1 206 Partial Content’, 300 => ‘HTTP/1.1 300 Multiple Choices’, 301 => ‘HTTP/1.1 301 Moved Permanently’, 302 => ‘HTTP/1.1 302 Found’, 303 => ‘HTTP/1.1 303 See Other’, 304 => ‘HTTP/1.1 304 Not Modified’, 305 => ‘HTTP/1.1 305 Use Proxy’, 307 => ‘HTTP/1.1 307 Temporary Redirect’, 400 => ‘HTTP/1.1 400 Bad Request’, 401 => ‘HTTP/1.1 401 Unauthorized’, 402 => ‘HTTP/1.1 402 Payment Required’, 403 => ‘HTTP/1.1 403 Forbidden’, 404 => ‘HTTP/1.1 404 Not Found’, 405 => ‘HTTP/1.1 405 Method Not Allowed’, 406 => ‘HTTP/1.1 406 Not Acceptable’, 407 => ‘HTTP/1.1 407 Proxy Authentication Required’, 408 => ‘HTTP/1.1 408 Request Time-out’, 409 => ‘HTTP/1.1 409 Conflict’, 410 => ‘HTTP/1.1 410 Gone’, 411 => ‘HTTP/1.1 411 Length Required’, 412 => ‘HTTP/1.1 412 Precondition Failed’, 413 => ‘HTTP/1.1 413 Request Entity Too Large’, 414 => ‘HTTP/1.1 414 Request-URI Too Large’, 415 => ‘HTTP/1.1 415 Unsupported Media Type’, 416 => ‘HTTP/1.1 416 Requested Range Not Satisfiable’, 417 => ‘HTTP/1.1 417 Expectation Failed’, 500 => ‘HTTP/1.1 500 Internal Server Error’, 501 => ‘HTTP/1.1 501 Not Implemented’, 502 => ‘HTTP/1.1 502 Bad Gateway’, 503 => ‘HTTP/1.1 503 Service Unavailable’, 504 => ‘HTTP/1.1 504 Gateway Time-out’, 505 => ‘HTTP/1.1 505 HTTP Version Not Supported’, ); header($http[$num]); return array( ‘code’ => $num, ‘error’ => $http[$num], ); } ///////////////////////////////////////////////////////////////////////// // HTTP HEADER STATUS CODES header(‘HTTP/1.1 200 OK’); header(‘HTTP/1.1 404 Not Found’); header(‘HTTP/1.1 403 Forbidden’); header(‘HTTP/1.1 301 Moved Permanently’); header(‘HTTP/1.1 304 Not Modified’); header(‘HTTP/1.1 500 Internal Server Error’); header(‘Location: http://www.example.org/’); header(‘Refresh: 10; url=http://www.example.org/’); print ‘You will be redirected in 10 seconds’; // you can also use the HTML syntax: // <meta http-equiv=»refresh» content=»10;http://www.example.org/ /> // override X-Powered-By value header(‘X-Powered-By: PHP/4.4.0’); // content language (en = English) header(‘Content-language: en’); // last modified (对缓存友好) $time = time() — 60; // or filemtime($fn), etc header(‘Last-Modified: ‘.gmdate(‘D, d M Y H:i:s’, $time).‘ GMT’); // set content length (对缓存友好): header(‘Content-Length: 1234’); // Headers for an download: header(‘Content-Type: application/octet-stream’); header(‘Content-Disposition: attachment; filename=»example.zip»‘); header(‘Content-Transfer-Encoding: binary’); // load the file to send: readfile(‘example.zip’); // Disable caching of the current document: header(‘Cache-Control: no-cache, no-store, max-age=0, must-revalidate’); header(‘Expires: Mon, 26 Jul 1997 05:00:00 GMT’); // Date in the past header(‘Pragma: no-cache’); // set content type: header(‘Content-Type: text/html; charset=iso-8859-1’); header(‘Content-Type: text/html; charset=utf-8’); header(‘Content-Type: text/plain’); // plain text file header(‘Content-Type: image/jpeg’); // JPG picture header(‘Content-Type: application/zip’); // ZIP file header(‘Content-Type: application/pdf’); // PDF file header(‘Content-Type: audio/mpeg’); // Audio MPEG (MP3,…) file header(‘Content-Type: application/x-shockwave-flash’); // Flash animation // show sign in box header(‘HTTP/1.1 401 Unauthorized’); header(‘WWW-Authenticate: Basic realm=»Top Secret»‘); print ‘Text that will be displayed if the user hits cancel or enters wrong login data’;

Источник

http_response_code

Description

Parameters

Return Values

Examples

See Also

User Contributed Notes 18 notes

Description

Parameters

Return Values

Examples

See Also

Edit

Answer

Solution:

Answer

Solution:

Answer

Solution:

Answer

Solution:

Answer

Solution:

Answer

Solution:

Share solution ↓

Additional Information:

Didn’t find the answer?

Similar questions

Write quick answer

About the technologies asked in this question

PHP

MySQL

HTML

Welcome to programmierfrage.com

Get answers to specific questions

Help Others Solve Their Issues

Как изменить код ответа сервера.

Страница выполнена корректно

Запрашиваемая страница не найдена

Доступ запрещен:

Страница перемещена навсегда.

Сервер выполнил скрипт с ошибкой

Если требуется перенаправить на другой url

Перенаправление на указанный адресу

Перенаправление на указанный адрес с задержкой в 5 секунд

Заголовки кодировки и языка

Содержимое страницы использует язык:

Как поменять кодировку

Модификация заголовков для управления контентом

Установка content type

Иные манипуляции с заголовками

Содержимое страницы последний раз изменялось

Длинна содержимого страницы

Отключение кеширования страницы:

Создание страницы 500

Перехват и обработка фатальных ошибок PHP

Буферизация вывода в PHP

Дополнение файла .htaccess

Проверка работы сайта при внутренней ошибке сервера

Исходные файлы сайта

Читайте также: