如何从PHP脚本发送500 Internal Server Error错误


80

在某些情况下,我需要从PHP脚本发送“ 500 Internal Server Error”。该脚本应该由第三方应用程序调用。该脚本包含一些die("this happend")语句,我需要为它们发送500 Internal Server Error响应代码,而不是通常的语句200 OK。第三方脚本将在某些条件下重新发送请求,包括不接收200 OK响应代码。

问题的第二部分:我需要这样设置我的脚本:

<?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" );
?>

我只需要200在执行完最后一行之后发送标头。

编辑

附带问题:我可以发送500个奇怪的标头,例如:

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

网络服务器会记录此类错误吗?


u发送标头并稍后删除标头时
不可行

1
再说一遍:那完全是合法的。原因短语不适合机器使用,可以是任何东西。仅重要的三位数状态代码。(RFC2616 6.1.1:“此处列出的原因短语仅是建议-可以用本地等效项替换而不会影响协议。”)
Piskvor在

Answers:



44

PHP 5.4具有一个名为http_response_code的函数,因此,如果您使用的是PHP 5.4,则可以执行以下操作:

http_response_code(500);

如果您在5.4以下运行PHP版本,则我已为此功能(Gist)编写了一个polyfill


为了回答您的后续问题,HTTP 1.1 RFC指出:

此处列出的原因短语仅是建议-在不影响协议的情况下,可以将它们替换为本地等效项。

这意味着您可以在代码本身之后使用所需的任何文本(不包括回车符或换行符),它将起作用。通常,尽管如此,通常会使用更好的响应代码。例如,您可以发送404(未找到),而不是使用500(找不到记录),对于“条件失败”(我猜是验证错误)之类的东西,可以发送422(不可处理)之类的东西。实体)。


重要的是要记住,一旦开始输出,此功能也将不再起作用!
rob74

@ rob74 True —一旦PHP开始发送输出,所有与标头相关的功能将不再起作用。如果不确定在开始发送输出之前是否必须更改响应代码,则输出缓冲是一个很好的解决方案。
inxilpro

33

您可以使用以下功能发送状态更改:

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);
    }
}

您可以这样使用它:

<?php
header_status(500);

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

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

update_database();

header_status(200);

21
节省几个字节的内存很少是一种以某种方式编写Web应用程序代码的好理由。
丹·格罗斯曼

1
你不是想念;之后die()吗?
henrywright 2014年

2
您的列表缺失418 =>“我是茶壶”,请参见:en.wikipedia.org/wiki/Hyper_Text_Coffee_Pot_Control_Protocol
Louis Loudog Trottier

16

您可以输入:

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

在您的条件内,例如:

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

至于数据库查询,您可以像这样进行:

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

您应该记住,必须将此代码放在任何html标记(或输出)之前。


11
确保在调用header()之后退出/死亡/返回/某些东西。PHP将继续执行代码-这可能是不希望的。
David Goodwin

8

您可以像这样简化它:

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

它将返回以下标头:

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

补充:如果您需要确切地知道出了什么问题,请执行以下操作:

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');
}

5
现在'x'应该是什么?
Core Xii

1
+1请注意,中的第一个参数header必须是非空字符串。那'x'并不重要。
theazureshadow

1
@Core Xii,@ theazureshadow指出,第一个参数不能为null。简而言之,通过调用标头(“ something”,true,500),将返回正确的标头“ HTTP / 1.0 500 Internal Server Error”。您可能觉得我很懒,但是传递错误代码比处理实际的标头字符串更容易:)请查看php.net/manual/en/function.header.php了解更多详细信息。
大卫·库里扎(DavidKuridža)2010年

手册对此不太清楚。因此,您是说如果强制使用状态代码,PHP会自动将字符串参数覆盖为其正确的值吗?那么,为什么手册会说仅在字符串不为空时才生效?
Core Xii

1
请注意,在某些PHP配置中(我的托管服务提供商用于实例配置,而不是我的本地设置),此技巧不起作用!Apache无法将“ x”识别为正确的标头字符串,并且将因“格式错误的标头”错误而失败。
mjsarfatti

2

您的代码应如下所示:

<?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');
?>

如果发生问题,我假设您停止执行。

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.