One of the most annoying things on the Internet for me is when I click on a link to an Adobe PDF file. For me this is annoying to the extreme because the PDF file is openened directly in your browser because of the Adobe PDF Plugin that almost all browsers have installed. If the PDF is multi-page or a larger file my browser takes forever to load and render the PDF and sometimes even freezes!
The solution I came up with is really nice, and will work for all .pdf files on your entire site, without having to change any links. It is a secure and robust solution to my pet peeve. Feel free to add any ideas or improvements using the comment form below.
Serving PDF files for Visitor Satisfaction
For me an ideal solution would be to offer me choices, such as giving me the option to:
- Open in an external program that I can choose, such as Acrobat
- Save the file on my computer without having to open it.
PDF Before and after Fix - Firefox
PDF Before and after Fix - Internet Explorer
Because serving PDF files with the above options would make me happy as a visitor, I want to offer those options to visitors on my site. Here is how I do it.
.htaccess pdf rewrite example
This .htaccess mod_rewrite code goes in your sites root .htaccess file and uses a RewriteCond to make sure that the file exists, it then rewrites the request internally to the /cgi-bin/pdf.php file while adding the PDF filename as a http GET variable called file.
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} -f
RewriteRule ^(.+)\.pdf$ /cgi-bin/pdf.php?file=$1 [L,NC,QSA]
php pdf output example
This php code is simple yet sophisticated, it simply locates the pdf file requested using the GET variable called file and then sends the pdf file directly to the clients browser, adding some HTTP headers to make a built-in browser dialog window pop-up giving the client the option to open the pdf in an external program or to save the pdf on the clients computer.
<?php
if(!isset($_GET['file']))die('LOGGED! no file specified');
$file_path=$_SERVER['DOCUMENT_ROOT'].'/'.strip_tags(htmlentities($_GET['file'])).'.pdf';
if ($fp = fopen ($file_path, "r")) {
$file_info = pathinfo($file_path);
$file_name = $file_info["basename"];
$file_size = filesize($file_path);
$file_extension = strtolower($file_info["extension"]);
if($file_extension!='pdf') {
die('LOGGED! bad extension');
}
ob_start();
header('Content-type: application/pdf');
header('Content-Disposition: attachment; filename="'.$file_name.'"');
header("Content-length: $file_size");
ob_end_flush();
while(!feof($fp)) {
$file_buffer = fread($fp, 2048);
echo $file_buffer;
}
fclose($fp);
exit;
exit();
} else {
die('LOGGED! bad file '.$file_path);
}
?>
pdf -adobe -header -plugin -acrobat -htaccess -php
Related Articles

12.04.07 at 8:51 am
Why does your site play a song (The Final Countdown I think) without me asking it to? Your article talks about visitor satisfaction - I think you should consider whether this kind of thing is likely to lead to increased satisfaction or intense irritation.
12.04.07 at 2:42 pm
two questions really:
- what’s wrong with simply using one of the standard methods that have been out there for ages to force download?
or just
- if it’s just something that annoys you as an end user, why not simply change it at your end? open up your standalone adobe reader, preferences, internet and untick the “Display PDF in browser” checkbox. for every user hates the default PDF behaviour there is probably another that actually really likes it and would hate this solution.
12.04.07 at 6:39 pm
Not to be a pain in the ass (I really appreciate the article) but reading the starting words “One of the most annoying things on the internet for me…” while a song you never asked to hear is blasting out of your speakers late at night is sort of ironic. And a teeny tiny flash player (set to autoplay) that took me ages to find (”What tab did that? And where on the page?”) and shut off. Autoplaying sounds is a big usability no-no, as far as I and most people I know are concerned. Sorry if I sound grumpy, I was just not ready to rock. :)
12.04.07 at 6:46 pm
Interesting article, thanks for sharing.
I do find the loud intrusive music on this page to be somewhat as irritating as the PDF issue though… sorry.
12.05.07 at 3:25 am
One of the most annoying things on the Internet for me is when I click on a link to a website and it plays music at me. Especially when it’s one of a number of pages I’m opening in a background and I have to go hunting for it. If you’re talking about giving users choice on how to consume content, you might think about your own site.
Otherwise, good article
12.05.07 at 7:05 pm
It doesn’t seem to work quite right if you right-click on the link & save as…which is something I do a lot of the time, if I have a hunch a link is a PDF. Any thoughts? (Because I LOVE the general idea!)
12.09.07 at 6:48 pm
I like this solution; but where does this pdf file go?