如何将phpMyAdmin部署到子目录_Nginx别名Alias配置-phpMyAdmin-PHP中文网

phpMyAdmin 子目录访问失败的根本原因是 Nginx alias 指令对末尾斜杠敏感及 PHP-FPM 路径映射错误，需严格配置 alias 结尾斜杠、index.php、SCRIPT_FILENAME 用 $request_filename、禁用 try_files，并在 config.inc.php 中设置 PmaAbsoluteUri。

phpMyAdmin 无法通过子目录访问，404 或跳转到根路径

根本原因是 nginx 的 alias 指令对末尾斜杠极其敏感，且与 root 行为完全不同。用错一个斜杠，请求就进不了 phpmyadmin 的入口文件。

实操建议：

alias 值必须以 / 结尾，且对应本地文件系统路径的**完整目录路径**（不是 URL 路径）；例如 URL 是 /phpmyadmin/，则 alias /var/www/phpmyadmin/; —— 注意末尾斜杠不能少
务必在 location 块中显式指定 index.php，否则 Nginx 不会自动触发 PHP 处理：添加 index index.php;
PHP-FPM 的 SCRIPT_FILENAME 必须拼对，推荐用 fastcgi_param SCRIPT_FILENAME $request_filename;（而不是拼接 $document_root），避免 alias 下路径映射错乱
禁用 try_files 在该 location 中的默认行为（如 try_files $uri $uri/ =404;），它会绕过 alias 直接查文件，导致跳过 PHP 入口

访问时提示 “No input file specified” 或 500 错误

这是 PHP-FPM 找不到 index.php 的典型表现，90% 出现在 alias 配置下，因为 $document_root 仍指向站点根目录，而实际文件在别名路径里。

实操建议：

不要用 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; —— 这在 alias 下完全失效
改用 fastcgi_param SCRIPT_FILENAME $request_filename;，它能正确拿到经 alias 映射后的磁盘绝对路径
确认 phpMyAdmin 目录权限可读，且 index.php 文件存在；Nginx 工作用户（如 www-data）需有执行权限
检查 php.ini 中 open_basedir 是否限制了该路径，临时注释掉测试

登录后 CSS/JS 加载失败或跳转回 /（非子目录）

phpMyAdmin 默认按“部署在 Web 根目录”生成资源链接和重定向地址，子目录下必须显式告知它当前上下文。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

实操建议：

编辑 config.inc.php，设置：$cfg['PmaAbsoluteUri'] = 'https://example.com/phpmyadmin/';（协议、域名、子目录路径全写死）
若用 HTTP，注意协议一致性；若启用了 HTTPS，这里也必须是 https://，否则混合内容或跳转出错
确保 $cfg['SaveDir'] 和 $cfg['TempDir'] 指向可写的本地路径（如 /var/lib/phpmyadmin/tmp/），不依赖 URL 路径
浏览器缓存常导致旧重定向残留，测试时用无痕窗口或清空缓存

多个子目录共存或与 Laravel/WordPress 同站冲突

当主站用 try_files + index.php 重写（如 Laravel）时，phpMyAdmin 的 location 必须**优先匹配、独立处理**，否则请求会被主规则劫持。

实操建议：

location 块必须放在主站 try_files 规则之前，且用精确匹配或前缀匹配：例如 location ^~ /phpmyadmin/ { ... }
避免用 location /phpmyadmin（没结尾斜杠），它会匹配 /phpmyadmin123 等意外路径
在 phpMyAdmin 的 location 内，**禁止再出现 try_files 或 rewrite**，只做静态文件服务 + PHP 转发
如果主站已启用 fastcgi_intercept_errors on;，需在 phpMyAdmin 块中显式关掉：fastcgi_intercept_errors off;，否则 PHP 错误页被吞掉