宝塔面板 PHP + SQL 源码搭建保姆级教程

摘要生成中

AI生成，仅供参考

本教程适用于大多数 PHP 源码（如博客、商城、企业官网等）的通用搭建流程。请确保您已安装好宝塔面板并能正常登录。

第一阶段：环境准备

在宝塔面板左侧菜单点击 [软件商店]，搜索并安装以下必要组件：

• Nginx： 推荐安装 1.22 或更高版本。
• MySQL： 推荐安装 5.7（兼容性最强）。
• PHP： 根据源码要求选择版本，通用建议安装 7.4 或 8.1。
• phpMyAdmin： 数据库网页管理工具，必备。

第二阶段：创建站点与数据库

1. 点击左侧菜单 [网站] -> [添加站点]。
2. 填写 [域名]（若无域名可暂时填写服务器 IP）。
3. 数据库项选择 [MySQL]。
4. 设置完成后，点击提交。

⚠️ 非常重要：
站点创建成功后，系统会弹窗显示数据库名、用户名和密码。请务必截图或复制保存到记事本，后续修改配置文件时必须用到。

第三阶段：源码上传与解压

1. 在网站列表找到刚创建的站点，点击其 [根目录地址] 进入文件管理器。
2. 全选并删除目录下自带的 index.html、404.html 等默认文件。
3. 点击 [上传] -> 选择本地的源码压缩包（通常为 .zip 格式）。
4. 上传完成后，右键压缩包选择 [解压]。

检查点： 确保解压后的 index.php 文件直接在根目录下，而不是嵌套在多层文件夹内。

第四阶段：导入数据库文件 (.sql)

1. 点击面板左侧 [数据库] 菜单。
2. 找到刚才创建的数据库，点击 [管理]，系统将跳转至 phpMyAdmin。
3. 在 phpMyAdmin 顶部点击 [导入] 选项卡。
4. 点击 [选择文件] -> 选中源码包里的 .sql 数据库文件。
5. 拉到页面最下方，点击 [执行]，提示导入成功即可。

第五阶段：修改源码配置文件 (核心步骤)

源码需要连接到数据库才能正常运行，通常需要修改配置文件：

1. 回到文件管理器，寻找配置文件（常见名称如下）：
   • config.php / database.php / .env / data/conf/db.php
2. 右键该文件选择 [编辑]，修改以下核心参数：

// 数据库地址，通常保持 127.0.0.1
define('DB_HOST', '127.0.0.1'); 

// 填写您在第二阶段记录的数据库名
define('DB_NAME', '你的数据库名'); 

// 填写您在第二阶段记录的用户名
define('DB_USER', '你的用户名'); 

// 填写您在第二阶段记录的密码
define('DB_PWD', '你的数据库密码');

第六阶段：针对特殊框架的额外设置

1. 伪静态设置

如果您的源码使用了 ThinkPHP、Laravel 或 WordPress 框架，必须设置伪静态：

• 点击 [网站] -> [设置] -> [伪静态]。
• 在下拉框中选择对应的框架模板，点击 [保存]。

2. 运行目录设置

部分源码要求运行目录为 /public：

• 点击 [网站] -> [设置] -> [网站目录]。
• 在 [运行目录] 下拉框选择 /public，点击 [保存]。

3. 权限修复

如果遇到页面无法写入或 500 错误，请在文件管理器全选所有文件，点击右上角 [权限]，设置为 755，所有者设为 www。

环境检查与测试脚本

如果网站无法打开，可以在根目录新建一个 test.php 文件，粘贴以下代码并访问 域名/test.php 进行排查：

<?php
$host = "127.0.0.1";
$db_user = "你的数据库名";
$db_pass = "你的数据库密码";
$db_name = "你的数据库名";

$conn = new mysqli($host, $db_user, $db_pass, $db_name);

if ($conn->connect_error) {
    die("数据库连接失败: " . $conn->connect_error);
}
echo "环境配置正常，数据库连接成功！";
?>