add documentation for worker config inside php or php_server blocks

Author: henderkes

docs/cn/config.md

@@ -86,13 +86,37 @@ localhost {
 # ...
 ```
 
-如果在同一服务器上运行多个应用，还可以定义多个 worker：
+Worker 块也可以在 `php` 或 `php_server` 块内定义。在这种情况下，worker 继承父指令的环境变量和根路径，并且只能由该特定域访问：
+
+```caddyfile
+{
+	frankenphp
+}
+example.com {
+	root /path/to/app
+	php_server {
+		root <path>
+		worker {
+			file <path, 可以相对于 root>
+			num <num>
+			env <key> <value>
+			watch <path>
+			name <name>
+		}
+	}
+}
+```
 
+如果在同一服务器上运行多个应用，还可以定义多个 worker：
 ```caddyfile
 {
 	frankenphp {
 		worker /path/to/app/public/index.php <num>
-		worker /path/to/other/public/index.php <num>
+		worker {
+			file /path/to/other/public/index.php
+			num <num>
+			env APP_ENV dev
+		}
 	}
 }
 
@@ -103,7 +127,34 @@ app.example.com {
 
 other.example.com {
 	root /path/to/other/public
-	php_server
+	php_server {
+		env APP_ENV dev
+	}
+}
+
+# ...
+```
+
+等效于
+
+```caddyfile
+{
+	frankenphp
+}
+
+app.example.com {
+	php_server {
+		root /path/to/app/public
+		worker index.php <num>
+	}
+}
+
+other.example.com {
+	php_server {
+		root /path/to/other/public
+		env APP_ENV dev
+		worker index.php <num>
+	}
 }
 # ...
 ```
@@ -138,7 +189,7 @@ route {
 
 ```caddyfile
 php_server [<matcher>] {
-	root <directory> # 设置站点的根目录。默认值：`root` 指令。如果未指定，默认将使用 current_working_dir/public 目录。
+	root <directory> # 设置站点的根目录。默认值：`root` 指令。如果未指定
 	split_path <delim...> # 设置用于将 URI 拆分为两部分的子字符串。第一个匹配的子字符串将用于从路径中拆分“路径信息”。第一个部分以匹配的子字符串为后缀，并将假定为实际资源(CGI 脚本)名称。第二部分将设置为PATH_INFO，供脚本使用。默认值：`.php`
 	resolve_root_symlink false # 禁用将 `root` 目录在符号链接时将其解析为实际值（默认启用）。
 	env <key> <value> # 设置额外的环境变量，可以设置多个环境变量。
@@ -155,6 +206,23 @@ php_server [<matcher>] {
 
 ## PHP 配置
 
+您还可以使用 `frankenphp` 块中的 `php_ini` 指令更改 PHP 配置：
+
+```caddyfile
+{
+	frankenphp {
+		php_ini memory_limit 256M
+
+		# 或者
+
+		php_ini {
+			memory_limit 256M
+			max_execution_time 15
+		}
+	}
+}
+```
+
 要加载 [其他 PHP INI 配置文件](https://www.php.net/manual/en/configuration.file.php#configuration.file.scan)，
 可以使用 `PHP_INI_SCAN_DIR` 环境变量。
 设置后，PHP 将加载给定目录中存在 `.ini` 扩展名的所有文件。

docs/cn/worker.md

@@ -3,6 +3,45 @@
 启动应用程序一次并将其保存在内存中。
 FrankenPHP 将在几毫秒内处理传入的请求。
 
+## Caddyfile 配置
+
+Worker 块可以通过两种方式定义：
+
+1. 在全局 frankenphp 块中，如[配置文档](config.md#caddyfile-config)中所述：
+
+```caddyfile
+{
+	frankenphp {
+		worker {
+			file <路径>
+			num <数量>
+			env <键> <值>
+			watch <路径>
+			name <名称>
+		}
+	}
+}
+```
+
+2. 在 php 或 php_server 块内：
+
+```caddyfile
+example.com {
+	root /path/to/app
+	php_server {
+		worker {
+			file <路径>
+			num <数量>
+			env <键> <值>
+			watch <路径>
+			name <名称>
+		}
+	}
+}
+```
+
+当在 php 或 php_server 块内定义时，worker 会继承父指令的环境变量和根路径，并且只能由该特定的 php 或 php_server 访问。
+
 ## 启动 Worker 脚本
 
 ### Docker

docs/config.md

@@ -94,13 +94,38 @@ Alternatively, you may use the one-line short form of the `worker` option:
 # ...
 ```
 
+Worker blocks can also be defined inside a `php` or `php_server` block. In this case, the worker inherits environment variables and root path from the parent directive and is only accessible by that specific domain:
+
+```caddyfile
+{
+	frankenphp
+}
+example.com {
+	root /path/to/app
+	php_server {
+		root <path>
+		worker {
+			file <path, can be relative to root>
+			num <num>
+			env <key> <value>
+			watch <path>
+			name <name>
+		}
+	}
+}
+```
+
 You can also define multiple workers if you serve multiple apps on the same server:
 
 ```caddyfile
 {
 	frankenphp {
 		worker /path/to/app/public/index.php <num>
-		worker /path/to/other/public/index.php <num>
+		worker {
+			file /path/to/other/public/index.php
+			num <num>
+			env APP_ENV dev
+		}
 	}
 }
 
@@ -111,7 +136,34 @@ app.example.com {
 
 other.example.com {
 	root /path/to/other/public
-	php_server
+	php_server {
+		env APP_ENV dev
+	}
+}
+
+# ...
+```
+
+Is equivalent to
+
+```caddyfile
+{
+	frankenphp
+}
+
+app.example.com {
+	php_server {
+		root /path/to/app/public
+		worker index.php <num>
+	}
+}
+
+other.example.com {
+	php_server {
+		root /path/to/other/public
+		env APP_ENV dev
+		worker index.php <num>
+	}
 }
 
 # ...
@@ -149,7 +201,7 @@ The `php_server` and the `php` directives have the following options:
 
 ```caddyfile
 php_server [<matcher>] {
-	root <directory> # Sets the root folder to the site. Default: `root` directive. If not specified, it will use the current_working_dir/public directory by default.
+	root <directory> # Sets the root folder to the site. Default: `root` directive.
 	split_path <delim...> # Sets the substrings for splitting the URI into two parts. The first matching substring will be used to split the "path info" from the path. The first piece is suffixed with the matching substring and will be assumed as the actual resource (CGI script) name. The second piece will be set to PATH_INFO for the script to use. Default: `.php`
 	resolve_root_symlink false # Disables resolving the `root` directory to its actual value by evaluating a symbolic link, if one exists (enabled by default).
 	env <key> <value> # Sets an extra environment variable to the given value. Can be specified more than once for multiple environment variables.
@@ -212,7 +264,7 @@ This is an opt-in configuration that needs to be added to the global options in
 ```caddyfile
 {
   servers {
-    enable_full_duplex
+	enable_full_duplex
   }
 }
 ```
@@ -252,16 +304,16 @@ You can also change the PHP configuration using the `php_ini` directive in the `
 
 ```caddyfile
 {
-    frankenphp {
-        php_ini memory_limit 256M
+	frankenphp {
+		php_ini memory_limit 256M
 
-        # or
+		# or
 
-        php_ini {
-            memory_limit 256M
-            max_execution_time 15
-        }
-    }
+		php_ini {
+			memory_limit 256M
+			max_execution_time 15
+		}
+	}
 }
 ```