{"id":230,"date":"2012-05-29T09:06:02","date_gmt":"2012-05-29T01:06:02","guid":{"rendered":"https:\/\/www.techcoil.com\/blog\/?p=230"},"modified":"2018-09-03T22:13:30","modified_gmt":"2018-09-03T14:13:30","slug":"php-codes-to-tell-browsers-to-open-the-download-dialog-box-for-users-to-download-a-file","status":"publish","type":"post","link":"https:\/\/www.techcoil.com\/blog\/php-codes-to-tell-browsers-to-open-the-download-dialog-box-for-users-to-download-a-file\/","title":{"rendered":"PHP codes to tell browsers to open the download dialog box for users to download a file"},"content":{"rendered":"

Ideally, when we build web applications which generate files on demand, we will want our users to be able to use their browsers to save a copy of our files in their local harddisk. For instance, the tool for generating customized codes for countries in the world<\/a>, which I had created earlier, will tell browsers to prompt a download dialog box after users had submitted the form.<\/p>\n

\"Image<\/p>\n

However, this is not the default behavior of browsers. By default, browsers will show the contents of a HTTP response generated by our PHP script in the browser window. This behaviour can be seen when I point my browser to http:\/\/www.techcoil.com\/robots.txt<\/a>.<\/p>\n

In this post, I will discuss how we can tell browsers to show a dialog box for users to save the contents generated by a PHP script as a file. <\/p>\n

Some information about the HTTP response<\/h3>\n

When our PHP script is executed, it will mean that a HTTP request<\/strong> was sent to our web server<\/a> and that the browser is waiting for a HTTP response<\/strong> from our PHP script. <\/p>\n

A HTTP response has two distinct portions:<\/p>\n

    \n
  1. The meta data portion to tell the browser whether the request is successful, what content to expect, how to deal with the content and etc. Such data had to be sent to the HTTP client before the actual content<\/strong>.<\/li>\n
  2. The contents portion which is what our HTTP client had requested for. This portion can be blank, for example, when a HTTP response with a 404 status code is specified in the meta data section. If not blank, this portion is where our PHP script writes what the HTTP client wants, for example, a HTML document, a photo, a text document and etc.<\/li>\n<\/ol>\n

    Telling browsers to download robots.txt, instead of just opening it right away<\/h3>\n

    Extending from the robot.txt<\/code> example, I will create a separate PHP script on my web server to tell browsers to show their users a download dialog box to download the same robot.txt<\/code> file. <\/p>\n

    \r\n<?php\r\n\/\/ Specify that our robots.txt is text document.\r\nheader('Content-type: plain\/text');\r\n\/\/ Tell browsers to open up the download dialog box to download\r\n\/\/ our robots.txt. In addition, the browser should default the \r\n\/\/ file name to robots.txt\r\nheader('Content-Disposition: attachment; filename="robots.txt"');\r\n\r\n\/\/ Write the contents of robots.txt out to the browser\r\nreadfile(dirname(dirname(__FILE__)) . '\/robots.txt');\r\n?>\r\n<\/pre>\n
    The script consists of three main lines of codes. We first specify some meta data for our browser via the header<\/code><\/a> function:<\/p>\n