十分钟学会苹果CMS手动采集资源全流程实操

一、环境基础配置与权限检查

在开始手动采集之前，必须确保服务器环境配置能够支撑采集任务的运行，否则极易出现超时或写入失败的问题。请按照以下步骤逐一检查。

1. PHP配置文件修改

找到服务器上的 php.ini 文件，通常位于 /etc/php/7.4/fpm/php.ini 或类似路径。需要修改以下三个核心参数，以支持大批量数据采集和较长的执行时间：

```ini max_execution_time = 600 memory_limit = 512M post_max_size = 128M ```

修改完成后，必须重启PHP服务或Nginx/Apache服务使配置生效。若使用宝塔面板，请在“软件商店”->“PHP设置”->“配置修改”中直接修改并重载配置。

2. 目录权限设置

通过SSH终端或文件管理器，检查苹果CMS根目录下的 runtime 文件夹及其子目录权限。必须赋予写入权限，否则采集进度无法保存。

```bash chmod -R 755 runtime chown -R www:www runtime ```

二、添加自定义采集资源库

苹果CMS v10版本默认不自带资源库，需要手动添加。采集依赖于标准的资源API接口，接口格式通常为XML或JSON。

1. 获取资源站API地址

准备一个可用的资源站API地址。为了保证实操演示的准确性，这里以标准API结构为例。请确保API地址末尾包含必要的参数，例如：

```text https://example.com/api.php/provide/vod/at/xml/?ac=list ```

2. 后台添加接口

登录苹果CMS后台，点击顶部菜单栏的“采集”，选择左侧子菜单的“自定义资源”。

• 点击“添加资源”按钮。
• 资源名称：输入便于识别的名称，如“测试资源01”。
• 接口地址：粘贴上一步获取的API地址。注意：不要包含多余的空格。
• 类型：根据接口类型选择，通常选择“xml”或“json”。
• 是否播放：选择“是”。
• 状态：选择“启用”。

填写完毕后，点击“保存”。

3. 测试接口连通性

在资源列表中，找到刚添加的条目，点击右侧操作栏的“测试”按钮。系统会尝试请求该接口。如果返回“连接成功”并显示了接口返回的分类信息，则表示接口配置无误；如果提示错误，请检查服务器防火墙是否允许外部请求，或API地址是否需要特殊鉴权。

三、分类映射与绑定规则

这是新手最容易出错的一步。资源站的分类ID（如动作片ID为1）与你本地网站的分类ID（如动作片ID为5）通常不一致。如果不进行绑定，采集的数据可能会分类混乱。

1. 进入分类绑定页面

在“自定义资源”列表中，点击对应资源站的“操作”列中的“绑定”按钮。

2. 执行绑定操作

页面左侧显示的是资源站的分类，右侧显示的是你本地网站的分类。

• 勾选左侧资源站的分类，例如“电影”。
• 在右侧下拉框中，选择本地网站对应的“电影”分类。
• 点击中间的“添加”或“绑定”按钮。

重复此操作，将“电视剧”、“综艺”、“动漫”等所有需要的分类一一对应绑定。绑定完成后，列表下方会显示当前的映射关系。建议全选资源站分类进行绑定，防止漏采。

四、执行手动采集操作

配置好接口和分类后，即可开始正式采集。苹果CMS提供了“当天”、“本周”、“全部”等筛选条件，手动采集建议从“全部”开始，以便一次性建立数据库。

1. 启动采集任务

点击顶部菜单“采集”->“自定义采集”。

• 选择资源：在下拉菜单中选择刚才配置好的资源库名称。
• 选择分类：选择“全部”或具体分类。
• 日期范围：选择“全部”。

点击页面底部的“开始采集”按钮。

2. 监控采集过程

系统会弹出一个命令行窗口或直接在当前页面显示采集日志。观察日志输出，正常的日志格式如下：

```text [开始] 正在获取第1页数据... [成功] 获取到20条数据 [处理] 正在入库: 电影 - 战狼 [成功] 入库成功 ```

如果出现大量红色的“失败”或“Error”提示，通常是网络超时或数据格式异常。此时应停止采集，检查PHP配置中的max_execution_time是否过短，或者该资源站API暂时失效。

3. 分页采集处理

苹果CMS采集默认是自动翻页的。但如果资源站数据量巨大，建议分批次采集。例如，先采集“电影”分类，成功后再采集“电视剧”。这样可以避免单次PHP进程执行时间过长导致意外中断。

五、采集数据入库与清洗

数据采集完成后，只是进入了“采集库”或临时表，还需要执行“入库”操作，数据才会真正显示在网站前台。

1. 进入入库管理

点击顶部菜单“采集”->“入库管理”。这里可以看到所有已采集但未正式发布的资源列表。

2. 数据筛选与去重

在入库页面，顶部有筛选选项。

• 播放器类型：选择“全部”或指定播放器（如m3u8, mp4）。
• 数据状态：选择“未入库”。

3. 执行入库

• 点击列表下方的全选复选框，选中所有待入库数据。
• 在“操作”下拉菜单中选择“入库”。
• 点击“执行”。

系统会自动将数据写入mac_vod数据表。如果遇到“数据已存在”的提示，说明该视频已经在库中，系统会自动跳过或根据设置进行覆盖更新。

4. 生成播放页面

数据入库后，为了确保前台能正常访问，建议生成相关静态页（如果开启了伪静态或缓存）。点击顶部菜单“生成”->“生成播放页”，选择“全部”并执行。这一步能确保新采集的影片播放地址被正确解析。

六、常见报错与解决方案

在实操过程中，遇到特定报错代码时，请参照以下方案直接处理。

1. 采集提示“cURL error 7: Failed to connect”

这是网络连接问题。检查服务器的php.ini中allow_url_fopen = On是否开启。如果是阿里云/腾讯云服务器，检查安全组规则是否放行了80/443端口出站流量。

2. 采集提示“XML parse error”

这表示资源站返回的数据不是标准的XML格式。可能是资源站挂了，或者返回了404/500错误页HTML。请先用浏览器直接访问API地址，查看返回内容是否正常。

3. 入库时提示“字段过长”

部分资源站的简介或备注字段极长，超过了数据库默认限制。需要修改数据库表结构，进入MySQL数据库，执行：

```sql ALTER TABLE `mac_vod` MODIFY `vod_blurb` TEXT; ALTER TABLE `mac_vod` MODIFY `vod_remarks` VARCHAR(255); ```

4. 采集后前台不显示

检查“视频模型”设置。进入“系统”->“视频模型”，确保对应分类绑定的模型是正确的，且模型状态为“显示”。清空浏览器缓存和CMS后台缓存（系统->“系统清理”）。