ThinkPHP 5 在 Windows IIS 上的部署与 PHP 版本兼容性配置

IIS 站点配置

添加角色

首次配置 IIS 环境时，确保已安装'应用程序开发'功能模块，特别是 CGI 支持。此处略过基础组件安装步骤。

处理程序映射

这是最关键的一步，用于告诉 IIS 如何处理 .php 请求。

1. 打开 IIS 管理器，选中网站。
2. 点击'处理程序映射'，选择'添加模块映射'。
3. 填写以下信息：
   • 请求路径：*.php
   • 模块：FastCgiModule
   • 可执行文件：指向解压目录下的 php-cgi.exe
   • 名称：自定义，如 phpcgi

默认文档

为避免访问首页时需输入文件名，需添加默认文档。

1. 双击'默认文档'。
2. 添加 index.php 并调整顺序至顶部。

常见问题排查

缺少 VC 运行库

如果启动失败提示找不到 DLL，通常是缺少 Visual C++ Redistributable。

• PHP 7.x：通常需要 VC14 (VS 2015) 运行库。
• PHP 5.5：对应 VC++2012。

下载地址：https://aka.ms/vs/16/release/vc_redist.x64.exe

MySQL 绿色版辅助工具

为了方便管理本地测试环境，这里提供一套基于批处理的 MySQL 绿色版管理脚本。以 MySQL 5.7.44 为例。

文件结构

D:\mysql-5.7.44-winx64\
 ├── bin\      # 可执行文件
 ├── docs\      # 文档
 ├── include\   # 头文件
 ├── lib\       # 库文件
 ├── share\     # 共享文件
 ├── LICENSE    # 许可证
 └── README     # 说明文件

一键启动脚本

创建 start_mysql.bat，内容如下：

@echo off
chcp 65001 > nul
title MySQL 5.7.44 绿色版启动器
setlocal enabledelayedexpansion
echo ========================================
echo MySQL 5.7.44 绿色版启动程序
echo ========================================
echo.
REM 设置 MySQL 根目录（当前目录）
set "MYSQL_DIR=%~dp0"
set "MYSQL_DIR=%MYSQL_DIR:~0,-1%"
echo MySQL 目录：%MYSQL_DIR%
echo.
REM 检查必要的文件
if not exist "%MYSQL_DIR%\bin\mysqld.exe" (
 echo ❌ 错误：未找到 mysqld.exe
 pause
 exit /b 1
)
REM 检查是否已安装服务
sc query MySQL57 >nul 2>&1
if !errorlevel! equ 0 (
 echo [1/4] ✅ MySQL57 服务已存在
 goto :START_SERVICE
)
echo [1/4] 准备安装 MySQL57 服务...
REM 1. 创建必要的目录
if not exist "%MYSQL_DIR%\data" mkdir "%MYSQL_DIR%\data"
if not exist "%MYSQL_DIR%\logs" mkdir "%MYSQL_DIR%\logs"
REM 2. 创建 my.ini 配置文件
echo [2/4] 创建配置文件...
(
 echo [mysqld]
 echo # MySQL 安装目录
 echo basedir=%MYSQL_DIR:\=/%
 echo # MySQL 数据目录
 echo datadir=%MYSQL_DIR:\=/%/data
 echo # 端口
 echo port=3306
 echo # 字符集（使用 utf8 避免兼容问题）
 echo character-set-server=utf8
 echo collation-server=utf8_general_ci
 echo # 最大连接数
 echo max_connections=200
 echo # 存储引擎
 echo default-storage-engine=INNODB
 echo # Windows 下不区分表名大小写
 echo lower_case_table_names=1
 echo # 日志
 echo log-error=%MYSQL_DIR:\=/%/logs/mysql_error.log
 echo general_log_file=%MYSQL_DIR:\=/%/logs/mysql_general.log
 echo # 跳过密码验证（第一次安装后可以注释掉）
 echo # skip-grant-tables
 echo.
 echo [client]
 echo default-character-set=utf8
 echo port=3306
 echo.
 echo [mysql]
 echo default-character-set=utf8
) > "%MYSQL_DIR%\my.ini"
REM 3. 初始化 MySQL
echo [3/4] 初始化 MySQL 数据库...
cd /d "%MYSQL_DIR%"
bin\mysqld --initialize-insecure --user=mysql --console
if !errorlevel! neq 0 (
 echo ⚠️ 初始化可能已存在，继续安装...
)
REM 4. 安装 Windows 服务
echo [4/4] 安装 MySQL 服务...
bin\mysqld --install MySQL57 --defaults-file="%MYSQL_DIR%\my.ini"
if !errorlevel! neq 0 (
 echo ⚠️ 服务安装失败，可能已存在
)
:START_SERVICE
echo.
echo 启动 MySQL 服务...
net start MySQL57
if !errorlevel! equ 0 (
 echo ✅ MySQL 5.7.44 启动成功！
 echo.
 echo ========================================
 echo 连接信息：
 echo 用户名：root
 echo 密码：（无，首次登录请直接回车）
 echo 端口：3306
 echo.
 echo 连接命令：
 echo %MYSQL_DIR%\bin\mysql -u root
 echo.
 echo 修改密码命令（在 MySQL 中执行）：
 echo ALTER USER 'root'@'localhost' IDENTIFIED BY '你的密码';
 echo FLUSH PRIVILEGES;
 echo ========================================
) else (
 echo ❌ 服务启动失败
 echo 请查看日志：%MYSQL_DIR%\logs\mysql_error.log
)
echo.
echo 是否现在打开 MySQL 命令行？(Y/N)
set /p choice=
if /i "!choice!"=="y" (
 start "%MYSQL_DIR%\bin\mysql.exe" -u root
)
pause

