ThinkPHP运行需四要素：PHP解释器（TP6推荐8.0+、TP8要求≥8.0.0）、Web服务器（Apache/Nginx）、数据库（如MySQL）、Composer依赖管理器，缺一不可；安装须用composer create-project命令，禁用手动ZIP或require，且DocumentRoot必须指向public目录。
ThinkPHP本身是PHP框架，不是开箱即用的“软件”，它需要一套基础运行环境才能工作。搭建一个可运行的ThinkPHP应用，核心不是装“ThinkPHP”，而是配齐支撑它的底层工具链。
关键点很明确：PHP解释器、Web服务器、数据库、Composer依赖管理器，四者缺一不可。
必备基础工具清单
PHP 7.2.5 或更高版本（TP6推荐PHP 8.0+，TP8要求PHP ≥8.0.0）
ThinkPHP无法脱离PHP独立运行。建议使用PHP 8.1或8.2，兼顾性能、安全与兼容性。
✅ 验证方式：终端执行php -v，看到版本号且无报错即通过。Web服务器（Apache 或 Nginx）
用于接收HTTP请求并转发给PHP处理。
⚠️ 注意：Apache需启用mod_rewrite模块；Nginx需配置try_files规则支持URL重写（.htaccess对Nginx无效）。
✅ 推荐新手用集成环境（如phpStudy、XAMPP、WampServer），自带Apache/Nginx+PHP+MySQL一键启停。数据库（MySQL / MariaDB / PostgreSQL / SQLite）
ThinkPHP默认适配MySQL，多数项目从MySQL起步。
✅ 安装后确保服务正在运行（如Windows下phpStudy面板中MySQL显示“已启动”），并能通过命令行或客户端连接。-
Composer（必须）
TP6及以后版本完全依赖Composer安装与管理依赖，手动下载ZIP包会缺失vendor/目录，直接报错Class 'think\App' not found。
✅ 验证方式：终端执行composer --version，返回版本号即安装成功。
? 国内用户建议切换镜像源加速：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
常见集成环境安装实操（Windows/macOS/Linux通用）
phpStudy（Windows/macOS）
下载官网最新版（注意避开带“广告插件”的非官方渠道），安装时勾选PHP 8.0+、Apache/Nginx、MySQL即可。
安装完成后：
▪ 启动面板 → 开启Apache和MySQL；
▪ “网站” → “添加站点”，根目录指向你的ThinkPHP项目中的public/子目录；
▪ 自动获得域名（如http://tp.local），无需改hosts。XAMPP（全平台）
官网下载安装包，运行控制面板启动Apache和MySQL。
将ThinkPHP项目（如tp6/）放入xampp/htdocs/，再通过浏览器访问http://localhost/tp6/public/即可。
⚠️ Apache需确认已加载rewrite模块（httpd.conf中LoadModule rewrite_module modules/mod_rewrite.so未被注释）。-
Linux（Ubuntu/Debian为例）命令行安装
sudo apt update sudo apt install apache2 php8.1 php8.1-mysql php8.1-curl php8.1-xml php8.1-mbstring php8.1-zip unzip git sudo systemctl start apache2 sudo systemctl enable apache2 sudo apt install mysql-server sudo mysql_secure_installation # 初始化MySQL安全设置 curl -sS https://getcomposer.org/installer | php sudo mv composer.phar /usr/local/bin/composer
安装ThinkPHP项目的标准流程
-
打开终端，进入Web根目录（如
~/htdocs或/var/www/html）立即学习“PHP免费学习笔记（深入）”；
-
执行创建命令（以TP6为例）：
composer create-project topthink/think myapp
myapp是你的项目文件夹名，执行后自动生成完整结构。
Workflow Decomposer下载工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
确保
runtime/目录可写（Linux/macOS）：chmod -R 755 myapp/runtime/
Windows用户检查IIS/Apache运行账户对该目录有写权限。
-
启动内置服务器快速验证（无需配Apache/Nginx）：
cd myapp php think run
浏览器打开
http://localhost:8000，看到ThinkPHP欢迎页即成功。 （可选）启用调试模式：将项目根目录下的
.example.env重命名为.env，其中APP_DEBUG=true已默认开启。
容易卡住的几个细节
- ❌ 不要在
app/或public/目录下执行php think run—— 必须在项目根目录（含think可执行文件的位置）； - ❌ Apache虚拟主机配置中，
DocumentRoot必须指向your_project/public/，不是项目根目录； - ❌
.env文件名开头是英文点（.），Windows资源管理器可能隐藏扩展名，务必用编辑器（如VS Code）重命名，不要写成.env.txt； - ❌
php think报错“Could not open input file”，大概率是think文件缺少执行权限（Linux/macOS执行chmod +x think）。
不复杂但容易忽略，把这四样配齐、路径指对、权限设好，ThinkPHP就能稳稳跑起来。
