ThinkPHP 5.0.24 安装成功的关键是Web服务器根目录必须指向public文件夹,而非项目根目录;否则会因入口文件路径错误导致base.php加载失败或404。

ThinkPHP 5.0.24 安装到本地环境,关键不是“能不能装”,而是“路径对不对、入口找不找得到”。很多报错(比如 Failed opening required '...base.php' 或 404)其实都不是框架没下载好,而是 Web 服务器没指向正确的入口目录。
确认 PHP 环境满足最低要求
TP5.0.24 要求 PHP 版本 ≥ 5.4.0,推荐使用 PHP 5.6–7.3(注意:PHP 7.4+ 在部分扩展或调试场景下可能触发兼容性问题,尤其搭配旧版 phpStudy 或 xdebug 时)。需启用以下扩展:
- php_mbstring
- php_opcache(可选,但建议开启提升性能)
- php_curl、php_gd2、php_xml、php_json(多数现代环境已默认启用)
选择安装方式并执行
两种主流方式,推荐优先用「完整版 ZIP 包」,路径清晰、无 Composer 依赖干扰:
-
方式一:官网完整包(最稳)
去 ThinkPHP 官网下载页,找到 5.0.24 完整版 ZIP 包,解压到本地目录(如D:\phpEnv\www\tp5)。解压后结构含application/、public/、thinkphp/等文件夹。 -
方式二:Composer 安装(适合熟悉 CLI 的用户)
确保系统 PATH 已包含 PHP 可执行路径,然后在目标目录运行:composer create-project topthink/think tp5 5.0.24
注意:此方式生成的thinkphp/在vendor/topthink/thinkphp,入口文件public/index.php必须包含require __DIR__.'/../vendor/autoload.php';。
配置 Web 服务器根目录为 public
这是最容易出错的一步。TP5.0 强制统一入口,所有请求必须经由 public/index.php 处理:
立即学习“PHP免费学习笔记(深入)”;
-
phpEnv / phpStudy / XAMPP 等集成环境:进入控制面板 → 站点管理 → 编辑你的站点 → 将「网站根目录」明确设为项目内
public文件夹路径(例如D:\phpEnv\www\tp5\public),保存后重启 Apache/Nginx。 -
手动配置 Apache/Nginx:确保
DocumentRoot指向your_project_path/public,且已开启mod_rewrite(Apache)或配置好try_files(Nginx)以支持 URL 重写。
验证是否成功
完成上述步骤后,在浏览器访问:
- 若配置了虚拟主机(如
tp5.test),直接打开http://tp5.test/ - 若用 localhost,默认路径是
http://localhost/(前提是根目录已设为public)
看到 ThinkPHP 5.0 的蓝色欢迎页,即表示安装成功。此时可以运行 php think version(需在项目根目录,非 public)验证命令行工具是否可用。



















