1. 环境准备与框架安装
第一次接触ThinkPHP6可能会被各种配置项吓到,但实际搭建过程比想象中简单得多。我去年接手一个电商项目时,仅用半小时就完成了基础框架搭建。下面分享的步骤已经过滤掉所有不必要的环节,只保留最核心的操作路径。
1.1 基础环境检查
ThinkPHP6对运行环境有明确要求:PHP版本≥7.2.5且需要开启PDO扩展。建议使用php -v命令检查当前版本,如果不符合要求,推荐用Docker快速搭建环境。这里有个小技巧:在命令行运行php -m | grep pdo可以快速验证PDO扩展是否启用。
1.2 Composer的魔法
Composer是PHP世界的包管理器,相当于Node.js的npm。安装时有个常见坑点:国内网络可能连接不上官方源。我通常用这个命令切换阿里云镜像:
bash复制composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
安装框架时,很多人习惯直接克隆仓库,但更规范的做法是:
bash复制composer create-project topthink/think myproject
这个命令会自动完成三件事:创建myproject目录、下载核心框架、初始化基础目录结构。记得把myproject换成你的项目名,比如我就喜欢用项目缩写+年份的命名方式。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 调试模式与首次访问
2.1 开发环境配置
框架默认处于生产模式,这对开发者很不友好。打开调试模式有个隐藏技巧:复制根目录下的.example.env文件并重命名为.env,这个文件已经预设了APP_DEBUG=true。有次我忘记这个步骤,调试了半天才发现是模式问题。
2.2 访问路径解析
首次访问时很多人会被这个URL搞懵:
code复制http://localhost/myproject/public/index.php/index/index
其实它对应的是:
- myproject/public:入口文件所在目录
- index.php:前端控制器
- 第一个index:控制器名
- 第二个index:方法名
建议立即配置虚拟主机指向public目录,这样后续访问
