QQ扫一扫联系
三个仓库同一批推送:Laravel 5.1、Laravel 9、Laravel 13 各管一段 PHP 版本区间,装完只有核心模块。
新增的是 Laravel 13 仓库,composer.json 要求 PHP ^8.3,本机在 8.5.12 上跑通了安装和演示站。三个仓库共用同一套 ModStart 6.0.0 底座。装配也换了思路:默认只装核心模块,没有会员、没有 CMS、没有博客。你不需要的东西,不该在装完的第一屏占位置。

上图是演示站首页底部那行版本信息:Laravel 13.39.0、ModStart 6.0.0、PHP 8.5.12、已启用模块 6 个。
手上是 PHP 5.6 的老站、卡在 Laravel 9 的项目,还是刚换的 8.5 新机器,都有对应仓库,不用为了换框架重写业务。
| 仓库 | Laravel | PHP |
|---|---|---|
| modstart-laravel5 | 5.1 | 5.6 / 7.0 |
| modstart-laravel9 | 9 | 8.1 / 8.2 |
| modstart-laravel13 | 13 | 8.3+,实测 8.5.12 |
Laravel 5.1 和 PHP 5.6 都过了官方维护期,这个仓库的定位是让存量项目继续能跑;新项目直接上 13。

三个仓库的更新时间挤在一起,是同一次推送的结果。
登录后台,菜单只有五项:系统概况、导航设置、基本设置、后台管理、模块管理,没有业务功能。
config/module.php 默认注册 6 个模块:3 个业务模块(Welcome 欢迎首页、Nav 导航、Site 站点设置)加 3 个基础支撑(Vendor、AdminManager、ModuleStore)。模块开发助手 ModuleDeveloper 不在默认装配里,要自己去后台模块市场装。
少装的收益在路由表里:没启用 Member,前台就不挂会员页面和鉴权中间件。要会员、CMS、博客,去模块市场装。从几个模块开始加,比从一堆里删容易。

自己写的模块不用维护三份,也不用为了照顾老客户把自己锁死在 Laravel 5。module/ 下的代码保持三版本通用语法,靠 config.json 的 env 字段声明兼容环境:
"env": ["laravel5", "laravel9", "laravel13"]
模板里判断能力统一用 modstart_module_enabled('Member'),模块没装就自动隐藏那一块,不会因为缺模块把页面打崩。
代价也是有的:模块里不能随手用 PHP 8 的新语法,Laravel 9 / 13 的新 API 得先判断版本再降级。换来的是不用同时维护三份代码。测试环节有硬约束,blade-compat-smoke.php 要分别在 php56 --env=laravel5、php81 --env=laravel9、php85 --env=laravel13 三套环境各跑一遍。

8.5 的几处变化都踩在框架上:opcache 自 8.5 起内置,面板里不再单独提供安装项;disable_classes 配置项移除;curl_close / finfo_close / imagedestroy 标记弃用,仓库里用兼容层接住这些调用。
安装向导的环境检查也不只报个「不通过」,它会把站点实际使用的 php.ini、extension_dir 和已加载扩展清单一起打出来。面板里装的 PHP 和站点跑的 PHP 不是同一个版本,这种坑当场能看出来。
composer install、cp .env.example .env、artisan key:generate、artisan modstart:init 四步;或者把站点目录指到 public/,打开 install.php 走两步向导。用宝塔的话注意 PHP 8.4 / 8.5 的极速安装包可能没带 --enable-zip,得改用编译安装,或者先用 8.1 / 8.2 过渡。ModuleDeveloper 能一键建骨架;手写也不复杂,一个 config.json 加迁移、模型、控制器、路由、菜单注册,modstart:module-install 一条命令装进去。modstart:seed-test 分 seed / api / biz / ui 四阶段,UI 阶段自己拉起 headless Chrome。要开箱即用的成品站,直接下 CMS 或 Blog 发行版更快;纯净仓库是给要自己拼的人准备的。已经在跑的站点不用动,这套仓库是给新项目起步用的。
三个仓库都在 GitHub / Gitee 的 open-tecmz 组织下:
演示站 https://demo-modstart-laravel13.modstart.com ,账号 demo、密码 123456,数据会定期重置。
如果你也在维护跨版本的项目,最想先看哪一块:纯净装配之后怎么往上加模块,还是一份代码怎么同时兼容三个版本?PHP 一年一个小版本,模块代码最好别跟着换。