本地搭建网站源码,不必手动编译 Nginx、PHP、MySQL。Windows 推荐 PHPStudy 或 XAMPP,macOS 可用 MAMP,Linux 用户可直接装宝塔面板。下载安装后启动,确认 Apache/Nginx 与 MySQL 显示绿色运行状态即可。
放置源码与创建数据库
将下载的网站源码解压到网站根目录。PHPStudy 默认根目录为 WWW,宝塔为 /www/wwwroot。建议新建子文件夹,如 myweb,避免与默认页冲突。
打开 phpMyAdmin 或宝塔数据库面板,新建数据库,字符集选 utf8mb4。记下数据库名、用户名、密码。
配置数据库连接与伪静态
在源码目录找到配置文件,常见名称为 config.php、database.php 或 .env。用编辑器打开,填入刚才的数据库信息。若源码带 install 目录,可直接浏览器访问 http://localhost/myweb/install 按提示安装。
伪静态规则影响 URL 结构。宝塔面板可直接选“ThinkPHP”或“WordPress”规则;PHPStudy 需在站点设置中粘贴规则。没有伪静态时,页面可能 404。
本地域名与 hosts 绑定
默认用 localhost/myweb 访问即可。若源码强制绑定域名,可修改 hosts 文件:Windows 路径 C:\Windows\System32\drivers\etc\hosts,macOS 为 /etc/hosts。添加一行 127.0.0.1 www.test.com,再在 Web 服务器中绑定该域名。
常见报错与排查
- 数据库连接失败:检查用户名密码、端口(默认 3306)、是否允许本地访问。
- 页面空白:打开 PHP 错误显示,查看
php.ini中display_errors是否开启。 - 403 禁止访问:确认目录权限,Linux 下将网站目录所有者设为
www。 - 端口占用:80 端口被占用时,换 8080 并访问
localhost:8080。
安全提醒与后续建议
本地环境仅用于开发调试,不要直接暴露到公网。调试完成后,关闭错误显示、删除 install 目录、修改数据库默认前缀。需要上线时,再将源码与数据库迁移到服务器,并重新配置域名与 SSL 证书。

