第一部分:环境准备

在安装 PHPCMS V9 之前,您需要确保您的服务器或本地环境满足其运行要求。

phpcms v9安装教程
(图片来源网络,侵删)

系统要求

  • Web 服务器:Apache (推荐) 或 Nginx 或 IIS
  • 数据库:MySQL 5.0+ 或 MariaDB 5.0+
  • PHP 版本PHP 5.3 到 PHP 7.4 (特别注意:PHPCMS V9 不兼容 PHP 8.x,如果使用 PHP 8,安装过程会失败或出现严重问题)
  • 其他:需要开启 PHP 的 GD 库(用于处理图片)和 MySQL 扩展。

环境搭建

对于新手来说,手动配置环境比较复杂,推荐使用一键集成环境包,它们已经内置了所有所需软件,并做了优化。

推荐集成环境:

  • Windows 用户

    • phpStudy:非常流行,界面友好,支持切换多个 PHP 版本。请务必在软件设置中将 PHP 版本切换到 5.3 ~ 7.4 之间
    • WampServer:经典的老牌环境,同样易于使用。
  • Linux 用户

    phpcms v9安装教程
    (图片来源网络,侵删)
    • 宝塔面板:功能强大的服务器管理面板,图形化操作,安装软件非常方便,同样,在安装 PHP 时选择合适的版本。
  • macOS 用户

    • MAMP:macOS 平台下的首选集成环境。

本教程将以 phpStudy (Windows) 为例进行讲解,其他环境的操作逻辑基本相同。


第二部分:下载与上传

下载 PHPCMS V9

  • 访问 PHPCMS 的官方网站或官方 GitHub 仓库。
  • 官方网站下载地址https://www.phpcms.cn/download/
  • 官方 GitHub 仓库https://github.com/phpcms/phpcms
  • 在官网上找到 PHPCMS V9 的最新稳定版下载链接,下载下来是一个 .zip.rar 格式的压缩包。

