php 8.0 在 iis 虚拟目录中需手动继承 fastcgi 映射、配置 web.config 重写规则、确保物理路径全英文无空格、授予 iis_iusrs 权限,并在 fastcgi 设置中启用 cgi.fix_pathinfo=1。

PHP 8.0 在 IIS 上创建虚拟目录本身不难,但多数人失败不是因为“不会加”,而是加完后 index.php 无法执行、No input file specified 报错、或静态资源 404——根本原因是虚拟目录没继承 FastCGI 处理程序映射,也没正确配置权限和重写规则。
虚拟目录必须手动继承 *.php 处理程序
IIS 的虚拟目录默认不继承父网站的处理程序映射,哪怕你已在主站配好了 FastCgiModule,新虚拟目录仍会走默认静态文件处理逻辑。
- 在 IIS 管理器中,右键点击刚建好的虚拟目录 → 选择「处理程序映射」
- 点击右侧「添加模块映射…」→ 填入:
- 请求路径:
*.php - 模块:
FastCgiModule(必须从下拉菜单选,不能手输) - 可执行文件:
C:\php\php-cgi.exe(路径必须与主站一致) - 名称:
PHP_via_FastCGI_virtual(避免与主站同名冲突)
- 请求路径:
- 务必勾选「仅限脚本」和「验证文件是否存在」
ThinkPHP/Laravel 类框架需额外补 Web.config 重写规则
虚拟目录若用于运行 ThinkPHP 8.0 或 Laravel 等依赖 PATH_INFO 的框架,仅靠处理程序映射不够,还必须在虚拟目录根路径下放一个 Web.config,否则所有路由都返回 404 或 No input file specified。
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题,改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
- 规则核心是把
/soft/index.php/abc/def转成/soft/index.php?/abc/def,IIS 才能交给 PHP 正确解析 -
Web.config内容示例(放在虚拟目录根下):
<configuration><system.webserver><rewrite><rules><rule name="ThinkPHP" stopprocessing="true"><match url="^(.*)$"></match><conditions logicalgrouping="MatchAll"><add input="{REQUEST_FILENAME}" matchtype="IsFile" negate="true"></add><add input="{REQUEST_FILENAME}" matchtype="IsDirectory" negate="true"></add></conditions><action type="Rewrite" url="index.php?{R:1}"></action></rule></rules></rewrite></system.webserver></configuration>
- 注意:
url="index.php?{R:1}"中的问号不可省略;漏掉stopProcessing="true"会导致规则被后续默认规则覆盖
权限与物理路径的两个硬性限制
即使映射和重写都对了,IIS_IUSRS 对物理路径无读取权,或路径含空格/中文,PHP 进程照样启动失败,报错 HTTP Error 500.0 - Internal Server Error 或直接下载 .php 文件。
- 物理路径必须满足:
- 全英文、无空格、无中文(如
C:\www\soft✅,C:\my site\soft❌) - 路径所在磁盘有足够空间,且 NTFS 权限已授予
IIS_IUSRS「读取 & 执行」「列出文件夹内容」「读取」
- 全英文、无空格、无中文(如
- 验证权限是否生效:用管理员身份打开命令行,执行:
icacls "C:\www\soft" /grant "IIS_IUSRS:(OI)(CI)RX" - 别名(Alias)可以含短横线或数字(如
api-v1),但不能以点开头(.git会被 IIS 拒绝)
最常被忽略的是:虚拟目录的 Web.config 和处理程序映射必须各自独立存在,不能依赖父站点继承;而 cgi.fix_pathinfo 的值在 FastCGI 环境变量里设为 1(非 php.ini),这点在 ThinkPHP 场景下几乎是必选项,但文档极少强调。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










