第一部分:环境准备
在安装 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 用户:
(图片来源网络,侵删)- 宝塔面板:功能强大的服务器管理面板,图形化操作,安装软件非常方便,同样,在安装 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格式的压缩包。
上传文件到服务器
- 启动您的集成环境(如 phpStudy),并启动 Apache 和 MySQL 服务。
- 找到网站根目录:
- 在 phpStudy 中,点击“网站” -> “管理” -> “打开根目录”,通常会打开
WWW或www文件夹。 - 宝塔面板中,默认网站根目录是
/www/wwwroot/。
- 在 phpStudy 中,点击“网站” -> “管理” -> “打开根目录”,通常会打开
- 解压并上传:
- 将下载的 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。
- 将下载的 PHPCMS V9 压缩包(
第三部分:运行安装向导
所有文件准备就绪后,就可以开始安装了。
-
打开浏览器,在地址栏输入您的网站地址。
(图片来源网络,侵删)- 如果您将文件直接放在
WWW根目录下,请访问:http://localhost/ - 如果您放在了
my_cms文件夹下,请访问:http://localhost/my_cms/
- 如果您将文件直接放在
-
进入安装界面: 正确访问后,浏览器会自动跳转到 PHPCMS V9 的安装向导页面,如果一切正常,您会看到欢迎界面和安装协议。
-
环境检测: 安装程序会自动检测您的服务器环境是否符合要求。
- 绿色勾 (✓):表示此项正常。
- 红色叉 (✗):表示此项不满足要求,安装将无法继续。最常见的问题就是 PHP 版本过高或不支持,请返回您的集成环境(phpStudy)中切换到正确的 PHP 版本,然后重启 Apache 服务,再刷新此页面。
- 黄色感叹号 (!):表示此项为警告,通常不影响安装,但可能影响部分功能(如文件权限),建议根据提示进行修复。
-
设置网站信息: 通过环境检测后,进入设置网站信息的步骤。
- 网站名称:您网站的标题,我的第一个 PHPCMS 网站”。
- 网站路径:通常保持默认 即可。
- 默认数据表前缀:为了防止数据库冲突,可以修改默认的
v9_为您自己的前缀,my_,如果不确定,保持默认即可。 - 网站管理员账号:您登录后台的用户名,建议使用复杂一点的字母数字组合。
- 网站管理员密码:您的后台登录密码,一定要设置得足够安全。
- 管理员邮箱:用于找回密码等。
- 网站根目录:安装程序会自动检测并填写,通常无需修改。
- 网站数据目录:用于存放上传的附件等,保持默认即可。
-
创建数据库: 在此步骤,安装程序会尝试自动连接并创建数据库,如果失败,您需要手动创建。
- 自动创建:输入您的 MySQL 数据库用户名 和 密码(通常是 phpStudy 的默认用户名
root和密码root或mysql),如果数据库用户有创建数据库的权限,安装程序会自动创建一个名为phpcms的数据库。 - 手动创建(推荐新手):
- 点击“手动创建数据库”链接。
- 在新页面或标签页中,登录您的数据库管理工具(phpStudy 自带的 phpMyAdmin)。
- 在 phpMyAdmin 中,点击“新建”。
- 输入数据库名称(
phpcms),排序规则 选择utf8_general_ci或utf8mb4_general_ci,然后点击“创建”。 - 返回安装页面,刷新一下,然后输入您刚刚创建的数据库名和对应的用户名密码。
- 自动创建:输入您的 MySQL 数据库用户名 和 密码(通常是 phpStudy 的默认用户名
-
开始安装: 确认所有信息无误后,点击“开始安装”按钮,安装程序会开始写入数据,进度条会走完。
-
安装完成: 安装成功后,会显示一个“安装成功”的页面,并提示您删除
/install目录。
第四部分:后续配置与首次登录
-
删除安装目录: 这是非常重要的一步,可以防止他人通过安装脚本攻击您的网站。
- 通过 FTP 工具或文件管理器(如宝塔面板的文件管理器),登录您的服务器。
- 进入网站根目录,找到
install文件夹,将其彻底删除。
-
访问网站: 删除
install目录后,在浏览器中再次访问您的网站地址(如http://localhost/),您应该就能看到 PHPCMS V9 的默认首页了。 -
登录后台管理系统:
- 在网站首页的底部,通常会有一个“登录后台”的链接。
- 或者直接在网站地址后面加上
/index.php?m=admin,http://localhost/index.php?m=admin - 输入您在安装时设置的管理员账号和密码,点击“登录”。
-
修改网站信息: 首次登录后台后,建议您进行一些基本设置:
- 系统设置 -> 站点管理:修改站点名称、域名、网站路径等。
- 系统设置 -> 管理帐号:修改初始管理员密码或添加新的管理员。
- -> 栏目管理:开始创建您的网站栏目,如“首页”、“关于我们”、“新闻中心”等。
常见问题与解决方法
-
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 服务。
- A: 这通常是 PHP 配置问题,在 phpStudy 中,点击“其他菜单选项” -> “打开配置文件” ->
-
Q: 后台登录后,页面显示错乱或部分功能无法使用。
- A: 检查浏览器缓存,尝试清除缓存或使用无痕模式访问,也可能是权限问题,确保网站目录(
WWW)对 Web 服务器(如 Apache 的www-data用户或Everyone用户)有读写权限。
- A: 检查浏览器缓存,尝试清除缓存或使用无痕模式访问,也可能是权限问题,确保网站目录(
恭喜您!至此,PHPCMS V9 已经成功安装并可以正常使用了,接下来您就可以开始填充内容,搭建属于您自己的网站了。