上传文件到服务器

  1. 启动您的集成环境(如 phpStudy),并启动 Apache 和 MySQL 服务。
  2. 找到网站根目录
    • 在 phpStudy 中,点击“网站” -> “管理” -> “打开根目录”,通常会打开 WWWwww 文件夹。
    • 宝塔面板中,默认网站根目录是 /www/wwwroot/
  3. 解压并上传
    • 将下载的 PHPCMS V9 压缩包(phpcms_v9.6.3_UTF8.zip先在本地电脑上解压
    • 您会得到一个名为 phpcms_v9.6.3_UTF8 的文件夹。
    • 重要:将这个文件夹内的所有文件和文件夹复制并粘贴到您的网站根目录(WWW 文件夹)中。
    • 简化操作:您也可以直接将整个解压后的文件夹(如 phpcms_v9.6.3_UTF8)上传到根目录,然后将其重命名为一个您喜欢的项目名,my_cms,这样您的网站访问地址就是 http://localhost/my_cms

第三部分:运行安装向导

所有文件准备就绪后,就可以开始安装了。

  1. 打开浏览器,在地址栏输入您的网站地址。

    phpcms v9安装教程
    (图片来源网络,侵删)
    • 如果您将文件直接放在 WWW 根目录下,请访问:http://localhost/
    • 如果您放在了 my_cms 文件夹下,请访问:http://localhost/my_cms/
  2. 进入安装界面: 正确访问后,浏览器会自动跳转到 PHPCMS V9 的安装向导页面,如果一切正常,您会看到欢迎界面和安装协议。

  3. 环境检测: 安装程序会自动检测您的服务器环境是否符合要求。

    • 绿色勾 (✓):表示此项正常。
    • 红色叉 (✗):表示此项不满足要求,安装将无法继续。最常见的问题就是 PHP 版本过高或不支持,请返回您的集成环境(phpStudy)中切换到正确的 PHP 版本,然后重启 Apache 服务,再刷新此页面。
    • 黄色感叹号 (!):表示此项为警告,通常不影响安装,但可能影响部分功能(如文件权限),建议根据提示进行修复。
  4. 设置网站信息: 通过环境检测后,进入设置网站信息的步骤。

    • 网站名称:您网站的标题,我的第一个 PHPCMS 网站”。
    • 网站路径:通常保持默认 即可。
    • 默认数据表前缀:为了防止数据库冲突,可以修改默认的 v9_ 为您自己的前缀,my_,如果不确定,保持默认即可。
    • 网站管理员账号:您登录后台的用户名,建议使用复杂一点的字母数字组合。
    • 网站管理员密码:您的后台登录密码,一定要设置得足够安全
    • 管理员邮箱:用于找回密码等。
    • 网站根目录:安装程序会自动检测并填写,通常无需修改。
    • 网站数据目录:用于存放上传的附件等,保持默认即可。
  5. 创建数据库: 在此步骤,安装程序会尝试自动连接并创建数据库,如果失败,您需要手动创建。

    • 自动创建:输入您的 MySQL 数据库用户名密码(通常是 phpStudy 的默认用户名 root 和密码 rootmysql),如果数据库用户有创建数据库的权限,安装程序会自动创建一个名为 phpcms 的数据库。
    • 手动创建(推荐新手)
      1. 点击“手动创建数据库”链接。
      2. 在新页面或标签页中,登录您的数据库管理工具(phpStudy 自带的 phpMyAdmin)。
      3. 在 phpMyAdmin 中,点击“新建”。
      4. 输入数据库名称(phpcms),排序规则 选择 utf8_general_ciutf8mb4_general_ci,然后点击“创建”。
      5. 返回安装页面,刷新一下,然后输入您刚刚创建的数据库名和对应的用户名密码。
  6. 开始安装: 确认所有信息无误后,点击“开始安装”按钮,安装程序会开始写入数据,进度条会走完。

  7. 安装完成: 安装成功后,会显示一个“安装成功”的页面,并提示您删除 /install 目录。


第四部分:后续配置与首次登录

  1. 删除安装目录: 这是非常重要的一步,可以防止他人通过安装脚本攻击您的网站。

    • 通过 FTP 工具或文件管理器(如宝塔面板的文件管理器),登录您的服务器。
    • 进入网站根目录,找到 install 文件夹,将其彻底删除
  2. 访问网站: 删除 install 目录后,在浏览器中再次访问您的网站地址(如 http://localhost/),您应该就能看到 PHPCMS V9 的默认首页了。

  3. 登录后台管理系统

    • 在网站首页的底部,通常会有一个“登录后台”的链接。
    • 或者直接在网站地址后面加上 /index.php?m=adminhttp://localhost/index.php?m=admin
    • 输入您在安装时设置的管理员账号和密码,点击“登录”。
  4. 修改网站信息: 首次登录后台后,建议您进行一些基本设置:

    • 系统设置 -> 站点管理:修改站点名称、域名、网站路径等。
    • 系统设置 -> 管理帐号:修改初始管理员密码或添加新的管理员。
    • -> 栏目管理:开始创建您的网站栏目,如“首页”、“关于我们”、“新闻中心”等。

常见问题与解决方法

  • Q: 安装时提示 "PHP 版本不支持" 或 "环境检测失败"。

    • A: 这是最常见的问题,请检查您的 PHP 版本是否在 5.3 ~ 7.4 之间,在 phpStudy 等集成环境中切换到正确的 PHP 版本,并重启 Apache 服务。
  • Q: 安装时数据库连接失败,提示 "Access denied for user 'root'@'localhost' (using password: YES)"。

    • A: 检查您输入的数据库用户名和密码是否正确,如果您忘记密码,可以在 phpStudy 的“数据库管理”->“MySQL设置”中找回或重置 root 密码。
  • Q: 访问网站时出现 "No input file specified." 错误。

    • A: 这通常是 PHP 配置问题,在 phpStudy 中,点击“其他菜单选项” -> “打开配置文件” -> php.ini,找到 cgi.fix_pathinfo 这一行,确保其值为 1,如果被分号 注释了,请去掉分号,然后重启 Apache 服务。
  • Q: 后台登录后,页面显示错乱或部分功能无法使用。

    • A: 检查浏览器缓存,尝试清除缓存或使用无痕模式访问,也可能是权限问题,确保网站目录(WWW)对 Web 服务器(如 Apache 的 www-data 用户或 Everyone 用户)有读写权限。

恭喜您!至此,PHPCMS V9 已经成功安装并可以正常使用了,接下来您就可以开始填充内容,搭建属于您自己的网站了。