PHPCMS 安装教程
PHPCMS 是一款基于 PHP + MySQL 开发的网站管理系统,以其稳定、高效和易于扩展而闻名,本教程将指导您如何一步步完成 PHPCMS 的安装。

第一步:环境准备(至关重要)
在开始安装之前,请确保您的服务器或本地环境满足 PHPCMS 的运行要求,推荐使用集成环境,如 phpStudy(Windows)或 MAMP(Mac),它们可以一键配置好所需环境。
最低系统要求:
- Web 服务器: Apache 2.x / Nginx 1.x
- 数据库: MySQL 5.0+ / MariaDB 5.0+
- PHP 版本: PHP 5.3 - PHP 7.4 (PHPCMS 9.x 版本不支持 PHP 8.0+,请务必注意)
- 操作系统: Linux, Windows, macOS
检查环境:
- 启动 Web 服务器和 MySQL 数据库,如果您使用 phpStudy,请确保 Apache 和 MySQL 服务都已启动。
- 检查 PHP 版本,在浏览器中访问
http://localhost/phpinfo.php(如果您的网站根目录下没有这个文件,可以创建一个包含<?php phpinfo(); ?>内容的文件),查看页面中的 "PHP Version",确认版本在 5.3 到 7.4 之间。
第二步:下载 PHPCMS 安装包
- 官方下载地址:
- PHPCMS 官方网站:
http://www.phpcms.cn/ - 请在官网下载最新稳定版的 PHPCMS,PHPCMS 9.6.3。
- PHPCMS 官方网站:
- 下载后,您会得到一个压缩包,通常为
.zip或.rar格式。
第三步:上传并解压安装包
- 找到您的网站根目录,这通常是 Web 服务器配置的
DocumentRoot或webroot目录。- 如果您使用 phpStudy,默认根目录是
D:\phpStudy\WWW\(根据您的安装路径可能不同)。 - 如果您使用 MAMP,默认根目录是
/Applications/MAMP/htdocs/。
- 如果您使用 phpStudy,默认根目录是
- 将下载的 PHPCMS 压缩包上传到网站根目录。
- 您可以使用 FTP 工具(如 FileZilla)或直接将文件拖入 phpStudy 的
WWW文件夹。
- 您可以使用 FTP 工具(如 FileZilla)或直接将文件拖入 phpStudy 的
- 解压压缩包。
- 上传完成后,在您的根目录下会出现一个类似
phpcms9或phpcms_v9的文件夹。 - 重要操作:将该文件夹内的所有文件和子文件夹剪切或复制到网站根目录(
WWW文件夹)下,然后删除空的phpcms9文件夹。 - 最终效果:所有 PHPCMS 文件都应直接位于
http://localhost/可以访问的目录中,而不是在http://localhost/phpcms9/子目录下。
- 上传完成后,在您的根目录下会出现一个类似
第四步:创建数据库
PHPCMS 需要一个独立的数据库来存储网站数据。

