Ampache 部署与“public”目录问题分析

在使用 Ampache 音乐流媒体系统时，许多用户会遇到一个常见的警告：

Warning
The root Ampache folder has changed to ./public
You must update your DocumentRoot to the new path
Please check the Ampache wiki for more information

这一警告直接关系到 Ampache 的文件结构变化和 Web 服务器配置，尤其是在 Windows 系统上使用 Nginx 或 Apache 时尤为突出。本文将分析其原因、解决方案及相关部署注意事项。

一、问题原因分析

从 Ampache 4.x 开始，其前端入口已经统一迁移到 public 文件夹。换句话说：

• 原来可能直接将 Web 根目录指向 Ampache 根目录，如 D:/www/yingyin.800188.com；

• 现在，Ampache 的主入口文件 index.php 位于 public 目录下；

• 所有对 PHP 源码的访问（如 src/Config/Bootstrap.php）都是通过 public/index.php 来加载。

如果 Nginx 或 Apache 的 DocumentRoot（或 root）仍指向上一级目录，系统会报错：

Warning: require_once(D:\www\yingyin.800188.com/../src/Config/Bootstrap.php): Failed to open stream

这是因为 index.php 的路径预期从 public 出发，而 Web 服务器指向了错误目录。

二、文件结构调整建议

为解决上述问题，只需保持原有文件结构不变，并将 Web 服务器根目录指向 public：

D:/www/yingyin.800188.com/
│
├─ public/           <- Web 根目录
│   ├─ index.php
│   └─ 其它前端资源（CSS、JS、图片）
│
├─ src/               <- PHP 源码，包含 Bootstrap.php
├─ vendor/            <- Composer 依赖
├─ config/            <- 配置文件
└─ 其它文件夹

注意：

1. public 目录是唯一对外暴露的入口；

2. 其它目录（如 src、vendor、config）保持原位，不需要移动；

3. PHP 脚本通过 ../src/Config/Bootstrap.php 自动加载 Ampache 核心文件，无需修改。

三、Nginx 配置示例（Windows）

假设你在 Windows 上使用 Nginx 和 PHP-FPM，可以这样配置：

server {
    listen 80;
    server_name yingyin.800188.com;
    root D:/www/yingyin.800188.com/public;  # 指向 public
    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        fastcgi_pass php_backend;  # 上游 PHP-FPM 服务器组
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_read_timeout 180s;
        fastcgi_send_timeout 180s;
    }

    location ~ /\.ht {
        deny all;
    }

    location ~* \.(css|js|jpg|jpeg|png|gif|ico|woff|woff2|ttf|svg|eot|otf)$ {
        expires max;
        log_not_found off;
    }
}

关键点：

• root 必须指向 public；

• SCRIPT_FILENAME 结合 $document_root 可以正确解析 ../src/Config/Bootstrap.php；

• 其他静态资源、.ht 文件的安全访问控制保持不变。

四、总结

1. Ampache 4.x 结构调整的核心是“前端入口迁移到 public”；

2. 解决报错的方式是将 Web 服务器根目录指向 public，其余目录不变；

3. PHP 脚本会自动加载上级目录的核心文件，不影响系统功能；

4. 在 Windows + Nginx 环境下，结合 PHP-FPM 配置，可以保持稳定运行，同时保证静态资源和安全规则生效。

通过这一调整，Ampache 的安装路径与现代 Web 安全规范保持一致，同时避免了路径错误导致的 PHP 加载失败问题。