tonyair/silverstripe-framework
1
0
Fork 0
mirror of https://github.com/silverstripe/silverstripe-framework synced 2024-10-22 12:05:37 +00:00
Code Issues Projects Releases Wiki Activity

Merge pull request #7593 from open-sausages/pulls/4.0/better-perms-docs

Browse Source 
DOC Improve file permission docs
This commit is contained in:
Chris Joe 2017-11-15 11:44:51 +13:00 committed by GitHub
commit 5077eb8125
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/en/00_Getting_Started/01_Installation/05_Common_Problems.md
View File

@ -87,10 +87,21 @@ needs to create/have write-access to:
* Image thumbnails will not show in the CMS if permission is not given * 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 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 read / write access to files in the assets folder, then you should do one of the below:
permissions of the filesystem to a more permissive setting.
By default private files and `.htaccess` are written with permission `0644`. - Ensure that all server users that modify this file belong to the same group
- Modify the permissions that SilverStripe uses to write to a more permissive setting (see below)
It may be necessary to manually set the original permissions, and owner user/group of your assets folder on
initial deployment.
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.
### Modifying write permissions of files
By default all files and `.htaccess` are written with permission `0664`.
You could enable other users to access these files with the below config. 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. Note: Please adjust the values below to those appropriate for your server configuration.
You may require `0666` for combined files generated during requests where they are cleared or refreshed only during a flush. You may require `0666` for combined files generated during requests where they are cleared or refreshed only during a flush.
@ -104,16 +115,13 @@ Name: myassetperms
SilverStripe\Assets\Flysystem\AssetAdapter: SilverStripe\Assets\Flysystem\AssetAdapter:
file_permissions: file_permissions:
file: file:
public: 0644 public: 0666 # Replace with your desired permission for files
private: 0644
dir: dir:
public: 0755 public: 0777 # Replace with your desired permission for folders
private: 0755
``` ```
For more information on understanding and determining file permissions, please see Note: `public` key applies to all files whether they are protected or public; This is a flag internal to
[wikipedia](https://en.wikipedia.org/wiki/File_system_permissions#Traditional_Unix_permissions) Flysystem, and file protection is applied by SilverStripe on top of these permissions.
on unix permissions.
## I have whitespace before my HTML output, triggering quirks mode or preventing cookies from being set ## I have whitespace before my HTML output, triggering quirks mode or preventing cookies from being set