赞片CMSFAQ

学完这篇你能得到：从安装到播放器配置，快速排查赞片CMS v2.0的常见问题，让影视站正常上线。

第一步：安装赞片CMS，得到可访问的后台

这一步要做什么：把源码传到服务器并完成安装，得到能登录的后台地址。下载赞片CMS v2.0 正式版，解压后把 upload 文件夹里的所有文件上传到网站根目录（如 /www/wwwroot/你的域名）。在浏览器访问 http://你的域名/install/index.php，进入安装向导。环境检测页要求 PHP 7.2 以上、MySQL 5.6 以上，扩展需要 fileinfo、curl、gd。数据库填写：数据库地址 localhost，数据库名、用户名、密码按你宝塔面板里创建的填。管理员账号默认 admin，密码自己设。安装完成后，删除 install 目录。

注意：如果安装页空白，检查 PHP 版本是否低于 7.2，或开启 debug 看报错。

第二步：登录后台并修改基础设置

这一步要做什么：登录后台，把网站名称、域名、模板改好，得到符合自己品牌的站点。访问 http://你的域名/admin.php，输入安装时设置的管理员账号密码。进入后台后，左侧菜单依次点：系统 -> 基本设置。在“网站名称”填你的站名，“网站域名”填 https://你的域名，“网站模板”选 default。点底部“保存配置”按钮。然后点：系统 -> 伪静态，选择“赞片CMS专用规则”，复制规则内容。

注意：后台路径如果被改过，默认是 /admin.php，可在根目录的 config/route.php 里查。

第三步：配置播放器和采集接口，让视频能播

这一步要做什么：添加播放器解析接口，并设置采集资源，得到能播放的视频页面。后台左侧菜单：视频 -> 播放器管理 -> 添加播放器。播放器名称填“赞片云播”，播放器编码填 zanpian，解析接口填 https://api.example.com/parse?url= （换成你购买的解析接口）。类型选“解析播放”。保存。再点：采集 -> 采集资源 -> 添加资源，资源名称填“资源站A”，接口地址填资源站提供的XML地址，绑定播放器选“赞片云播”。点“测试采集”确认能拉到数据。

注意：解析接口失效会导致所有视频黑屏，定期在播放器管理里更新接口地址。

第四步：解决前台404和页面错乱

这一步要做什么：配置伪静态和缓存，得到正常显示的前台页面。如果是宝塔面板，点网站 -> 设置 -> 伪静态，把第二步复制的规则粘贴进去，保存。如果是 Nginx，在站点配置文件里加：location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; } }。然后后台：系统 -> 缓存管理 -> 清除全部缓存。前台刷新，分类页、播放页应正常。

注意：修改伪静态后要重启 Nginx 或 Apache，否则规则不生效。

第五步：常见报错速查

这一步要做什么：遇到报错时快速定位。数据库连接失败：打开 config/database.php，核对 hostname、database、username、password。模板不显示：检查 /template/default 目录权限是否为 755，所有者是否为 www。播放器提示“未找到播放地址”：去后台视频 -> 播放器管理，把解析接口的 http 改成 https，或换一个接口。采集重复：在采集 -> 采集设置里，把“重复内容”选为“跳过”。

注意：赞片CMS v2.0 不支持 PHP 8.0，请用 PHP 7.4。

小结

• 安装时用 PHP 7.2-7.4，装完删 install 目录。
• 后台入口 /admin.php，先改基本设置和伪静态。
• 播放器解析接口决定视频能否播放，失效就换。
• 404 先查伪静态规则和缓存。
• 数据库报错查 config/database.php。