|  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #52835 readfile sample allows directory download
Submitted: 2010-09-14 10:29 UTC Modified: 2010-09-15 19:58 UTC
From: kittya at breyfamily dot net Assigned: aharvey (profile)
Status: Wont fix Package: Documentation problem
PHP Version: 5.3.3 OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Anyone can comment on a bug. Have a simpler test case? Does it work for you on a different platform? Let us know!
Just going to say 'Me too!'? Don't clutter the database with that please — but make sure to vote on the bug!
Your email address:
Solve the problem:
21 + 25 = ?
Subscribe to this entry?

 [2010-09-14 10:29 UTC] kittya at breyfamily dot net
For the readfile function, sample 1, "Forcing a download using readfile()" uses file_exists to check whether $file is valid. However, if there is a directory by the name of $file, the sample code causes PHP to try to download the directory, which will likely be meaningless to the client.

Expected result:
The sample should use is_file.

Actual result:
The sample currently uses file_exists.


Add a Patch

Pull Requests

Add a Pull Request


AllCommentsChangesGit/SVN commitsRelated reports
 [2010-09-14 12:25 UTC]
-Status: Open +Status: Assigned -Assigned To: +Assigned To: aharvey
 [2010-09-14 12:35 UTC]
-Status: Assigned +Status: Wont fix
 [2010-09-14 12:35 UTC]
Actually, on second thoughts, I'm going to leave this as it is. It's an obviously contrived example and is_file() isn't necessarily sufficient anyway, since it doesn't cover links and special files.

Closing won't fix.
 [2010-09-15 01:26 UTC] kittya at breyfamily dot net
The example may not be so contrived after all. I found the example when I was looking for code to do just what the example does. Before submitting the documentation problem report, I used the example almost verbatim in a project:
I noticed the problem when performing security testing.

There are more elegant solutions with rewrites, but the approach in the example is simple and very portable.

Regarding is_file, perhaps links and special files cases will be OK. If links would be followed, and the stream from special files would be read, that would be appropriate in most scenarios.
 [2010-09-15 05:27 UTC]
Don't get me wrong, it's certainly possible to make the example work with links and special files as well.

My concern is that we're then complicating an example that's specifically demonstrating the usage of readfile() with a Content-Disposition header -- down to having an explicit line at the top defining $file as something that's obviously the name of a file, not a directory. I just think any potential change would only make the intent of the example less clear than it already is.
 [2010-09-15 19:58 UTC] kittya at breyfamily dot net
I see what you mean about the hard coded file name being contrived. Still, taking the example at face value, it's saying if you put a file in some exact location on the server, this code will let you download it. Hence the example checks that the file really exists. I don't think it muddies the intent for the example to also check that what lives at the location is really a file.

Since it doesn't add any complexity to the example, I would get as close as you can to demonstrating best practice.
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Mon Jun 17 13:01:29 2024 UTC