快速绑定域名,本地项目访问一步到位
用phpstudy给本地项目绑定域名,核心就两步:修改系统hosts文件指向本机,再在phpstudy面板里添加域名并指定项目根目录。 整个过程无需重启电脑,全程鼠标操作加一次文件编辑,五分钟内就能完成。
绑定域名前需要准备什么
动手之前先确认三件事,免得中途卡壳,第一,你本地项目所在的绝对路径,D:\www\myproject 或者 /Users/name/www/demo,第二,想用的域名,本地开发一般推荐用 .test 或 .loc 结尾的,myproject.test,这类域名不会跟线上真实域名冲突,第三,phpstudy版本,目前主流是 phpStudy V8.1 和 phpStudy Pro,两者操作界面略有差异,下文会分别说明。
顺便说一句,很多新手在百度搜“phpstudy 域名绑定 本地”时,会以为要改Apache或Nginx的配置文件,其实在phpstudy图形化面板里操作是最省事的,配置文件系统会自动生成,你只需要理解原理即可。
第一步:修改hosts文件,让域名指向本机
hosts文件在哪里,怎么改
hosts文件是一个没有后缀名的系统文件,作用就是把域名和IP地址绑定,我们要做的就是把自定义域名解析到本地回环地址 0.0.1。
Windows系统路径是 C:\Windows\System32\drivers\etc\hosts,注意这个目录是受系统保护的,直接用记事本打开会提示没有权限,推荐用 管理员身份运行记事本,然后通过文件菜单打开这个路径下的hosts文件。
MacOS和Linux系统路径是 /etc/hosts,修改命令用 sudo vim /etc/hosts 或 sudo nano /etc/hosts。
打开后在文件末尾追加一行:
0.0.1 myproject.test
保存时如果Windows提示无权限,检查是否用了管理员身份运行编辑器,保存成功后可以验证一下:打开命令行输入 ping myproject.test,能看到回复来自 127.0.0.1 就说明hosts生效了,但如果之前开启过DNS缓存,MacOS可以用 sudo dscacheutil -flushcache 刷新,Windows在大部分情况下会自动生效,个别情况下需要 ipconfig /flushdns。
第二步:在phpstudy中添加域名和站点
phpStudy V8.1 的具体操作步骤
打开phpstudy主界面,左侧菜单栏选中“网站”选项卡,点击“创建网站”按钮,这里就是绑定的主战场。
弹出窗口里需要填写三项核心内容:
- 域名:填入刚才在hosts里写的
myproject.test,不带http前缀 - 端口:默认80,如果本机80端口被占用(比如被IIS或别的环境占用),改成 8080 或 8000
- 根目录:点击“选择目录”,指向你本地项目文件夹
D:\www\myproject
下方还有“PHP版本”下拉选项,根据你项目需要选择,比如ThinkPHP项目选7.4或更高版本,老项目可能要用5.6,其他设置保持默认即可,点击确定,站点就创建成功了。
phpStudy Pro 的操作区别
Pro版本左侧菜单改成了“首页”和“应用”两个大板块,需要先点击“应用”里的“Web环境管理”,然后找到“创建站点”按钮,后续填写内容跟V8.1基本一致,记住一点:不管哪个版本,域名和根目录是最核心的字段。
多项目如何绑定多个域名
一个phpstudy里可以同时跑多个项目,这就是网站开发中常说的“多站点”,每次添加一个项目,就重复一次上述操作hosts文件加一行,面板里创建一个站点,比如你再创建一个 second.test,hosts追加 0.0.1 second.test,面板里根目录指向另一个文件夹,两个项目互不干扰。
间距提示:本地多站点配置时,如果你用Nginx环境,phpstudy会自动生成对应的server块配置文件,路径一般在 V8.1安装目录\vhosts\ 目录下,命名规则是 域名.conf,不要去手动改 nginx.conf 主文件,只有项目需要特殊伪静态规则时,才去编辑该站点对应的配置文件。
绑定后访问不了是怎么回事
常见404错误,根目录选错了
比较常见的是打开域名后显示404 Not Found,这种情况一般是根目录定位不准,比如ThinkPHP项目,根目录应该指向 public 子目录,而不是项目外层,在phpstudy里创建站点时,根目录直接选到 D:\www\myproject\public,这样URL访问 myproject.test 才能正确路由到入口文件。
提示“您访问的域名未绑定”或 “站点创建成功但无法访问”
这个报错常常让phpstudy新手很头疼,多数情况是hosts文件域名和面板域名不一致,检查一下两者拼写是否完全一样,不带www也不带后缀斜杠,另一个可能性是同时开了多个环境软件,比如电脑上还装着XAMPP或WampServer,它们抢占了80端口,解决办法是把其他环境软件先停掉,或者在创建站点时给当前域名指定非80端口,8080,然后用 myproject.test:8080 访问。
网页能打开但样式丢失或图片打不开
这大概率不是域名问题,而是项目里的 APP_URL 或静态资源路径没改成对应域名,不少PHP框架的配置文件中写死了 http://localhost 前缀,绑定新域名后需要同步修改,以ThinkPHP6为例,需要在 .env 文件里调整相关配置项,然后把静态资源路径换成新域名。
补充的进阶配置:伪静态和SSL证书
伪静态规则如何选择
项目是TP框架、Laravel还是WordPress,伪静态规则不一样,在phpstudy网站列表中找到你的站点记录,点击“管理”按钮,选择“伪静态”或“配置”选项,phpstudy内置了常见的PHP框架和CMS的伪静态模板,选中对应的保存即可,如果没有现成模板,才需要手动把规则代码粘贴进去,复制代码时注意去掉前后多余空格。
本地想用HTTPS访问
本地开发有时也需要模拟线上HTTPS环境,比如微信支付回调调试,phpstudy Pro版本内置了SSL证书生成功能,在站点管理中点击“HTTPS配置”,选择“生成证书”,系统会自动给该域名签发一个本地证书,V8.1版本则可能需要借助 mkcert 工具生成自签名证书,然后把证书文件路径填到站点配置中,这个操作相对小众,需要时再去搜索相关教程即可,日常本地开发用HTTP就够。
端口冲突和防火墙问题
80端口被占用如何解决
这是phpstudy绑定域名后发现打不开页面的较常见原因,排查方法很直接:命令行执行 netstat -ano | findstr :80,Windows系统会列出占用80端口的进程PID,去任务管理器里找到对应进程,看是不是IIS或者SQL Server Reporting Services,解决方式是停止这些服务,或者在创建站点时把端口改成别的值,如果你是刚接触本地环境搭建的用户,直接改端口是最省事的,配合hosts绑定照样能达到类似线上域名的访问效果。
Windows防火墙拦截
有些时候域名和站点都配置正确,但浏览器就是打不开,此时要检查防火墙是否拦截了phpstudy的进程,在“Windows安全中心”的防火墙页面点“允许应用通过防火墙”,把phpStudy相关程序全部勾选上,内网局域网中其他电脑想访问你的本地项目,这一步更是不可缺少。
有域名的本地环境,开发效率能提升多少
用IP加端口访问本地项目是一种方式,但域名方式有个很实际的好处Cookie处理更友好,用 localhost 或者IP加端口,登录状态一跨项目就乱,域名天然隔离了Cookie作用域,另外前端开发调试时,有些第三方JS接口对安全域有校验,使用自定义域名可以模拟真实的线上请求环境,省掉不少临时绕过校验的时间,从开发习惯角度看,较早养成域名绑定习惯的人,切到线上部署时也不太会漏掉hosts和站点配置这些关键细节。
常见问题解答(Q&A)
phpstudy绑定域名后,网速会变慢吗
不会,本地域名解析通过hosts文件直接指向127.0.0.1,不经过外部DNS服务器,访问速度跟用localhost打开几乎没有差别,反而是使用IP端口模式时,部分浏览器对非标准端口的加载策略更保守,可能出现资源加载延迟的感觉。
我把域名绑到phpstudy上了,但手机通过局域网IP访问不了
手机访问本机项目有两种路径:一是手机和电脑连同一个WiFi,手机浏览器直接访问 电脑局域网IP:端口,访问前确保防火墙允许Apache或Nginx进程通过,二是想用域名访问,需要在手机端配置hosts文件,Android端需要root权限,iOS端越狱才有办法,实际操作门槛较高,多数开发者会选择第一种方式做移动端真机调试。
绑定域名时填了 www 前缀,还用单独添加不带 www 的吗
最好两个都加上,在hosts文件中添加两行,分别对应 www.myproject.test 和 myproject.test,phpstudy面板里可以创建两个站点记录,根目录指向同一个文件夹,否则用户手动输入完整域名多了个www,就会提示找不到站点,若项目本身有伪静态跳转逻辑,也可以只在面板中添加一个,让程序自动把带www的请求重定向到不带www的地址。
绑定域名的操作本身不复杂,但它是本地开发环境配置中承上启下的一个环节,hosts文件写清楚域名,面板里指向准确的根目录,端口保持畅通,三步做到位就基本不会有坑,每次新增项目时,记得按这个流程走一遍,本地开发和调试的效率比单纯用localhost高出不少。