[搜]

贴心猫-文档

目录结构

  • 目录结构 以 本项目 开心猫市/贴心猫文档 为例
[Web-Root]
│  bbs.php 拟扩展论坛(入口)
│  book.php 贴心猫文档(入口)
│  demo.php 文档演示(入口)
│  home.php 开心猫市(入口)
│  ... (自由扩展)
│  robots.txt
│  
├─@read : readme files
├─html : 静态文件目录
├─imcat : 核心类库,流程代码,语言包等
│  ├─adpt : api/驱动类库
│  ├─core : 核心类库
│  ├─flow : 后台管理 流程脚本
│  └─lang : 多语言包
├─job6 : 虚拟简历 (sdiy模式-Smart-Diy(自定义)简易模式)
├─kits : 工具包演示 (php工具包)
├─root : 各种入口及配置;
│  ├─a3rd : 第三方 [登录/支付] 接口
│  ├─cfgs : 配置
│  ├─error : 错误页
│  ├─extra : 扩展脚本
│  ├─plus : 接口插件,ajax入口
│  ├─run : 启动文件及常用入口(最初规划在root根目录)
│  └─tools : 工具,二次开发,安装入口等
├─ures : 上传资源附件目录; 
├─views : 视图模板(每套模版一个子目录)
│  ├─adm : 后台管理
│  ├─base : 基础视图(含引导首页)
│  ├─bbs : 拟扩展论坛
│  ├─book : 贴心猫文档
│  ├─comm : 贴心猫市
│  ├─demo : 文档演示
│  ├─sapi : APP-API 服务端
│  └─... (自由扩展)
├─ximps : 导入文件(静态图,第三方组件)
│  ├─static : 静态图片,图标,附件,字体等文件; 
│  ├─vendor : 第三方PHP代码或组件; 
│  └─vendui : 第三方前端代码或组件; 
└─xvars : 可变动态文件(缓存,临时文件)
   ├─ctpl : Tpl-缓存目录
   ├─dbexp : 导出源sql
   ├─dborg : 安装源sql
   ├─debug : 调试文件
   ├─dtmp : 缓存/临时文件目录
   └─remote : 远程采集缓存

写权限设置

以下目录/文件,需要写权限

  • 目录 /xvars/ 缓存,临时文件
  • 目录 /ures/ 上传资源附件目录
  • 文件 /root/boot/_paths.php 路径配置(初始安装时,可能自动改写,或手动配置)
  • 文件 /root/boot/cfg_db.php db配置(初始安装时,可能自动改写,或手动配置)
  • 文件 /root/boot/const.php 基本参数(系统升级时,可能自动改写)

常用目录

贴心猫-通用系统

  • 模板目录概览
    • /views/ - 项目模板:总目录
    • /views/adm/ - 后台管理模板
    • /views/base/ - 基础工具模板,如:map,动态js/css,工具等
    • /views/comm/ - 默认前端展示模板(企业站为中文版模板)
    • ... 其他模板

贴心博客

  • 前端comm模板 详情
    • /views/comm/_config/ - 功能演示版配置
    • /views/comm/_ctrls/ - 控制器方法扩展代码
    • /views/comm/assets/ - 资源目录,如css,js,images
    • /views/comm/about/ - 介绍模型模板
    • /views/comm/home/ - 首页模板/公共区块,如头尾等
    • /views/comm/info/ - 留言/导航等杂项模板
    • /views/comm/wall/ - 便笺墙模板
    • /views/comm/home/_head.htm - 公共头文件
    • /views/comm/home/_foot.htm - 公共尾文件
    • /views/comm/home/mhome.htm - 首页模板
  • 导航首页相关文件目录
    • /views/base/home/ - 首页/跳转 相关总目录
    • /views/base/home/tips.htm - 本说明模板
    • /views/base/home/_layout.htm - 首页布局(预留)
    • 首页跳转更多DIY,修改控制器文件 /views/base/_ctrls/homeCtrl.php 内的 homeAct() 方法

