海洋 CMS 本地电脑 PHPStudy 如何搭建测试站点

用 PHPStudy 在本地电脑搭建海洋CMS测试站，核心只有 4 步：装好 PHPStudy 并把 PHP 版本切到 7.x、把海洋CMS源码解压到网站根目录、浏览器访问 /install/ 走完安装向导、删掉 install 目录。全程不需要域名和服务器，配置顺利的话 10 分钟以内能跑起来。

海洋CMS 本地运行需要什么环境版本？

结论：海洋CMS 跑在 PHP + MySQL 上，本地推荐 PHP 7.4 + MySQL 5.7 + Apache 或 Nginx。

PHP 8.0 及以上不要选。海洋CMS 的部分老版本代码里用了 PHP 7.x 时代就已被废弃、8.0 中彻底移除的函数（例如 each()），在 PHP 8 下会直接报致命错误导致白屏。如果你下载的是较早的海洋CMS版本，切到 PHP 7.4 还报错，就继续降到 PHP 7.0 或 5.6 试，PHPStudy 支持一键切换版本，不用重装。

MySQL 选 5.7 最稳，字符集选 utf8。PHPStudy v8 面板自带 MySQL 5.7.26，直接「一键启动」即可。

PHPStudy 怎么创建站点并绑定本地域名？

结论：PHPStudy v8 的「网站」→「创建网站」里填域名、根目录、PHP 版本三项，再改一次 hosts 文件就能用域名访问。

具体步骤：

1. 下载 PHPStudy v8 Windows 版，安装到全英文路径，例如 D:\phpstudy_pro，中文路径会引发部分组件读取失败。
2. 打开面板，一键启动 Apache 2.4 和 MySQL 5.7。如果 80 或 3306 端口被占用，进「软件管理」改端口，改完两处端口号必须保持一致。
3. 点「网站」→「创建网站」：域名填 seacms.test，根目录填 D:\phpstudy_pro\WWW\seacms，PHP 版本选 7.4，其余保持默认。
4. 用管理员权限打开 C:\Windows\System32\drivers\etc\hosts，在末尾追加一行 127.0.0.1 seacms.test，保存。
5. 不想改 hosts，直接访问 http://127.0.0.1/seacms 也完全一样。

源码放哪个目录？哪些文件夹要可写？

结论：把源码包解压后「里面的文件」全部复制到网站根目录，不要整个文件夹套一层。

常见错误是复制成了 /seacms/upload/index.php，这样访问域名会 404。正确结果是根目录下直接看到 index.php、admin、data、uploads 这些。

需要写入权限的目录是 data/ 和 uploads/（部分版本还有 pic/、runtime/）。Windows 本地默认就有写权限，不用管；如果你在 macOS 或 Linux 上搭，执行 chmod -R 777 data uploads 即可。

安装向导怎么填数据库信息？

结论：数据库地址填 127.0.0.1，端口 3306，用户名 root，密码 root，数据库名自己起一个，字符集选 utf8。

浏览器访问 http://seacms.test/install/，按顺序走：

• 环境检测页：确认目录权限检测全部通过、PHP 版本检测通过，有红叉就先解决再点下一步。
• 数据库配置页：地址 127.0.0.1、端口 3306、用户 root、密码 root（PHPStudy 默认就是 root/root）、库名 seacms。数据库不存在时安装程序会自动建库。
• 管理员设置页：用户名和密码自己设定并记牢，没有固定默认值。
• 安装完成后，按提示删除网站根目录下的 install 文件夹，不删等于把重装入口暴露在公网。

后台入口是根目录下的 admin 目录，即 http://seacms.test/admin/。登录后第一件事是进「系统设置」把网站地址改成 http://seacms.test，否则页面里的链接会指向源码作者的原站地址。

装完打不开或白屏怎么排查？

结论：本地搭建失败的问题集中在 PHP 版本、端口占用、伪静态三项，按顺序排查即可定位。

• 页面白屏：九成是 PHP 版本问题。切到 PHP 7.4 或 5.6；同时在 PHPStudy 的 php.ini 里把 display_errors 设为 On，刷新页面就能看到具体报错文件和行号。
• 访问 404：确认 URL 是 /install/ 结尾，确认源码文件直接位于根目录。
• 提示数据库连接失败：确认 MySQL 已启动，且数据库端口与面板显示一致；root 密码确认为 root。
• 安装到一半报「表已存在」：用 phpMyAdmin 删掉同名数据库后重建，再重新访问 install。
• 伪静态：本地测试建议先在后台关掉伪静态功能。要用的话，Apache 需加载 rewrite 模块并保留源码自带的 .htaccess，Nginx 需把官方规则写入站点的 rewrite 配置。

跑通本地站之后，你可以放心改模板、试插件、导数据，搞坏了删库重装一次也就几分钟，比直接动线上站安全得多。