PHP 版本与环境准备
MacCMS V10 安装前的 PHP 8.3 验证环境、PDO MySQL、curl、mbstring、GD 等扩展清单及网站 PHP 检查方法。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
先准备 PHP 8.3、MySQL 8.4 和 Apache 或 Nginx，再安装程序。本教程对官方 2026.1000.4056 使用 PHP 8.3.33 做隔离安装验证；面板请选择 PHP 8.3，不要直接使用旧教程的 PHP 5.5／5.6。
版本怎么选
| 项目 | 本教程使用 | 说明 |
|---|---|---|
| PHP | 8.3.33（8.3 分支） | 用于本次本地验证；第三方模板／插件仍需单独测试 |
| 数据库 | MySQL 8.4 | 创建独立数据库和用户；MariaDB 未在本轮验证 |
| Web 服务 | Apache 2.4（测试环境） | Nginx 部署还需配置 PHP 转发及伪静态 |
| 程序目录 | 包含 index.php 的目录 | 不是 application，也不是其他框架常用的 public 目录 |
上游 composer.json 的最低要求为 PHP 7.0，安装器仍写 5.5。那是最低门槛描述，不等于推荐环境；PHP 5.x／7.x 已不在 PHP 官方支持列表中。也不要由“>=7.0”推断所有 PHP 8.x 都兼容。
必须检查哪些扩展
| 名称 | 用途 | 缺失时常见现象 |
|---|---|---|
| PDO、pdo_mysql | 连接 MySQL | could not find driver、数据库检测失败 |
| curl | 网络请求、资源获取 | curl_init 未定义 |
| mbstring | 中文等多字节字符串 | mb_strlen 未定义 |
| fileinfo | 上传文件类型识别 | 上传检测报错 |
| zip | 压缩包读写 | ZipArchive 不存在 |
| GD | 验证码、图像处理 | 验证码空白或图片处理失败 |
| SimpleXML、libxml | XML 资源解析 | simplexml_load_string 未定义 |
| OpenSSL、session、json | HTTPS、会话、JSON | 安装 PHP 时通常自带，仍需确认可用 |
PDO、pdo_mysql、curl、zip、fileinfo 及 mb_strlen 是安装器检查项；GD、SimpleXML 等还关系到后续功能。安装器里的 xml 检查的是框架函数，不能代替 SimpleXML 检查。Redis、Memcached、ionCube 不是本教程基础安装的必选项；只有缓存方案或模板明确依赖时才加装。
在宝塔面板里检查
- 进入「网站」，打开这个站点的设置，先确认「PHP 版本」选择 8.3。
- 进入「软件商店 → 已安装 → PHP 8.3 → 设置 → 安装扩展」，安装缺少的 curl、mbstring、fileinfo、zip、GD 等。已编译进 PHP 的模块可能不会提供单独安装按钮。
- 保存后重载该 PHP 服务。在站点的 PHP 信息中核对版本和模块，不能只看另一版本的扩展列表。
- 命令行可用下面两条命令辅助检查；它们只代表 CLI，不能证明网站绑定的 PHP 相同。
php -v
php -m如何检查网站实际运行的 PHP
在仅本地访问的测试站根目录创建 env-check.php，写入下面代码，用浏览器访问 /env-check.php。输出应显示 PHP 8.3，列表全部为 OK。检查完删除此文件，不需要把整份 phpinfo 发到网上。
<?php
header('Content-Type: text/plain; charset=utf-8');
echo 'PHP: ' . PHP_VERSION . "\n";
foreach (['pdo','pdo_mysql','curl','mbstring','fileinfo','zip','gd','SimpleXML','openssl','session','json'] as $name) {
echo $name . ': ' . (extension_loaded($name) ? 'OK' : 'MISSING') . "\n";
}文件权限
PHP 执行用户需要写入 application/database.php、application/route.php、application/extra、application/data/backup、application/data/update、runtime 和 upload。安装还会在 application/data/install 写入锁文件。
面板文件管理器中核对这些文件的所有者与站点 PHP 用户一致。不要把整站设置为 777；出现不可写时先看路径、所有者和磁盘空间。
数据库准备与安装注意
创建空数据库 maccms_demo 和独立用户，记下主机、端口、库名、用户名及密码。数据库位于同一台普通主机时通常填 127.0.0.1:3306；容器内连接独立数据库容器应填服务名，不能填容器自己的 127.0.0.1。
本次验证中启用 OPcache 的安装器曾在刚写入 database.php 后立即读取到旧配置，显示“数据库配置写入失败”。确认文件确实已写入后，重载本站 PHP 服务再测试连接；不要连续点击安装或删除已有数据库。继续安装程序。