ThinkPHP新手第一课：从Composer安装到完成首次Hello World【教程】

刚装好PHP环境的新手，执行composer create-project topthink/think myapp后打开浏览器，结果只看到一片空白或者500错误，连个“Hello World”的影子都没有——别急着怀疑自己代码写错了，真相通常很简单：项目没放在Web能访问到的路径下，PHP扩展没开全，或者入口文件没被正确路由。这三个坑踩一个，页面就罢工。

确认PHP与Composer已就绪

先打开终端，跑两行命令验证环境。第一行：php -v，输出里要能看见PHP 7.4+（ThinkPHP 8强制要求），而且版本号后面必须带(NTS)标识。如果提示“命令未找到”，说明PHP没加入系统PATH，得回去重配环境变量。第二行：composer --version，返回类似Composer version 2.7.x才算正常；报command not found？那就重新安装Composer，安装时记得勾选“Add to PATH”。

这两步只要有一个失败，后面的操作全部白搭。别觉得这一步能跳过，直接建项目等于往空硬盘里拷数据——毫无意义。

用Composer创建ThinkPHP项目

推荐做法：直接在你Web服务器的根目录下执行，比如XAMPP的htdocs、PHPStudy的WWW、Nginx的/var/www/html。敲完cd /var/www/html再跑composer create-project topthink/think tp8，一气呵成。

如果你打算用PHP内置服务器开发（省去Apache/Nginx），那可以在任意目录创建，但启动时得手动把public目录设为文档根。比如：mkdir ~/mytp && cd ~/mytp，然后composer create-project topthink/think .，完成后再cd public，最后php -S localhost:8000 -t public启动。

关键前提：创建之前最好先配置国内镜像，否则下载可能卡死或超时。执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。这一步漏掉的话，下载thinkphp主包可能花10分钟以上，甚至直接失败。

启用必需的PHP扩展

ThinkPHP 8运行依赖三个扩展：curl、fileinfo、mbstring。少一个都不行，控制器加载不了，模板解析也会挂。

找到你的php.ini文件（用php --ini可以查到位置），搜索以下三行，确保每行前面的分号;已经被删掉：

extension=curl
extension=fileinfo
extension=mbstring

改完保存，重启Web服务或者PHP-FPM进程。Windows用户注意：如果用的是PHPStudy或小皮面板，最好在软件界面里直接勾选对应扩展，别只改ini文件——面板会覆盖手动修改的配置。

让Hello World真正显示出来

第一步：进入项目app/controller目录，新建一个IndexController.php，内容如下：

namespace appcontroller;
class IndexController{
    public function index(){
        return 'Hello World!';
    }
}

第二步：确保public/index.php存在并且没有被改动——ThinkPHP 8默认自带这个入口文件，别删、别改名、别挪位置。

第三步：通过浏览器访问。如果项目在htdocs/tp8下，就输入http://localhost/tp8/public/index.php；如果用内置服务器启动的，直接访问http://localhost:8000。

看到页面上显示纯文本Hello World!，恭喜，成功了。如果还是空白，去php.ini里检查display_errors = On和error_reporting = E_ALL是否开启，然后刷新页面，看看有没有致命错误的具体信息。很多时候，问题就藏在最后那几行报错里。