PHPCMS 安装这活,最怕你拿 PHP 8 硬怼,它不是新程序,PHPCMS V9 这套老系统,环境选对就成功一半,下面按顺序做,别跳步,新手也能从零搭起来。
适用人群说明
这篇适合刚接触 CMS 建站的新手、用宝塔或 phpStudy 面板的人、需要复刻老 PHPCMS 站点的人,以及维护旧企业站、资讯站、门户站的人,如果你准备做全新项目,并且没有老模板、老插件包袱,我不建议优先选 PHPCMS;但如果你必须用,就按 PHP 5.6 + MySQL 5.6/5.7 这套老环境来。

PHPCMS安装全流程,新手照着做,从环境到后台一次搭通
先选对服务器环境
宝塔面板:安装 Nginx 或 Apache、MySQL 5.6/5.7、PHP 5.6,PHP 扩展里确认开启 mysql、mysqli、pdo_mysql、gd、curl、openssl、mbstring、json、xml、zip,不要用 PHP 7.4、PHP 8.0 去装,大概率白屏或报 mysql_connect() 未定义。
phpStudy:用 phpStudy 2016/2018 这类支持 PHP 5.6 的版本,切换 PHP 5.6,启动 Apache/Nginx 和 MySQL,本地测试就把域名绑到 0.0.1。
创建站点和数据库
宝塔里点“网站”->“添加站点”,域名填测试域名或服务器 IP,根目录例如 /www/wwwroot/phpcms.test,PHP 版本选 5.6,同时创建数据库,字符集选 utf8 或 utf8_general_ci,记下数据库名、用户名、密码。
本地环境就在 phpStudy 里创建数据库,名字建议用 phpcms,密码不要带奇怪符号,避免安装时连接失败。
上传 PHPCMS 安装包
下载 PHPCMS V9 安装包后解压,把里面的 install、admin.php、index.php、phpcms、statics、api 等文件和目录放到站点根目录,注意不要多套一层文件夹,否则你访问的可能是 /phpcms/install/index.php,而不是正确的 /install/index.php。
设置目录权限
Linux 宝塔环境可执行:
cd /www/wwwroot/phpcms.test
chown -R www:www .
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
chmod -R 777 caches uploadfile html phpsso_server/caches
Windows 环境不用敲命令,给站点目录 Users 写入权限即可,安装完成后,别长期保留 777,只让 caches、uploadfile、html 保持可写。
运行安装向导
浏览器访问:
http://你的域名/install/index.php
第一步同意协议;第二步环境检测,PHP 版本、MySQL 扩展、GD 库、目录权限必须通过,有红叉就先修;第三步填数据库信息:主机 localhost,端口 3306,数据库名、用户名、密码按刚才创建的填,表前缀建议把默认 v9_ 改成 cms_ 或随机前缀,网站名称、管理员账号、密码、邮箱填好;第四步点安装,完成后记下后台地址,通常是:
http://你的域名/admin.php
安装后必须收尾
第一,删除或重命名 install 目录,防止被人重新安装,第二,登录后台改管理员密码,第三,更新缓存,第四,在系统设置里填站点域名、附件地址,第五,设置伪静态或生成静态,第六,备份数据库和站点目录,后台入口 admin.php 也建议改名,并限制访问 IP。
配置要点
PHP 建议 5.6,MySQL 建议 5.6/5.7,字符集统一 utf8。php.ini 里把 upload_max_filesize、post_max_size 调到 20M 以上,memory_limit 调到 128M 以上,max_execution_time 调到 300,date.timezone 设为 Asia/Shanghai,伪静态规则不对时,新手先用动态 URL,再后台生成静态,不要一上来死磕 rewrite。
常见踩坑提醒
- PHP 7/8 安装报错:换 PHP 5.6,别硬修。
- 安装页 404:检查安装包是不是多了一层目录。
- 数据库连接失败:检查 localhost、端口、账号密码、权限,MySQL 8 可能不兼容。
- 提示无法写入:检查
caches、uploadfile、html权限和所有者。 - 安装 SQL 报错:临时关闭 MySQL 严格模式,或换 MySQL 5.7。
- 验证码不显示:开 GD 库,检查 session 目录权限。
- 后台登录又跳回:清 cookie,统一带 www 和不带 www 的域名。
- 上传图片失败:改 PHP 上传限制,给
uploadfile写入权限。 - 安装后首页 404:检查默认首页、伪静态和静态生成。
- 安全漏洞:PHPCMS V9 已很老,公网生产要删 install、改后台、强密码、套 WAF、勤备份。
按这套流程走,PHPCMS安装 并不玄学,难的是环境选对和权限收尾,先在本地或测试站跑通,再迁移到正式服务器,稳得多。
发表评论