停止与卸载

停止服务 (stop_mysql.bat)

@echo off
chcp 65001 > nul
echo 正在停止 MySQL 5.7.44...
net stop MySQL57
if %errorlevel% equ 0 (
 echo ✅ MySQL 已停止
) else (
 echo ⚠️ 服务未运行或停止失败
)
pause

卸载服务 (uninstall_mysql.bat)

@echo off
chcp 65001> nul
echo========================================
echo 卸载 MySQL 5.7.44 服务
echo======================================== 
echo.
echo 正在停止 MySQL 服务...
net stop MySQL57 >nul 2>&1
echo 正在删除 MySQL 服务...
sc delete MySQL57 >nul 2>&1
if %errorlevel% equ 0(
echo ✅ 服务删除成功 
)else(
echo ⚠️ 服务不存在或删除失败 
)
echo.
echo 是否删除数据文件？(Y/N)
echo 警告：这将删除所有数据库数据！
set /p choice=
if /i "%choice%"=="y"(
rmdir /s /q "%~dp0data" 2>nul
rmdir /s /q "%~dp0logs" 2>nul
del "%~dp0my.ini" 2>nul
echo ✅ 数据文件已删除 
)
echo.
echo 卸载完成！
pause

测试连接

测试脚本 (test_mysql.bat)

@echo off
chcp 65001> nul
echo 测试 MySQL 连接...
cd /d "%~dp0"
if exist "bin\mysql.exe"(
 bin\mysql -u root -e "SELECT VERSION() as MySQL 版本;" 2>nul
 if %errorlevel% equ 0(
 echo ✅ MySQL 连接成功！
 bin\mysql -u root -e "SHOW DATABASES;"
 )else(
 echo ❌ MySQL 连接失败
 ))else(
 echo ❌ 未找到 mysql.exe
 )
pause

账号配置

如需快速配置远程访问及测试用户，可使用以下脚本 (setup_account.bat)：

