1. 环境准备搭建PHP开发环境如果你是第一次接触PHP开发可能会被各种环境配置搞得头晕眼花。别担心我用过最简单的方法就是使用PHPStudy这个集成环境工具。它就像是一个开发环境大礼包把Apache、MySQL、PHP这些必备组件都打包好了一键安装就能用。我建议下载最新版的PHPStudy目前V8版本对FastAdmin的支持最好。安装过程就是典型的下一步大法但有几个细节要注意安装路径不要有中文和空格我习惯放在D:\phpstudy_pro安装完成后记得右键以管理员身份运行首次启动时会提示安装VC运行库一定要同意安装安装完成后你会看到这样的界面----------------------------- | Apache 2.4.39 | | MySQL 5.7.26 | | PHP 7.3.4nts | -----------------------------这里有个坑我踩过如果你电脑上原来装过MySQL一定要先在服务里停掉原来的MySQL服务否则端口冲突会导致启动失败。可以在cmd里运行net stop mysql2. 获取FastAdmin安装包现在我们去FastAdmin官网下载最新版。有个小技巧不要下载核心版要下载完整版因为核心版缺少很多前端依赖。下载完成后你会得到一个类似fastadmin_v1.3.3.zip的压缩包。解压这个包到phpstudy的www目录下我建议重命名文件夹为项目名称比如D:\phpstudy_pro\www\myadmin这里有个细节很多新手会直接解压到www根目录导致路径变成D:\phpstudy_pro\www\fastadmin-1.3.3\这样后面配置虚拟主机会很麻烦。3. 配置虚拟主机这一步是很多新手容易出错的地方。打开PHPStudy的网站选项卡点击创建网站关键配置如下域名建议用.test后缀比如fastadmin.test不用.com避免和真实域名冲突根目录必须指向public文件夹比如D:\phpstudy_pro\www\myadmin\public端口默认80如果被占用可以改成8080PHP版本选择7.3-7.4之间的版本点击保存后PHPStudy会自动修改hosts文件。如果遇到权限问题可以手动编辑C:\Windows\System32\drivers\etc\hosts添加127.0.0.1 fastadmin.test4. 安装FastAdmin框架现在打开浏览器访问http://fastadmin.test/install.php你会看到安装界面。需要填写的主要信息有数据库配置数据库名自己起个名字比如fastadmin_db用户名rootPHPStudy默认密码root如果没改过的话管理员账号用户名建议不用默认的admin密码要足够复杂至少8位含大小写和数字点击安装后如果出现绿色提示安装成功恭喜你已经完成90%了但根据我的经验这时候最容易出现两个问题数据库连接失败检查MySQL是否启动密码是否正确目录不可写去项目根目录右键属性给Users组添加写入权限5. 验证安装结果安装完成后你可以通过以下方式验证前台访问http://fastadmin.test 应该能看到默认的欢迎页面后台登录http://fastadmin.test/admin 用刚才设置的管理员账号登录数据库检查 在PHPStudy里打开phpMyAdmin应该能看到新建的数据库和几十张表6. 常见问题排查我在帮团队新人部署时最常遇到的几个问题页面显示404检查Apache的rewrite模块是否开启确认.htaccess文件在public目录下静态资源加载失败可能是伪静态没配置好在public/static/目录检查文件权限后台登录无限跳转清除浏览器缓存检查session目录是否可写7. 开发环境优化建议为了让开发更顺畅我推荐做这几个优化开启调试模式 修改.env文件APP_DEBUG true安装IDE助手composer require --dev topthink/think-ide-helper配置Xdebug 在PHPStudy里切换PHP版本选择设置-PHP扩展-勾选Xdebug这套环境我已经在十几个项目中验证过从个人学习到小型团队开发都能胜任。刚开始可能会遇到一些小问题但按照这个流程走半小时内肯定能搞定开发环境。