爱窝房产系统

  • 前端comm模板 详情
    • /views/comm/_config/ - 模板配置
    • /views/comm/_ctrls/ - 控制器方法扩展代码
    • /views/comm/assets/ - 资源目录,如css,js,images
    • /views/comm/about/ - 公司介绍模型模板
    • /views/comm/house/ - 楼盘模型模板
    • /views/comm/suite/ - 房源(出租,出售)模板
    • /views/comm/home/ - 前端首页模板
    • /views/comm/info/ - 留言/导航等杂项模板
    • /views/comm/news/ - 资讯模型模板
    • /views/comm/faqs/ - 问答模板
    • /views/comm/topic/ - 专题模板
    • /views/comm/u-inc/ - 公共区块,如头尾等
    • /views/comm/u-inc/ahead.htm - 公共头文件
    • /views/comm/u-inc/afoot.htm - 公共尾文件
    • /views/comm/u-inc/amenu.htm - 公共菜单文件
  • 导航首页相关文件目录
    • /views/base/home/ - 导航首页相关 总目录
    • /views/base/home/en.htm - 首页模板(英文版,预留)
    • /views/base/home/cn.htm - 首页模板(中文版,预留)
    • /views/base/home/_layout.htm - 首页布局
    • 首页需自定义跳转或更多DIY,修改控制器文件 /views/base/_ctrls/homeCtrl.php 内的 homeAct() 方法

开心企业站

  • 模板目录概览
    • /views/comm/ - 中文版模板(默认)
    • /views/ven/ - 英文版模板
    • /views/ves/ - 西班牙语模板
    • /views/vfr/ - 法语模板
    • /views/vru/ - 俄语模板
  • 前端comm(中文版)模板 详情
    • /views/comm/_config/ - 中文版配置
    • /views/comm/_ctrls/ - 控制器方法扩展代码
    • /views/comm/assets/ - 资源目录,如css,js,images
    • /views/comm/about/ - 公司介绍模型模板
    • /views/comm/cargo/ - 产品展示模型模板
    • /views/comm/home/ - 中文版首页模板
    • /views/comm/info/ - 留言/导航等杂项模板
    • /views/comm/news/ - 资讯模型模板
    • /views/comm/u-inc/ - 公共区块,如头尾等
    • /views/comm/u-inc/ahead.htm - 公共头文件
    • /views/comm/u-inc/afoot.htm - 公共尾文件
    • /views/comm/u-inc/amenu.htm - 公共菜单文件
  • 导航首页相关文件目录
    • /views/base/home/ - 首页相关 总目录
    • /views/base/home/en.htm - 首页模板(英文版)
    • /views/base/home/cn.htm - 首页模板(中文版,预留)
    • /views/base/home/_layout.htm - 首页布局
    • 首页需跳转或更多DIY,修改控制器文件 /views/base/_ctrls/homeCtrl.php 内的 homeAct() 方法

术语说明

  • 申明
    • 贴心猫,尽量不创造新的术语名称!
    • 以下几个行业通用的说法,这里提示一下。
  • 项目(应用/App)
    • 整个贴心猫就是一个php建站项目(或叫应用);
    • 由贴心猫二次开发的 博客,房产,企业站都是一个项目;
    • 本文档中,多项目部署相关章节提到过:多个项目公用一部分公共文件/代码。
  • 模块(功能模块/Module)
    • 一组相关的功能组合,称一个功能模块,如后台管理会员中心pc展示wap展示等;
    • 贴心猫中,按功能模块划分入口文件,设置模板分组;
  • 模型(Model)
    • 同一类数据,就是一个模型,一般对应一个数据表(或多个表);
      如:新闻(news),产品(product),博客文章(blog),楼盘(house),留言(gbook);
    • 前台为展示需要,把几个页面组合在一起,也按模型的方式处理,但不对应任何数据;
  • 路由(Route)
    • 路由就是系统定义的 url中特定的参数,根据它来关联模板/处理数据/展示数据;
    • 详见:Mkv路由