Specification of the HTTP status code 417

The 417 Expectation Failed status code indicates that the expectation given in the request's Expect header field (Section 5.1.1) could not be met by at least one of the inbound servers.

Source / Quote by: The 417 Expectation Failed HTTP Status Code is specified by section 6.5.14 of RFC7231.

HTTP-Protocol

HTTP/1.1 (1999)

HTTP/2 (2022)

HTTP/3 (2022)

How to throw a 417 statuscode with PHP?

To throw the HTTP status code 417 on a web page, the PHP function http_response_code can be used. The syntax is as follows: http_response_code(417) (PHP 5 >= 5.4.0, PHP 7, PHP 8)

Test the 417 HTTP status code

http-statuscode.com (Test Status code 417)

httpstat.us (Test Status code 417)

In order to be able to display the HTTP status code (in this case 417 Expectation Failed) and other information on the client side, the development console must be opened with F12. Afterwards you have to navigate to the tab "Network". Now you can open the page, in the network tab you should see the web page (example index.php). This must be selected and then the Herder section must be selected. Here the user will see the following result:

Overview
URL: https://http-statuscode.com/errorCodeExample.php?code=417
Status: 417 Expectation Failed
Those: Network
IP address: XX.XX.XX.XX

How to create a custom error page for the 417 status code

Creating your own 417 Expectation Failed error page is relatively easy with the web server "Apache" as well as with the web server "NGINX".

Apache Webserver

The web server "Apache" is one of the most popular web servers on the Internet. To create an own 417 Expectation Failed error page in "Apache", the following change must be made in the following file.

File: .htaccess

ErrorDocument 417 /errors/417.html

NGINX Webserver

Similar to the web server "Apache", "NGINX" is also widely used on the Internet. To create your own 417 Expectation Failed error page in "NGINX", the following change must be made in the following file.

File: sites-enabled/default

error_page 417 /417.html;
location = /417.html {
root /usr/share/nginx/html;
internal;
}

Browser compatibility of the 417 status code

Chrome	no data
Edge	no data
Firefox	no data
Opera	no data
Safari	no data
Chrome Android	no data
Firefox for Android	no data
Opera Android	no data
Safari on iOS	no data
Internet	no data
WebView Android	no data