@echo off
chcp 65001> nul
title MySQL 5.7.44 一键配置工具
setlocal enabledelayedexpansion
echo========================================
echo MySQL 5.7.44 一键配置工具
echo 自动创建 test 用户并开启远程访问
echo======================================== 
echo.
REM 设置 MySQL 根目录
set"MYSQL_DIR=%~dp0"
set"MYSQL_DIR=%MYSQL_DIR:~0,-1%"
echo MySQL 目录：%MYSQL_DIR% 
echo.
REM 检查必要的文件
if not exist "%MYSQL_DIR%\bin\mysqld.exe"(
echo ❌ 错误：未找到 mysqld.exe
echo 请将此脚本放在 MySQL 根目录下运行
pause
exit /b 1)
echo[1/7] 检查 MySQL 服务状态...
sc query MySQL57 >nul 2>&1
if!errorlevel! equ 0(echo ✅ MySQL57 服务已存在
goto :CHECK_RUNNING )
echo ⚠️ MySQL57 服务不存在，开始安装...
REM 1. 创建必要的目录
echo[2/7] 创建目录结构...
if not exist "%MYSQL_DIR%\data"mkdir"%MYSQL_DIR%\data"
if not exist "%MYSQL_DIR%\logs"mkdir"%MYSQL_DIR%\logs"
REM 2. 创建 my.ini 配置文件（支持远程访问）
echo[3/7] 创建配置文件...
(
echo[mysqld]
echo# 基础配置
echobasedir=%MYSQL_DIR:\=/% 
echo datadir=%MYSQL_DIR:\=/%/data 
echoport=3306
echo character-set-server=utf8 
echo collation-server=utf8_general_ci 
echo max_connections=1000
echo default-storage-engine=INNODB 
echo lower_case_table_names=1
echo log-error=%MYSQL_DIR:\=/%/logs/mysql_error.log 
echo.
echo# 远程访问配置（关键！）
echo bind-address=0.0.0.0 
echo skip-name-resolve 
echo wait_timeout=600
echo interactive_timeout=600 
echo.
echo[client]
echo default-character-set=utf8 
echoport=3306 
echo.
echo[mysql]
echo default-character-set=utf8 
)>
"%MYSQL_DIR%\my.ini"
REM 3. 初始化 MySQL（无密码）
echo[4/7] 初始化 MySQL 数据库...
cd /d "%MYSQL_DIR%"
echo 正在初始化，请稍候...
bin\mysqld --initialize-insecure --user=mysql --console >nul 2>&1
if exist "%MYSQL_DIR%\data\*.err"(
echo ✅ 初始化完成 
)else(
echo ⚠️ 初始化可能已存在 
)
REM 4. 安装 Windows 服务
echo[5/7] 安装 MySQL 服务...
bin\mysqld --install MySQL57 --defaults-file="%MYSQL_DIR%\my.ini">nul 2>&1
if!errorlevel! equ 0(echo ✅ 服务安装成功 
)else(
echo ⚠️ 服务可能已存在 
)
:CHECK_RUNNING 
REM 5. 启动 MySQL 服务
echo[6/7] 启动 MySQL 服务...
net start MySQL57 >nul 2>&1
if!errorlevel! equ 0(echo ✅ MySQL 服务启动成功 
)else(
 net stop MySQL57 >nul 2>&1
 net start MySQL57 >nul 2>&1
if!errorlevel! equ 0(echo ✅ MySQL 服务重启成功 
)else(
echo ❌ MySQL 服务启动失败
echo 请查看日志：%MYSQL_DIR%\logs\mysql_error.log
pause
exit /b 1))
REM 6. 创建 test 用户和数据库
echo[7/7] 创建数据库用户...
echo 创建用户：test，密码：Test#2025
echo.
REM 使用临时 SQL 文件创建用户
(echo USE mysql;
echo.
echo -- 删除已存在的 test 用户
echo DROP USER IF EXISTS 'test'@'localhost';
echo DROP USER IF EXISTS 'test'@'%%'; 
echo.
echo -- 创建 test 用户（本地访问）
echo CREATE USER'test'@'localhost' IDENTIFIED BY 'Test#2025';
echo -- 授予所有权限
echo GRANT ALL PRIVILEGES ON *.* TO 'test'@'localhost' WITH GRANT OPTION; 
echo.
echo -- 创建 test 用户（远程访问）
echo CREATE USER'test'@'%%' IDENTIFIED BY 'Test#2025';
echo -- 授予所有权限
echo GRANT ALL PRIVILEGES ON *.* TO 'test'@'%%' WITH GRANT OPTION; 
echo.
echo -- 刷新权限
echo FLUSH PRIVILEGES; 
echo.
echo -- 验证创建
echo SELECT user, host FROM mysql.user WHERE user ='test';
echo SHOW GRANTS FOR 'test'@'%%';
)>
"%TEMP%\create_user.sql"
REM 执行 SQL 文件
cd /d "%MYSQL_DIR%\bin"
mysql -u root <"%TEMP%\create_user.sql"
REM 7. 配置 Windows 防火墙
echo 配置防火墙允许远程连接...
netsh advfirewall firewall add rule name="MySQL 3306"dir=in action=allow protocol=TCP localport=3306>nul 2>&1
netsh advfirewall firewall add rule name="MySQL 3306 Out"dir=out action=allow protocol=TCP localport=3306>nul 2>&1
REM 8. 获取本机 IP 地址
echo.
echo 正在获取本机 IP 地址...
echo.
echo 本机 IP 列表：
setcount=0for /f "tokens=2 delims=:" %%i in('ipconfig ^| findstr "IPv4"')do(set"ip=%%i"set"ip=!ip: =!"if not "!ip!"==""(set /a count+=1echo[!count!]!ip!
set"ip!count!=!ip!"))
REM 删除临时文件
del "%TEMP%\create_user.sql">nul 2>&1
echo.
echo========================================
echo ✅ 配置完成！
echo======================================== 
echo.
echo 📋 数据库信息：
echo 主机：localhost 或 上面显示的 IP 地址
echo 端口：3306
echo 用户名：test
echo 密码：Test#2025
echo.
echo 🔗 连接方式：
echo1. 本地连接：mysql -u test -pTest#2025
echo2. Navicat 连接：
echo 主机：上面显示的 IP 地址 [!count!]
echo 端口：3306
echo 用户：test
echo 密码：Test#2025
echo.
echo ⚙️ 测试连接：
echo %MYSQL_DIR%\bin\mysql -u test -pTest#2025 -e "SELECT VERSION();"
echo.
echo 🛡️ 安全提醒：
echo1. 请及时修改 root 密码：ALTER USER'root'@'localhost' IDENTIFIED BY '新密码';
echo2. 如需关闭远程访问，修改 my.ini 中的 bind-address=127.0.0.1
echo======================================== 
echo.
REM 测试连接
echo 正在测试 test 用户连接...
%MYSQL_DIR%\bin\mysql -u test -pTest#2025 -e "SELECT '✅ 连接成功！' as Status, VERSION() as MySQL 版本，USER() as 当前用户，@@hostname as 服务器;" 2>nul
if!errorlevel! equ 0(echo ✅ test 用户连接测试通过！ 
)else(
echo ⚠️ test 用户连接测试失败，正在尝试修复...
REM 尝试使用 root 创建用户
%MYSQL_DIR%\bin\mysql -u root -e "CREATE USER IF NOT EXISTS 'test'@'%%' IDENTIFIED BY 'Test#2025'; GRANT ALL ON *.* TO 'test'@'%%'; FLUSH PRIVILEGES;"2>nul 
)
echo.
set /p choice=是否打开 MySQL 命令行测试？(Y/N): 
if /i "!choice!"=="y"(
 start "%MYSQL_DIR%\bin\mysql.exe" -u test -pTest#2025)
echo.
set /p choice2=是否创建测试数据库？(Y/N): 
if /i "!choice2!"=="y"(
 %MYSQL_DIR%\bin\mysql -u test -pTest#2025 -e "CREATE DATABASE IF NOT EXISTS test_db; SHOW DATABASES;"
echo ✅ 测试数据库 test_db 已创建 
)
pause

以上步骤完成后，即可在浏览器访问您的 ThinkPHP 5 应用。如遇问题，请优先检查 IIS 日志及 PHP 错误日志。