php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Request #77372 Relative file path is removed from uploaded file
Submitted: 2018-12-29 22:49 UTC Modified: 2019-01-03 11:32 UTC
From: nospam at unclassified dot de Assigned:
Status: Closed Package: *Directory/Filesystem functions
PHP Version: 7.0.33 OS: Windows 10
Private report: No CVE-ID: None
View 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 !
Your email address:
MUST BE VALID
Solve the problem:
50 - 7 = ?
Subscribe to this entry?

 
 [2018-12-29 22:49 UTC] nospam at unclassified dot de 
Description:
------------
<input type="file" name="files" multiple webkitdirectory>

This allows the user to select a directory and have all its files uploaded, also from all subdirectories. In Firefox, the POST request correctly contains the relative paths of all uploaded files. In PHP, the paths are removed and only the file names are available.

$_FILES['files']['name'][...]:

Actual value: 'file.png'
Expected value: 'sub/dir/file.png'

This makes the entire directory uploading feature unusable because the structure gets lost and file names may even become duplicate and useless.

Note, I have searches for "upload webkitdirectory" but only got tons of unrelated results, so I might have missed a real duplicate. Please improve your search if you want to avoid duplicates.

Test script:
---------------
See above.

Expected result:
----------------
See above.

Actual result:
--------------
See above.

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2019-01-02 17:39 UTC] cmb@php.net 
Hmm, the webkitdirectory attribute[1] is part of the “File and
Directory Entries API” which is a very recent *draft*, so I
wouldn't assess non-compliance with this feature a bug in PHP per
se.

Anyhow, the relevant code[2] that causes this behavior is due to a
quirk of IE, namely that even recent versions of IE 11 allow to
“Include local directory path when uploading files to a server”.
However, while the code originally just catered to backslashes
(like the comment still indicates), it has been replaced with a
more general _basename()[3] which also caters to (forward)
slashes.  So, at the very least, the comment is wrong.

[1] <https://wicg.github.io/entries-api/#dom-htmlinputelement-webkitdirectory>
[2] <https://github.com/php/php-src/blob/php-7.3.0/main/rfc1867.c#L1149-L1154>
[3] <http://github.com/php/php-src/commit/cdb9ee0d1a5ecb843b320c9effb81207f4280795>
 [2019-01-02 18:09 UTC] requinix@php.net
-Type: Bug +Type: Feature/Change Request
 [2019-01-02 18:09 UTC] requinix@php.net 
There's no way PHP could know whether it should keep or remove any directory portion of the original filename, and there is far too much code out there that trusts the name to be a basename. The only method I see for this is to introduce another array entry for the whole path - the value submitted by the client, unchanged. Like "original_name" or something. That should be a relatively minor change for PHP and it shouldn't impact any existing code.

Browser support is a bit contradictory:
https://caniuse.com/#search=webkitdirectory
https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/webkitdirectory#Browser_compatibility
 [2019-01-03 11:32 UTC] nospam at unclassified dot de 
I wouldn't call the browser support contradictory. Every current desktop browser supports this feature for a few versions already. 95% of all desktop users should be able to use it today. IE is not current and about to die. The concept of uploading large amounts of files probably doesn't fit into mobile devices anyway so I don't consider it a problem when these platforms don't support it.

The thing is, the HTTP request does contain that information about the provided path. PHP just drops it. And when the PHP manual contains code examples that suggest applying `basename` on the file name, I was assuming that it isn't basename'd already and browsers may or may not send a path there and I must remove it when I don't need it (or my code isn't prepared to validate it). I might need to go down and parse the HTTP request myself in PHP to extract the required information.
 [2021-04-26 16:19 UTC] bugs dot php dot net at s dot bjoern-tantau dot de 
You could use #74611 as a workaround and parse the upload yourself, using php://input.
 [2021-05-14 09:43 UTC] git@php.net 
Automatic comment on behalf of bjoern-tantau (author) and web-flow (committer)
Revision: https://github.com/php/php-src/commit/d764f1dc12a1778d0c82c474430cb1da16038473
Log: Fix #77372: Retain full path of files for directory uploads (#6917)
 [2021-05-14 09:43 UTC] git@php.net
-Status: Open +Status: Closed
 [2022-01-06 07:42 UTC] Poortmansimon at defensie dot world 
HER MAJESTY SIMON POORTMAN STATE V. GENERAL BONDKANSELIER.
HIS MAJESTY THE KING OF THE BELGIANS, THE PRESIDENT OF THE FEDERAL REPUBLIC OF GERMANY, THE PRESIDENT OF THE FRENCH REPUBLIC, THE PRESIDENT OF THE ITALIAN REPUBLIC, HIS ROYAL HIGHNESS THE GRAND DUKE OF LUXEMBOURG, HIS MAJESTY THE KING OF THE NETHERLANDS.
KING OFF THE EUROPEAN REPUBLIC COMMUNITY.
KING OF THE WORLD.

Name : Simon Poortman
Job:              Generaal V. Bondchancellor 

Adres:           Ministerlaan 44 8014PK Zwolle Netherlands 

E-mail:         Poortmansimon@defensie.world

Telephone:  +31610325665

Bank account: IBAN: NL40RABO 0119769794 BIC: RABONL2U 

Adres:         Ministerlaan 44 8014PK Zwolle Netherlands
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved. 		Last updated: Tue Jul 01 00:01:36 2025 UTC