Skip to content
This repository was archived by the owner on Nov 19, 2024. It is now read-only.

Commit 9957e63

Browse files
committed
Fix issue #8021 update key value list for web locations
1 parent 24e725a commit 9957e63

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

src/cloud/project/magento-app-properties.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -75,18 +75,20 @@ See [Services]({{ site.baseurl }}/cloud/project/services.html) for a full list o
7575

7676
The `web` property defines how your application is exposed to the web (in HTTP). It determines how the web application serves content— from the front-controller script to a non-static request to an `index.php` file on the root. We support any directory structure so the static file can be in a sub directory, and the `index.php` file can be further down.
7777

78-
You can specify the following attributes for the `web` property:
78+
You can specify the following key values for the `web` property _locations_:
7979

8080
Attribute | Description
8181
--------- | -----------
82+
`allow` | Serve files that do not match a rule. Default value = `true`
83+
`blacklist` | Files that should never be served. Has no effect on static files.
84+
`expires` | The number of seconds to cache `whitelist` content in the browser. This attribute enables the `cache-control` and `expires` headers for static content. If this value is not set, the `expires` directive and resulting headers are not included when serving static content files.
85+
`index` | Static files to serve your application, such as the `index.html` file. This key expects a collection. You must include the static file(s) in the `whitelist` as an index file: `- \.html$`
86+
`passthru` | The URL used in the event that a static file or PHP file cannot be found. Typically, this URL is the front controller for your applications, such as `/index.php` or `/app.php`.
8287
`root` | The path relative to the root of the application that is exposed on the web. Typical values include `/public` and `/web`.
83-
`passthru` | The URL used in the event that a static file or PHP file cannot be found. This URL is typically the front controller for your applications, often `/index.php` or `/app.php`.
84-
`index` | Static files, such as `index.html`, to serve your application. This key expects a collection. You must include the static file(s) in the whitelist as an index file, like `- \.html$`.
85-
`blacklist` | A list of files that should never be executed. Has no effect on static files.
86-
`whitelist` | A list of static files (as regular expressions) that can be served. Dynamic files (for example, PHP files) are treated as static files and have their source code served, but they are not executed.
87-
`expires` | The number of seconds to cache whitelisted content in the browser. This attribute enables the cache-control and expires headers for static content. If this value is not set, the `expires` directive and resulting headers are not included when serving static content files.
88+
`scripts` | Allow loading scripts in this location. Set the value to `true` to allow scripts.
89+
`whitelist` | A list of static files that can be served. Dynamic files, such as PHP files, are treated as static files, where the source code is served and not run.
8890

89-
Contrary to standard `.htaccess` approaches that accept a _blacklist_ and allow access to everything not on a specific list, we accept a _whitelist_, which means that any request that does not match triggers a 404 error and passes through to the URL specified by the `passthru` attribute.
91+
Contrary to standard `.htaccess` approaches that accept a _blacklist_ and allow access to everything not on a specific list, we accept a _whitelist_, which means that any request that does not match triggers a 404 error and passes through to the URL specified by the `passthru` attribute.
9092

9193
Our default configuration allows the following:
9294

0 commit comments

Comments
 (0)