# 影源指南 CMS v1.3.2

基于 Apache、PHP 与 MySQL 的影视资源站信息目录 CMS。系统用于整理资源站名称、网址、介绍、兼容程序、标签、访问状态及发布状态，不包含影视文件采集、下载或播放功能。

## 运行环境

- Apache 2.4+，建议启用 `mod_rewrite`、`mod_headers`
- PHP 8.1+
- PHP 扩展：`pdo_mysql`、`mbstring`、`json`、`curl`
- Excel `.xlsx` 导入额外需要：`zip`、`SimpleXML`
- MySQL 5.7+ 或 MySQL 8.0+

服务器没有 `zip` 或 `SimpleXML` 时，仍可使用 CSV 表格导入。

## 新安装

1. 将程序上传到网站根目录。
2. 确保网站根目录在安装期间可写。
3. 访问 `https://你的域名/install.php`。
4. 填写数据库和管理员信息。
5. 安装完成后删除或重命名 `install.php`。
6. 后台地址为 `https://你的域名/admin/`。前台不显示后台入口。

## 从 v1.3.0 或更早版本升级

1. 备份网站文件和数据库。
2. 保留原有 `config.php`。
3. 用 v1.3.2 文件覆盖旧文件。
4. 从 v1.2.0 或更早版本升级时，首次访问会自动添加 `resources.publish_status` 并将历史数据保持为“已发布”。
5. 数据库账号没有 `ALTER` 权限时，请先在 phpMyAdmin 中执行 `database/upgrade_v1.3.0.sql`；`database/upgrade_v1.3.1.sql`、`database/upgrade_v1.3.2.sql` 可用于依次补写 Logo 设置。
6. 根目录首页会自动恢复为动态 `index.php`，旧版由 CMS 生成的 `html/index.html` 会被清除；进入“后台 → 静态页面”重新生成详情静态页。

## 表格导入

后台进入：

```text
后台 → 表格导入
```

支持：

- Excel `.xlsx`
- UTF-8 CSV `.csv`
- 单次最多 2000 条
- 文件最大 5MB

模板文件：

```text
templates/resource-import-template.xlsx
templates/resource-import-template.csv
```

必填字段：

```text
站点名称
站点网址
```

可选字段：分类、Logo地址、摘要、详细介绍、支持程序、标签、访问状态、需要特殊网络、推荐、首页精选、热度分。

所有表格导入数据都强制保存为“待发布”。网址重复、名称或网址无效的行会跳过，并在导入结果中显示原因。

原 JSON 导入也已改为“待发布”，不能通过 JSON 直接绕过发布审核。

## 手动发布

进入“后台 → 资源站管理”，可以：

- 筛选待发布和已发布数据
- 单条发布
- 勾选多条后批量发布
- 编辑待发布数据后再发布

前台首页、搜索、标签、详情页和静态页只读取“已发布”数据。发布时若已经启用静态页面，系统会自动重建 `html/`。

## 每天定时发布

进入：

```text
后台 → 定时发布
```

可以设置：

- 是否启用
- 每天发布时间
- 每天发布数量（1–100）

发布顺序按照待发布数据的创建时间，由早到晚发布。每天只执行一次。

Linux Cron 示例：

```cron
*/5 * * * * /usr/bin/php /www/wwwroot/你的站点目录/cron/publish_pending.php >/dev/null 2>&1
```

宝塔也可创建“访问 URL”计划任务。后台定时发布页面会自动生成带令牌的 URL。建议任务每 5 分钟执行一次，脚本会自行判断是否到达设定时间。

## 静态页面

静态文件统一生成在：

```text
html/中文站名全拼.html
```

网站首页不生成静态文件，根目录始终由 `index.php` 动态输出。发布待发布数据时，如检测到 `html/.cinecollect-static`，系统只重建所有已发布资源站的详情静态页。搜索、筛选、投稿、点赞、中转页和后台继续使用动态 PHP。升级后，系统会自动删除旧版本生成且带 CMS 标记的 `html/index.html`。

## 网址检测

后台可手动检测或通过 `cron/check_urls.php` 定时检测。连续失败达到后台设定阈值后，资源站会标记为“已失效”；恢复访问后会自动恢复为“正常访问”。

## v1.3.0 前台调整

- 前台页脚移除“管理后台”链接。
- 中转页仍保留倒计时和跳转功能，但不再显示安全性提示文案。
- 详情页和投稿页不再显示安全性提示文字。
- 全站继续保持无圆角样式。

## v1.3.2 PNG Logo 设置

网站头部 Logo 统一使用 PNG。进入“后台 → 站点设置”可填写以 `.png` 结尾的图片地址，或上传 PNG 文件（最大 2MB）。上传后固定保存为 `uploads/site-logo.png`，默认图片位于 `assets/demo/site-logo.png`。上传检测不再依赖 `finfo` 扩展，替换后会自动刷新浏览器缓存。

服务器必须保证 `uploads/` 目录可写。Linux/宝塔环境可根据实际 Web 用户设置目录权限，例如：

```bash
chmod 775 uploads
```