phpstudy添加站点、绑定域名及配置伪静态的详细步骤

Miles
Miles
发布时间:2026-10-20| 13人浏览过
原创

刚下载好 phpStudy,兴致勃勃想跑个新项目,结果发现默认的那个 localhost 根本不够用。要么是想模拟线上的多站点结构,要么是框架路由需要伪静态支持,直接扔进根目录往往报错 404 或者样式全乱。别急,其实只要理清“创建站点”、“hosts 映射”和“重写规则”这三步,本地环境就能像服务器一样听话。

1. 创建站点并指定根目录

打开 phpStudy 面板,点击左侧菜单的“网站”选项。这里列出了当前所有的本地站点。点击右下角的“创建网站”按钮,会弹出一个配置窗口。

phpstudy添加站点、绑定域名及配置伪静态的详细步骤

phpStudy 创建网站配置窗口,显示域名、根目录和端口设置

在弹窗中,“域名”一栏先填一个你打算在本地使用的地址,比如 test.local。“根目录”是关键,点击文件夹图标,选择你项目代码所在的文件夹。注意,最好直接选到包含 index.php 或 public 文件夹的那一级,不要多选或少选层级。端口号默认是 80,如果没被占用就保持不动;如果被占用了,改个 8080 之类的也行,但访问时得带上端口号。点击“确定”,站点就建好了。

2. 绑定本地域名

站点建好了,浏览器输入刚才填的域名却打不开?这是因为电脑还不知道 test.local 指向本机。我们需要修改系统的 hosts 文件。

phpStudy 通常自带了 hosts 修改工具。在面板首页或工具页找到“hosts”选项,点击打开。你会看到一行行 IP 和域名的对应关系。在末尾添加一行:

127.0.0.1 test.local

保存后,建议刷新一下 DNS 缓存。Windows 用户可以在命令行输入 ipconfig /flushdns,或者直接重启浏览器。这时候再访问 test.local,应该能看到你项目里的内容了。如果还是不行,检查一下防火墙是否拦截了 80 端口,或者换个浏览器试试。

phpstudy添加站点、绑定域名及配置伪静态的详细步骤

在 hosts 文件中添加本地域名映射记录

3. 配置伪静态规则

很多现代 PHP 框架(如 Laravel、ThinkPHP)都依赖伪静态来隐藏 index.php,实现美观的 URL。如果没配好,点击二级页面就会报 404 错误。

回到 phpStudy 的“网站”管理页,找到你刚才创建的站点,点击“管理”或“设置”。在弹出的详情页中,找到“伪静态”或“Rewrite”选项卡。

phpstudy添加站点、绑定域名及配置伪静态的详细步骤

phpStudy 站点管理中的伪静态规则选择界面

这里通常有几个预设模板,比如“thinkphp”、“laravel”、“wordpress”。如果你的框架在列表里,直接选中并保存即可。如果不在,或者你想自定义,可以选择“自定义”或手动编辑配置文件。

对于 Nginx 环境,常见的通用规则如下:

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
        break;
    }
}

对于 Apache 环境,则是在 .htaccess 文件中启用 mod_rewrite:

<IfModule mod_rewrite.c>
  Options +FollowSymlinks -Multiviews
  RewriteEngine On
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]
</IfModule>

保存配置后,记得点击面板上的“重启”按钮,让 Nginx 或 Apache 重新加载配置。这时候再去点击项目里的内页链接,应该就能正常跳转了。

phpstudy添加站点、绑定域名及配置伪静态的详细步骤

点击重启按钮使配置生效

4. 常见问题排查

如果配置完还是有问题,先看 phpStudy 的“日志”选项。Nginx 的错误日志通常会明确告诉你是权限问题、文件不存在还是语法错误。比如 403 Forbidden 往往是根目录没有 index 文件或者权限不足;500 Internal Server Error 则可能是伪静态规则写错了,导致死循环。

另外,确保你的项目代码本身没有硬编码线上域名。有些框架在 .env 配置文件中需要设置 APP_URL 为 http://test.local,否则生成的链接可能还是指向线上地址,导致资源加载失败。

本地环境折腾通了,上线时只需把域名解析到服务器 IP,并在服务器端重复类似的伪静态配置即可。phpStudy 的价值就在于把这些复杂的服务器配置可视化了,多用几次,你对 Web 服务器的理解也会更深。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。