赞片CMSdatabase配置

照着做完，你就能独立给赞片CMS配好数据库——从全新安装时填表单，到装好后改配置文件、换服务器迁库，再到把常见的连不上、502、乱码问题自己排掉。下面按顺序走。

第一步：先把数据库信息备齐

这一步要做的是「拿到六样东西」，没备齐后面填表一定卡住。赞片CMS（基于 ThinkPHP 5.1 内核）连接数据库需要：数据库地址、端口、库名、用户名、密码、表前缀。

在宝塔面板里操作的话：左侧菜单点「数据库」→「添加数据库」，数据库名填 zanpian，用户名填 zanpian_user，密码点「随机」再复制到记事本，字符集选 utf8mb4，访问权限选「本地服务器」。添加完成后列表里会显示这套信息，端口默认 3306。

不用面板的话，在服务器命令行执行：

CREATE DATABASE zanpian DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
GRANT ALL PRIVILEGES ON zanpian.* TO 'zanpian_user'@'localhost' IDENTIFIED BY '你的密码';
FLUSH PRIVILEGES;

注意：赞片CMS的安装程序只建表、不建库。库必须你自己先手动创建，否则安装第二步会直接报 Unknown database。

第二步：在安装向导里填数据库

这一步做完，数据表会自动导入，站点就能跑起来。浏览器访问 http://你的域名/install/index.php，依次过「环境检测」「目录权限」，到第三步「数据库配置」，逐项填：

• 数据库地址：填 127.0.0.1
• 端口：3306
• 数据库名：zanpian
• 用户名：zanpian_user
• 密码：第一步复制的那串
• 表前缀：默认 zp_，建议加个随机后缀，比如 zp8x_
• 编码：utf8mb4

填完点「下一步」，程序会自动写入配置文件并导入 install/data/install.sql。

注意：数据库地址不要填 localhost。在 PHP 7.2 以上环境里，localhost 可能走 socket 连接，而 MySQL 用户授权是按 'zanpian_user'@'localhost' 或 @'127.0.0.1' 分开记的，两者不匹配就会报 1045 拒绝访问。统一用 127.0.0.1 最省事。

注意：如果卡在这一步转圈，多半是 install.sql 太大被 PHP 限制截断。去宝塔「软件商店」→「PHP 7.4」→「配置修改」，把 upload_max_filesize 和 post_max_size 都改成 64M，保存后重启 PHP。

第三步：安装完后改配置

装好之后想换库名、换密码，改的就是配置文件，不用重装。文件位置在网站根目录下的 application/database.php，用宝塔「文件」管理器双击编辑，它返回的是一个 PHP 数组：

return [
    'type'     => 'mysql',
    'hostname' => '127.0.0.1',
    'database' => 'zanpian',
    'username' => 'zanpian_user',
    'password' => '你的密码',
    'hostport' => '3306',
    'prefix'   => 'zp8x_',
    'charset'  => 'utf8mb4',
    'debug'    => false,
];

对照你的真实信息逐项核对，保存即可。

注意：改完必须清缓存，否则页面还是读旧配置。删掉根目录下的 runtime 文件夹（整个删，程序会自己重建），或在宝塔文件管理器里右键 →「权限」把属主设为 www。

注意：prefix（表前缀）必须和你当初安装时填的一字不差。填错了会提示「表 zp_xxx 不存在」，看着像数据库连不上，其实是前缀对不上。

第四步：换服务器时迁移数据库

先把老库导出，再导入新库。命令行导出：

mysqldump -u zanpian_user -p zanpian > /tmp/zanpian.sql

上传到新服务器后导入：

mysql -u zanpian_user -p zanpian < /tmp/zanpian.sql

导入前确认新库已建好，字符集是 utf8mb4。导完把老站点的 application/database.php 也一并拷到新站对应位置。

注意：不要用 phpMyAdmin 导入超过 20M 的 SQL，容易超时中断，留下半截数据。命令行导入没有这个限制。导入完成后在 phpMyAdmin 里点开库，确认表数量和老站一致。

第五步：按报错对症排查

连接类问题基本就这几种，对号入座：

改完任一项，记得再删一次 runtime 目录。

小结

• 库要自己先建，字符集统一 utf8mb4。
• 数据库地址写 127.0.0.1，不写 localhost。
• 全新安装走 /install/index.php；装完再改就编辑 application/database.php。
• 表前缀必须和安装时一致，改错会误报成连不上。
• 每次改完配置，删 runtime 清缓存。
• 迁移用 mysqldump 导出、命令行导入，别用 phpMyAdmin 啃大文件。