NGINX Unit

MediaWiki§

使用 Unit 运行 MediaWiki 协作和文档平台

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

  2. 安装 MediaWiki 的 核心文件。此处,我们将其安装在 /path/to/app/;在配置中使用真实路径。

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

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

    注意

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

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

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

    {
        "listeners": {
            "*:80": {
                "pass": "routes"
            }
    
        },
    
        "routes": [
            {
                "match": {
                    "uri": [
                        "!/tests/qunit/*",
                        "/cache/*",
                        "/includes/*",
                        "/languages/*",
                        "/maintenance/*",
                        "/tests/*",
                        "/vendor/*"
                    ]
                },
    
                "action": {
                    "return": 404
                }
            },
            {
                "match": {
                    "uri": [
                        "/api.php*",
                        "/img_auth.php*",
                        "/index.php*",
                        "/load.php*",
                        "/mw-config/*.php",
                        "/opensearch_desc.php*",
                        "/profileinfo.php*",
                        "/rest.php*",
                        "/tests/qunit/*.php",
                        "/thumb.php*",
                        "/thumb_handler.php*"
                    ]
                },
    
                "action": {
                    "pass": "applications/mw/direct"
                }
            },
            {
                "match": {
                    "uri": [
                        "!*.php",
                        "!*.json",
                        "!*.htaccess",
                        "/extensions/*",
                        "/images/*",
                        "/resources/assets/*",
                        "/resources/lib/*",
                        "/resources/src/*",
                        "/skins/*"
                    ]
                },
    
                "action": {
                    "share": "/path/to/app$uri"
                }
            },
            {
                "action": {
                    "pass": "applications/mw/index"
                }
            }
        ],
    
        "applications": {
            "mw": {
                "type": "php",
                "targets": {
                    "direct": {
                        "root": "/path/to/app/"
                    },
    
                    "index": {
                        "root": "/path/to/app/",
                        "script": "index.php"
                    }
                }
            }
        }
    }
    

    注意

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

    • 直接目标从 URI 运行 .php 脚本,如果没有 URI,则默认为 index.php

    • 索引目标指定 Unit 为目标接收的任何 URI 运行的脚本

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

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

    注意

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

  6. 浏览至 http://localhost/mw-config/index.php 并使用前面记录的设置设置 MediaWiki

    MediaWiki on Unit

    下载新生成的 LocalSettings.php 文件并将其放置在 适当的位置

    $ chmod 600 LocalSettings.php
    # chown unit:unit LocalSettings.php
    # mv LocalSettings.php /path/to/app/
    
  7. 安装后,向第一步添加匹配条件以禁用对 mw-config/ 目录的访问

    # curl -X POST -d '"/mw-config/*"'  \
           --unix-socket /path/to/control.unit.sock  \
           http://localhost/config/routes/mediawiki/0/match/uri/
    
          {
              "success": "Reconfiguration done."
          }
    

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

    MediaWiki on Unit