如何在NextJS项目的指定文件夹或路由中添加运行PHP代码

Next.js默认仅处理自身路由体系下的前端/Node层接口，无法直接解析PHP文件，你需要通过服务器配置或Next.js重写规则转发/admin路径的请求到PHP解析服务，以下是可落地的方案：

方案1：Web服务器反向代理（生产环境最推荐） #

• 前提：你已经在服务器上部署了PHP解析服务（如PHP-FPM、带PHP模块的Apache），且单独访问PHP文件可正常返回内容
• Nginx配置示例：在你的站点Nginx配置文件中，添加优先级高于Next.js请求的location规则：

location ^~ /admin {
    root 你的站点根目录路径; # 示例：/var/www/你的项目根目录
    index index.php index.html;
    # 以下为PHP-FPM常规解析配置
    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock; # 替换为你的PHP-FPM套接字路径或监听端口
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}
# 原有Next.js请求的代理配置放在后面
location / {
    proxy_pass http://localhost:3000; # 替换为你的Next.js服务运行地址
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

• 配置完成后重载Nginx即可生效。

方案2：通过Next.js重写规则转发 #

如果不想调整Web服务器配置，可直接修改Next.js项目根目录的next.config.js文件，添加rewrites规则将/admin路径的请求转发到你的PHP服务地址：

/** @type {import('next').NextConfig} */
const nextConfig = {
  async rewrites() {
    return [
      {
        source: '/admin/:path*',
        destination: 'http://localhost:8000/admin/:path*', // 替换为你的PHP服务实际访问地址
      },
    ]
  },
}

module.exports = nextConfig

• 注意：该方案需要你的PHP服务已经启动并可以被Next.js服务正常访问，修改配置后重启Next.js服务生效。

注意事项 #

• 需确保admin文件夹的读取权限和PHP文件的执行权限已开放给Web服务器运行用户（如www-data）
• 配置前可先直接访问PHP服务的/admin路径，确认PHP本身可正常解析，排除PHP侧的问题

内容的提问来源于stack exchange，提问作者Atif Khan