NGINX Unit

Yii§

要使用 Unit 运行基于 Yii 框架 1.1 或 2.0 版本的应用

  1. 使用 PHP 语言模块安装 Unit

  2. 接下来,安装 Yii 并创建或部署你的应用。

    在此,我们使用 Yii 的 基本项目模板 和 Composer

    $ cd /path/to/
    $ composer create-project --prefer-dist yiisoft/yii2-app-basic app
    

    这将在 /path/to/app/ 处创建应用的目录树。它的 web/ 子目录包含根 index.php 和静态文件;如果你的应用需要其他 .php 脚本,也将其存储在此处。

  3. 运行以下命令,以便 Unit 可以访问 应用程序目录

    # chown -R unit:unit /path/to/app/
    

    注意

    unit:unit 用户组对仅适用于 官方包、Docker 映像 和一些 第三方仓库。否则,帐户名称可能有所不同;运行 ps aux | grep unitd 命令以确保这一点。

    有关更多详细信息,包括权限,请参阅 安全检查清单

  4. 接下来,准备 Unit 的 Yii 配置(对 shareroot 使用真实值)

    {
        "listeners": {
            "*:80": {
                "pass": "routes"
            }
        },
    
        "routes": [
            {
                "match": {
                    "uri": [
                        "!/assets/*",
                        "*.php",
                        "*.php/*"
                    ]
                },
    
                "action": {
                    "pass": "applications/yii/direct"
                }
            },
            {
                "action": {
                    "share": "/path/to/app/web$uri",
                    "fallback": {
                        "pass": "applications/yii/index"
                    }
                }
            }
        ],
    
        "applications": {
            "yii": {
                "type": "php",
                "targets": {
                    "direct": {
                        "root": "/path/to/app/web/"
                    },
    
                    "index": {
                        "root": "/path/to/app/web/",
                        "script": "index.php"
                    }
                }
            }
        }
    }
    

    有关详细讨论,请参阅 Yii 2.0 文档中的 配置 Web 服务器运行应用程序

    注意

    pass 目标之间的差异在于它们对 script 设置 的使用

    • direct 目标从 URI 运行 .php 脚本,如果 URI 省略了该脚本,则运行 index.php

    • index 目标指定 Unit 为目标接收的任何 URI 运行的 script

  5. 上传更新的配置。假设上述 JSON 已添加到 config.json

    # curl -X PUT --data-binary @config.json --unix-socket \
           /path/to/control.unit.sock http://localhost/config/
    

    注意

    控制套接字 路径可能有所不同;运行 unitd -h 或参见 启动和关闭 了解详情。

    成功更新后,您的应用应可在侦听器的 IP 地址和端口上使用

    Yii Basic Template App on Unit
  1. 使用 PHP 语言模块安装 Unit

  2. 接下来,安装 Yii 并创建或部署您的应用。

    在此,我们使用 Yii 的 基本项目模板yiic

    $ git clone git@github.com:yiisoft/yii.git /path/to/yii1.1/
    $ /path/to/yii1.1/framework/yiic webapp /path/to/app/
    

    这将在 /path/to/app/ 中创建应用的目录树。

  3. 接下来,准备 Unit 的 Yii 配置(对 shareroot 使用真实值)

    {
        "listeners": {
            "*:80": {
                "pass": "routes"
            }
        },
    
        "routes": [
            {
                "match": {
                    "uri": [
                        "!/assets/*",
                        "!/protected/*",
                        "!/themes/*",
                        "*.php",
                        "*.php/*"
                    ]
                },
    
                "action": {
                    "pass": "applications/yii/direct"
                }
            },
            {
                "action": {
                    "share": "/path/to/app$uri",
                    "fallback": {
                        "pass": "applications/yii/index"
                    }
                }
            }
        ],
    
        "applications": {
            "yii": {
                "type": "php",
                "targets": {
                    "direct": {
                        "root": "/path/to/app/"
                    },
                    "index": {
                        "root": "/path/to/app/",
                        "script": "index.php"
                    }
                }
            }
        }
    }
    

    如需详细讨论,请参见 Yii 1.1 文档

    注意

    pass 目标之间的差异在于它们对 script 设置 的使用

    • direct 目标从 URI 运行 .php 脚本,如果 URI 省略了该脚本,则运行 index.php

    • index 目标指定 Unit 为目标接收的任何 URI 运行的 script

  4. 上传更新的配置。假设上述 JSON 已添加到 config.json

    # curl -X PUT --data-binary @config.json --unix-socket \
           /path/to/control.unit.sock http://localhost/config/
    

    注意

    控制套接字 路径可能有所不同;运行 unitd -h 或参见 启动和关闭 了解详情。

    成功更新后,您的应用应可在侦听器的 IP 地址和端口上使用

    Yii Basic Template App on Unit