- 登录数据库管理工具:
- 如果您使用 phpStudy,点击菜单栏的 "MyAdmin",即可进入 phpMyAdmin。
- 如果您有独立服务器,通常通过
http://您的服务器IP/phpmyadmin访问。
- 创建新数据库:
- 在 phpMyAdmin 的主界面,点击顶部的 "新建"。
- 输入数据库名称,
phpcms_db。 - 选择 "排序规则"(Collation),对于中文网站,推荐选择
utf8mb4_general_ci或utf8mb4_unicode_ci。 - 点击 "创建" 按钮。
第五步:开始安装(Web 向导)
您可以通过浏览器访问安装程序了。
- 打开浏览器,在地址栏输入:
http://您的域名或IP/install.php- 如果您的网站在本地,输入:
http://localhost/install.php
- 如果您的网站在本地,输入:
- 进入安装向导,您会看到欢迎界面,点击 "同意" 或 "下一步"。
- 环境检测:
- 系统会自动检测您的 PHP、MySQL 等环境。
- 如果所有项目都显示 “通过”,则继续。
- 如果有 “不通过” 的项目(通常是
php.ini中的配置项),您需要修改php.ini文件后重启 Apache 服务,常见需要开启的扩展有:pdo_mysql,gd,curl等。
- 配置数据库信息:
- 数据库主机: 通常是
localhost。 - 数据库用户名: 您的数据库用户名,默认可能是
root(本地环境)。 - 数据库密码: 您的数据库密码。
- 数据库名: 您在第三步创建的数据库名,
phpcms_db。 - 数据库表前缀: 可以使用默认的
v9_,也可以自定义,如果您在同一数据库中安装多个 PHPCMS,请修改此前缀以避免冲突。 - 管理员账号: 设置您的后台登录用户名,
admin。 - 管理员密码: 设置一个复杂的后台登录密码。
- 确认密码: 再次输入密码。
- 邮箱: 填写您的邮箱,用于找回密码等。
- 填写完毕后,点击 "提交"。
- 数据库主机: 通常是
- 执行安装:
- 系统会根据您提供的信息创建数据表并写入初始数据,这个过程很快,几秒钟即可完成。
- 安装成功后,会显示一个成功页面。
第六步:安装后配置与访问
- 删除安装目录:
- 这是非常重要的一步! 为了网站安全,安装成功后,请务必删除服务器上的
install文件夹及其所有内容。
- 这是非常重要的一步! 为了网站安全,安装成功后,请务必删除服务器上的
- 访问网站:
- 前台访问:在浏览器中输入
http://您的域名或IP/,您应该能看到 PHPCMS 的默认首页。 - 后台访问:在浏览器中输入
http://您的域名或IP/phpcms/,使用您刚刚设置的管理员账号和密码登录。
- 前台访问:在浏览器中输入
常见问题与解决方案 (FAQ)
Q1: 安装时提示 "PHP 版本过低" 或 "PHP 版本过高"?
- 原因:您的 PHP 版本不在 PHPCMS 支持的范围内(5.3 - 7.4)。
- 解决:
- 如果版本过低,请升级 PHP。
- 如果版本过高(如 PHP 8.0+),PHPCMS 9.x 官方不支持,您需要降级 PHP 版本,或者寻找为 PHP 8+ 修改过的第三方版本(不推荐,可能有安全风险)。
Q2: 安装时提示 "无法连接到数据库"?
- 原因:
- MySQL 服务未启动。
- 数据库用户名或密码错误。
- 数据库主机不是
localhost(例如是0.0.1)。 - 数据库用户没有创建数据库的权限。
- 解决:逐一检查以上配置项,确保信息完全正确。
Q3: 安装时提示 "目录不可写" 或 "文件没有写入权限"?

- 原因:Web 服务器(如 Apache/Nginx)对
caches,phpcms,statics等目录没有写入权限。 - 解决:
- 使用 FTP 工具或服务器命令行,将这些目录的权限设置为 755 或 777。
- 在 Linux 服务器上,可以使用以下命令:
chmod -R 755 /您的网站根目录/phpcms/ chmod -R 755 /您的网站根目录/caches/ chmod -R 755 /您的网站根目录/statics/
- 在 Windows 服务器上,右键点击文件夹 -> "属性" -> "安全" -> "编辑",给予 "Users" 或 "IIS_IUSRS" "修改" 和 "读取" 权限。
Q4: 安装完成后,后台或前台页面样式错乱、图片不显示?
- 原因:通常是
statics目录权限问题,导致 CSS、JS、图片等静态资源无法被正确加载。 - 解决:按照 Q3 的方法,确保
statics目录及其子目录有正确的写入和读取权限。
Q5: 如何更新 PHPCMS?
- 注意:PHPCMS 9.x 已停止官方更新,存在安全风险,如果需要更新,请从官网下载新版本,然后覆盖文件(注意:覆盖前务必备份数据库和网站文件!),然后访问
update.php执行数据库升级脚本,这是一个高风险操作,新手不建议轻易尝试。
恭喜您!至此,您已经成功安装了 PHPCMS,接下来您可以登录后台,开始搭建和配置您的网站了。
