用途:为 baserCMS 5系(内部基于 CakePHP 5.0.5)+jQuery 项目提供共通开发规则,属于三层结构技能中的共通基础层,覆盖环境、目录构成、命名规则、日志与错误处理、禁止核心改动、服务器约束。具体实现模式由分野别技能负责:插件开发与改修用 basercms5-plugin-development,主题开发与改修用 basercms5-theme-development,4→5 迁移用 basercms4-to-5-upgrade 等。
技术栈:后端 PHP 8.1.5〜8.2 / CakePHP 5.0.5;数据库 MySQL 5.7〜8.0;前端 jQuery 1.x〜3.x(可能多版本混在);HTTP 服务器 Apache(启用 mod_rewrite)。
目录规则:MVC 遵循 CakePHP 5.0.5,主要以插件为单位构建,位于 htdocs/plugins/{Plugin名}/Controller/、Model/、View/。共通部件放主题内 Elements,主要为 htdocs/{主题名}/templates/element/;布局也放主题内 htdocs/{主题名}/templates/layout/,可用 $this->layout 切换。管理画面由 /admin/ 前缀路由控制,定义于 htdocs/config/.env 的 export ADMIN_PREFIX="admin"。
编码方针:函数式与过程式代码较多;JS 写在 View 的 script 标签或 .js 文件;Ajax 用 jQuery($.ajax());不使用 ES6 的 Promise、fetch、import/export;不引入 React、Vue 等 SPA 技术(局部例外)。命名沿用 baserCMS 与 CakePHP 惯例(Controller、Helper、Model 等)。
日志与错误处理:PHP 用 CakeLog::error() 或 error_log();JS 的 console.error() 为暂定,正式实现时考虑发送服务器。可为专用日志定义 CakeLog::config,使用 $this->log('Start', PROJECT_PLUGIN_ACTION)。
文件处理分类:htdocs/vendor/baserproject/ 与 htdocs/vendor/cakephp/ 为只读,禁止修改;htdocs/config/install.php、htdocs/config/.env.php、htdocs/bin/cake、htdocs/webroot/index.php 与 .htaccess 仅用于配置调查,禁止修改值。
限制:遵循 baserCMS 标准构成,禁止核心改动;不建议替换为 Laravel 等其他框架;不考虑现代 JS 框架提案;需考虑 PHP 8.1.5 限制、jQuery 1.x〜3.x 兼容、MySQL 5.7〜8.0 通用 SQL;Table 与 Entity 职责分离,验证写在 Table 类,数据库变更用 Migration(phinx)。