mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-10-22 14:05:37 +02:00
Merge pull request #7352 from open-sausages/pulls/4.0/safer-perms
DOCS Update documentation / upgrading for file permissions
This commit is contained in:
commit
a764488403
@ -84,6 +84,34 @@ needs to create/have write-access to:
|
||||
* After the install, the assets directory is the only directory that needs write access.
|
||||
* Image thumbnails will not show in the CMS if permission is not given
|
||||
|
||||
If you are running on a server instance where users other than the webserver user will need
|
||||
read / write access to files in the assets folder, then you will need to adjust the
|
||||
permissions of the filesystem to a more permissive setting.
|
||||
|
||||
By default private files and `.htaccess` are written with permission `0600`.
|
||||
You could enable other users to access these files with the below config.
|
||||
Note: Please adjust the values below to those appropriate for your server configuration:
|
||||
|
||||
*mysite/_config/assetperms.yml*
|
||||
|
||||
```yaml
|
||||
---
|
||||
Name: myassetperms
|
||||
---
|
||||
SilverStripe\Assets\Flysystem\AssetAdapter:
|
||||
file_permissions:
|
||||
file:
|
||||
public: 0644
|
||||
private: 0644
|
||||
dir:
|
||||
public: 0755
|
||||
private: 0755
|
||||
```
|
||||
|
||||
For more information on understanding and determining file permissions, please see
|
||||
[wikipedia](https://en.wikipedia.org/wiki/File_system_permissions#Traditional_Unix_permissions)
|
||||
on unix permissions.
|
||||
|
||||
## I have whitespace before my HTML output, triggering quirks mode or preventing cookies from being set
|
||||
|
||||
SilverStripe only uses class declarations in PHP files, and doesn't output any content
|
||||
|
@ -808,6 +808,10 @@ SilverStripe\Filesystem\Flysystem\FlysystemAssetStore:
|
||||
|
||||
See our ["File Management" guide](/developer_guides/files/file_management) for more information.
|
||||
|
||||
Depending on your server configuration, it may also be necessary to adjust your assets folder
|
||||
permissions. Please see the [common installation problems](/getting_started/installation/common_problems)
|
||||
guide for configuration instruction.
|
||||
|
||||
#### Migrating File DataObject from 3.x to 4.0
|
||||
|
||||
Since the structure of `File` dataobjects has changed, a new task `MigrateFileTask` has been added to assist
|
||||
@ -1171,6 +1175,10 @@ standard SilverStripe templates on flush. These templates include:
|
||||
You will need to make sure that these files are writable via the web server, and that any necessary
|
||||
configuration customisation is done via overriding these templates.
|
||||
|
||||
Depending on your server configuration, it may also be necessary to adjust your assets folder
|
||||
permissions. Please see the [common installation problems](/getting_started/installation/common_problems)
|
||||
guide for configuration instruction.
|
||||
|
||||
If upgrading from an existing installation, make sure to invoke `?flush=all` at least once.
|
||||
|
||||
See our ["File Security" guide](/developer_guides/files/file_security) for more information.
|
||||
|
Loading…
Reference in New Issue
Block a user