PHP脚本必须本地存储，Nginx需真实读取以构造SCRIPT_FILENAME；静态资源可托管于NFS或对象存储并由Nginx直接服务，实现动静分离。
Nginx 本身不支持将 PHP-FPM 的执行逻辑“分布”到远程文件系统上运行，PHP-FPM 必须在本地（或容器内）加载并执行 PHP 脚本，因此PHP 文件不能放在纯分布式文件系统（如 NFS、CephFS、S3FS）中直接由 PHP-FPM 执行。但静态资源（如图片、CSS、JS、字体等）可以且推荐使用分布式文件系统或对象存储托管，由 Nginx 直接服务——这正是解耦动静分离的关键。
静态资源用分布式文件系统，PHP 脚本必须本地可读
核心原则：Nginx 需要能 真实读取 PHP 脚本文件（用于 try_files 校验、SCRIPT_FILENAME 构造），所以 /var/www/your-site/*.php 必须挂载为本地路径（如 bind mount 或本地磁盘），而 /static/、/uploads/ 等目录可指向分布式存储。
- ✅ 推荐方式：用
mount -t nfs或systemd-mount将 NFS 共享挂载到 Nginx 服务器的/var/www/your-site/public/static，然后在 Nginx 配置中用location /static/直接alias到该路径 - ✅ 对象存储替代方案：用
proxy_pass https://your-bucket.s3.region.amazonaws.com/+expires max+ CDN 缓存，完全绕过本地存储 - ❌ 错误做法：把整个
/var/www/your-site挂成 NFS，尤其当多台 Nginx 共享同一 NFS 时，会因 inode 缓存、stat 性能、锁竞争导致502或高延迟
Nginx 配置示例：动静分离 + 分布式静态路径
假设你已将 NFS 共享挂载到 /mnt/nfs-static，里面存放 logo.png、app.css 等：
server {
root /var/www/myapp/public; # PHP 入口所在，必须本地
index index.php;
<pre class="brush:php;toolbar:false;">location /static/ {
alias /mnt/nfs-static/; # ← 指向分布式文件系统
expires 1y;
add_header Cache-Control "public, immutable";
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; # ← 依赖 $document_root 是本地路径
fastcgi_intercept_errors on;
}}
立即学习“PHP免费学习笔记（深入）”；
注意：alias 结尾有斜杠，root 没有；alias 路径必须以 / 结尾，否则文件拼接会出错。
安全与性能注意事项
- 挂载 NFS 时加选项：
nfsvers=4.2,hard,intr,rsize=1048576,wsize=1048576,noatime，避免 soft 挂载导致 502 - 禁用 PHP-FPM 的
opcache.validate_timestamps = 0（仅限开发），生产环境保持=1，否则 NFS 上文件更新后 PHP 可能不重载 - 若用 S3 或 MinIO，建议配合
ngx_aws_auth模块或反向代理签名 URL，避免密钥泄露 - 不要在
location /static/块里写fastcgi_pass——静态资源绝不经 PHP-FPM 处理
本质不是“PHP-FPM 配置分布式存储”，而是让 Nginx 在静态层卸载压力，把 PHP 执行严格保留在本地可控环境中。
