Update getting started according to new app template

cookbook/en/README.md

@@ -15,3 +15,4 @@ This book conforms to the [Terms of Yii Documentation](https://www.yiiframework.
 - [Preface](preface.md)
 - [Structuring code by use-case with vertical slices](organizing-code/structuring-by-use-case-with-vertical-slices.md)
 - [Sentry integration](sentry-integration.md)
+- [Configuring webservers](configuring-webservers/general.md)

cookbook/en/configuring-webservers/apache.md

@@ -0,0 +1,46 @@
+# Configuring web servers: Apache
+
+Use the following configuration in Apache's `httpd.conf` file or within a virtual host configuration. Note that you
+should replace `path/to/app/public` with the actual path for `app/public`.
+
+```apacheconfig
+# Set document root to be "app/public"
+DocumentRoot "path/to/app/public"
+
+<Directory "path/to/app/public">
+    # use mod_rewrite for pretty URL support
+    RewriteEngine on
+
+    # if $showScriptName is false in UrlManager, do not allow accessing URLs with script name
+    RewriteRule ^index.php/ - [L,R=404]
+
+    # If a directory or a file exists, use the request directly
+    RewriteCond %{REQUEST_FILENAME} !-f
+    RewriteCond %{REQUEST_FILENAME} !-d
+
+    # Otherwise forward the request to index.php
+    RewriteRule . index.php
+
+    # ...other settings...
+</Directory>
+```
+
+In case you have `AllowOverride All` you can add `.htaccess` file with the following configuration instead of
+using `httpd.conf`:
+
+```apacheconfig
+# use mod_rewrite for pretty URL support
+RewriteEngine on
+
+# if $showScriptName is false in UrlManager, do not allow accessing URLs with script name
+RewriteRule ^index.php/ - [L,R=404]
+
+# If a directory or a file exists, use the request directly
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+
+# Otherwise forward the request to index.php
+RewriteRule . index.php
+
+# ...other settings...
+```

cookbook/en/configuring-webservers/general.md

@@ -0,0 +1,15 @@
+# Configuring web servers: General
+
+On a production server, if you don't use Docker, configure your web server to serve only the application's public files. 
+Point the document root of your web server to the `app/public` folder.
+
+> Info: If you're running your Yii application behind a reverse proxy, you might need to configure
+> [Trusted proxies and headers](../../../guide/en/security/trusted-request.md).
+
+## Specific server configurations
+
+- [Nginx](nginx.md)
+- [Apache](apache.md)
+- [Lighttpd](lighttpd.md)
+- [Nginx Unit](nginx-unit.md)
+- [IIS](iis.md)

cookbook/en/configuring-webservers/iis.md

@@ -0,0 +1,34 @@
+# Configuring web servers: IIS
+
+When you use [IIS](https://www.iis.net/), host the application in a virtual host (Website) where the document
+root points to the `path/to/app/public` folder and configure the website to run PHP.
+In that `public` folder, place a file named `web.config` at `path/to/app/public/web.config`.
+Use the following content:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+<system.webServer>
+<directoryBrowse enabled="false" />
+  <rewrite>
+    <rules>
+      <rule name="Hide Yii Index" stopProcessing="true">
+        <match url="." ignoreCase="false" />
+        <conditions>
+        <add input="{REQUEST_FILENAME}" matchType="IsFile" 
+              ignoreCase="false" negate="true" />
+        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" 
+              ignoreCase="false" negate="true" />
+        </conditions>
+        <action type="Rewrite" url="index.php" appendQueryString="true" />
+      </rule> 
+    </rules>
+  </rewrite>
+</system.webServer>
+</configuration>
+```
+
+Also, the following list of Microsoft's official resources could be useful to configure PHP on IIS:
+
+1. [How to set up your first IIS website](https://support.microsoft.com/en-us/help/323972/how-to-set-up-your-first-iis-web-site)
+2. [Configure a PHP Website on IIS](https://docs.microsoft.com/en-us/iis/application-frameworks/scenario-build-a-php-website-on-iis/configure-a-php-website-on-iis)

cookbook/en/configuring-webservers/lighttpd.md

@@ -0,0 +1,7 @@
+# Configuring web servers: lighttpd
+
+To use [lighttpd](https://www.lighttpd.net/) >= 1.4.24, put `index.php` in the web root and add the following to the configuration:
+
+```
+url.rewrite-if-not-file = ("(.*)" => "/index.php/$0")
+```

cookbook/en/configuring-webservers/nginx-unit.md

@@ -0,0 +1,60 @@
+# Configuring web servers: NGINX Unit
+
+Run Yii-based apps using [NGINX Unit](https://unit.nginx.org/) with a PHP language module.
+Here is a sample configuration.
+
+```json
+{
+    "listeners": {
+        "*:80": {
+            "pass": "routes/yii"
+        }
+    },
+
+    "routes": {
+        "yii": [
+            {
+                "match": {
+                    "uri": [
+                        "!/assets/*",
+                        "*.php",
+                        "*.php/*"
+                    ]
+                },
+
+                "action": {
+                    "pass": "applications/yii/direct"
+                }
+            },
+            {
+                "action": {
+                    "share": "/path/to/app/public/",
+                    "fallback": {
+                        "pass": "applications/yii/index"
+                    }
+                }
+            }
+        ]
+    },
+
+    "applications": {
+        "yii": {
+            "type": "php",
+            "user": "www-data",
+            "targets": {
+                "direct": {
+                    "root": "/path/to/app/public/"
+                },
+
+                "index": {
+                    "root": "/path/to/app/public/",
+                    "script": "index.php"
+                }
+            }
+        }
+    }
+}
+```
+
+You can also [set up](https://unit.nginx.org/configuration/#php) your PHP environment or supply a custom `php.ini`
+in the same configuration.

cookbook/en/configuring-webservers/nginx.md

@@ -0,0 +1,56 @@
+# Configuring web servers: Nginx
+
+To use [Nginx](https://wiki.nginx.org/), install PHP as an [FPM SAPI](https://secure.php.net/install.fpm).
+Use the following Nginx configuration, replacing `path/to/app/public` with the actual path for
+`app/public` and `mysite.test` with the actual hostname to serve.
+
+```nginx
+server {
+    charset utf-8;
+    client_max_body_size 128M;
+
+    listen 80; ## listen for ipv4
+    #listen [::]:80 default_server ipv6only=on; ## listen for ipv6
+
+    server_name mysite.test;
+    root        /path/to/app/public;
+    index       index.php;
+
+    access_log  /path/to/basic/log/access.log;
+    error_log   /path/to/basic/log/error.log;
+
+    location / {
+        # Redirect everything that isn't a real file to index.php
+        try_files $uri $uri/ /index.php$is_args$args;
+    }
+
+    # uncomment to avoid processing of calls to non-existing static files by Yii
+    #location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ {
+    #    try_files $uri =404;
+    #}
+    #error_page 404 /404.html;
+
+    # deny accessing php files for the /assets directory
+    location ~ ^/assets/.*\.php$ {
+        deny all;
+    }
+
+    location ~ \.php$ {
+        include fastcgi_params;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        fastcgi_pass 127.0.0.1:9000;
+        #fastcgi_pass unix:/var/run/php8-fpm.sock;
+        try_files $uri =404;
+    }
+
+    location ~* /\. {
+        deny all;
+    }
+}
+```
+
+When you use this configuration, also set `cgi.fix_pathinfo=0` in the `php.ini` file
+to avoid many unnecessary system `stat()` calls.
+
+Also, note that when running an HTTPS server, you need to add `fastcgi_param HTTPS on;` so that Yii
+can detect if a connection is secure.

cookbook/en/preface.md

@@ -2,16 +2,15 @@
 
 Yii is a high-performance, package-based PHP framework for developing modern applications.
 The name Yii (pronounced `Yee` or `[ji:]`) means "simple and evolutionary" in Chinese.
 You can also think about it as an acronym for **Yes It Is**!
 
 Yii is a generic Web programming framework.
 You can use it for developing all kinds of Web applications using PHP.
 Because of its architecture and sophisticated caching support,
 it's especially suitable for developing large-scale applications such as portals, content management systems,
 e-commerce, REST APIs, etc.
 
-Together with a comprehensive set of documentation and an enthusiastic user community, Yii can reduce your development
-time in a long run significantly.
+With comprehensive documentation and an enthusiastic user community, Yii can significantly reduce your development time in the long run.
 
 ## What's the book about
 

guide/en/README.md

@@ -1,6 +1,6 @@
 # The definitive guide to Yii 3.0
 
-This guide is released under the [Terms of Yii Documentation](https://www.yiiframework.com/license#docs).
+We release this guide under the [Terms of Yii Documentation](https://www.yiiframework.com/license#docs).
 
 Introduction +
 ------------
@@ -46,7 +46,7 @@
 Handling requests +
 -----------------
 
 * [Routing and URL generation](runtime/routing.md) +
 * [Request](runtime/request.md) +
 * [Response](runtime/response.md) +
 * [Sessions](runtime/sessions.md) +
@@ -71,7 +71,7 @@
 
 * [Database access objects](db-dao.md): Connecting to a database, basic queries, transactions, and schema manipulation
 * [Query builder](db-query-builder.md): Querying the database using a simple abstraction layer
 * [Active record](db-active-record.md): The Active Record ORM, retrieving and manipulating records, and defining relations
 * [Migrations](databases/db-migrations.md): +
 
 Getting data from users -
@@ -113,7 +113,7 @@
 * [HTTP caching](caching/http.md) -
 
 
 REST APIs -
 -----------
 
 * [Quick start](rest/quick-start.md)