PHPCMS V9视频模块从零配置实操指南 新手零门槛直接上手

一、前置准备

本文适配目前主流使用的PHPCMS V9版本，默认完整安装包已经自带视频模块，如果你的源码缺失视频模块，可以直接从官方仓库下载模块包，下载地址：https://gitee.com/phpcms/phpcms_v9/raw/master/modules/video.zip

下载完成后解压，把得到的video文件夹上传到你网站根目录的/modules/目录下，给video文件夹设置服务器读写权限为755，完成前置准备。

二、后台安装与基础参数配置

1. 模块安装步骤

• 登录你的PHPCMS V9后台，访问地址为你的域名/admin.php，输入安装时设置的账号密码登录
• 点击左侧导航栏的扩展 → 模块管理，在已下载模块列表中找到「视频」模块
• 点击模块右侧的「安装」按钮，弹出确认安装弹窗后直接点击确定，等待系统自动创建数据库表，提示「模块安装成功」即完成安装

2. 基础参数配置

安装完成后点击视频模块右侧的「配置」按钮，进入配置页按以下要求填写参数：

• 视频保存路径：默认值为/uploadfile/video/，无需修改，如果需要存储到其他目录，填写从网站根目录开始的绝对路径即可，注意必须给目标目录设置755权限，否则无法上传视频
• 允许上传视频格式：默认值为mp4,flv，如果需要支持其他格式，直接追加即可，格式为逗号分隔，不要加空格，示例：mp4,flv,webm,mov
• 最大上传大小：单位为KB，默认是102400（即100MB），可根据需求修改，例如填写512000就是500MB；注意这里的限制不能超过你服务器php.ini中upload_max_filesize和post_max_size的配置，否则修改不生效
• 默认播放器：直接选择内置的CKPlayer即可，免费开源兼容性好，无需额外下载

填写完成后点击「确定」保存配置即可。

三、播放器参数配置

PHPCMS内置的CKPlayer可自定义适配不同场景，配置步骤如下：

1. 点击左侧导航栏视频 → 播放器管理，找到CKPlayer点击右侧的「编辑」按钮
2. 按以下常用配置填写：
   • 播放器宽度：填写100%，即可自适应内容区域宽度，不用固定像素值
   • 播放器高度：宽度为100%时填写500px即可，移动端会自动适配
   • 自动播放：需要打开页面自动播放选「是」，否则选「否」
   • 显示弹幕：不需要直接关闭，需要开启按提示填写弹幕接口即可
3. 点击「确定」保存配置即可完成播放器设置。

四、创建视频栏目与发布内容

1. 创建视频栏目

• 点击左侧导航栏内容 → 栏目管理，点击「添加栏目」按钮
• 填写栏目名称，最关键的一步是：栏目类型必须选择「视频模型」，选成文章模型会无法发布视频内容，很多新手会在这里出错
• 按需填写SEO标题、关键词等信息，点击「提交」即可完成栏目创建。

2. 发布视频内容

• 点击左侧刚创建的视频栏目，点击「添加视频」按钮
• 填写视频标题、简介后，找到「视频上传」选项，点击「上传」按钮选择本地视频，等待上传完成后系统会自动填充视频地址
• 如果视频存储在第三方云存储，直接把视频播放地址填入对应输入框即可，不需要本地上传
• 选择对应分类后点击「提交」，视频内容就发布成功了。

五、前台视频列表调用方法

如果使用默认模板，添加导航后会自动生成视频列表页和详情页；如果需要自定义调用视频列表，可直接复制以下调用标签到模板中：

``` {pc:content action="lists" catid="$catid" num="10" order="id DESC" modelid="4"}

{loop $data $r}
• {$r[title]} {date('Y-m-d',$r[inputtime])}
{/loop}

{/pc} ```

说明：默认视频模型ID为4，如果修改过模型ID，可以到后台内容 → 模型管理中查看视频模型的实际ID，替换代码中modelid的值即可。

六、常见问题排查

• 上传视频提示失败：优先检查视频存储目录权限是否为755，其次检查php.ini的上传大小限制是否大于视频体积，最后检查服务器磁盘空间是否充足。
• 前台播放提示找不到视频：检查视频保存路径配置是否正确，视频地址是否带正确的域名协议，和当前网站的HTTP/HTTPS是否一致。
• 模块管理找不到视频模块：检查video文件夹是否上传到了正确的位置，必须是网站根目录下的/modules/目录，上传后点击模块管理页面的刷新按钮即可。
• 移动端播放器变形：可以给播放器外层容器添加以下CSS代码实现16:9自适应：

  .video-container{
  position:relative;
  padding-bottom:56.25%;
  height:0;
  overflow:hidden;
  }
  .video-container iframe{
  position:absolute;
  top:0;
  left:0;
  width:100%;
  height:100%;
  }
  

按照以上步骤操作，即可完成整个视频模块的配置，所有步骤无额外依赖，新手也可以一次配置成功。