Uploading Files in Windows
Probably fixed in 3.0.0-rc.2+
It is likely this issue has been resolved in Lando
3.0.0-rc.2 but let's keep these docs around for awhile just in case
When uploading files via PHP and potentially other things in Lando on Windows you may see an error like the following:
The upload directory private://TESTDIR for the file field field_TESTFIELD could not be created or is not accessible. A newly uploaded file could not be saved in this directory as a consequence, and the upload was canceled.
php will incorrectly assume a writable directory mounted by Docker Desktop is in fact not writable.
This seems to be caused by a convergence of two factors:
- How Docker Desktop uses
SMBto mount files
- How the built in php function
This comment while Drupal in flavor is helpful for a deeper dive on things.
If you are interested in replicating the issue yourself you should be able to do something like:
lando starta Drupal flavored app you have
- Log in as an admin
- Spin up a content type that has an image field
- Create a new piece of content for that content type
- Add a first image (this should succeed)
- Add a second image (this should fail)
The Drupal core
includes/file.inc file contains a function
file_prepare_directory. This function is called on each file upload. If the upload is in a directory that does not yet exist, the directory is created, its writability is assumed and the upload succeeds. However, if a file upload is done in a directory that already exists then php's built-in function
is_writable is used. This will fail for non-root users.
Using nginx (recommended)
php instance as the
root user seems to allow
is_writable to function as expected and alleviates the issue described above. As of
beta.38 Lando will run
root on Windows by default since this has no other known negative side effects.
If you are experiencing this issue we recommend you upgrade to
beta.38+ and make sure your Lando app is using
nginx instead of
root is currently not supported. See this issue if you are interested in trying to get Docker to support
apache as this would provide full out-of-the-box coverage for this issue.
Patching Your Code
If switching to
nginx is not an option then it's possible the framework you are using (eg Drupal or Laravel) may have already identified this issue and supplied a patch to help. For example this may be relevant for Drupal 7.
A Google search for
Docker Desktop file sharing MYFRAMEWORK is probably a good way to start.