# php-model-engine

**Repository Path**: pg0xff/php-model-engine

## Basic Information

- **Project Name**: php-model-engine
- **Description**: PHP版本的模型和模型表单引擎
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-05
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PHP版本的模型和模型表单引擎 #

## 项目依赖 ##

在构建当前项目前，需要先在当前目录下的GIT命令行中clone(或SVN checkout)以下依赖项目的分支：

 * PHP版本的缓存机制框架：git clone https://github.com/peigong/php-cache.git --branch 0.0.2 ./libs/php-cache-0.0.2
 * PHP版本的IOC框架：git clone https://github.com/peigong/php-ioc.git --branch 0.0.6 ./libs/php-ioc-0.0.6
 * PHP版本的数据库访问框架：git clone https://github.com/peigong/php-db.git --branch 0.1.1 ./libs/php-db-0.1.1
 * PHP网站系统核心基类和接口库：git clone https://github.com/peigong/php-site-core.git --branch 0.1.1 ./libs/php-site-core-0.1.1
 * PHP WEB系统的常用工具库：git clone https://github.com/peigong/php-utils.git --branch 0.0.1 ./libs/php-utils-0.0.1
 * RequireJS框架([http://requirejs.org](http://requirejs.org))：git clone https://github.com/jrburke/requirejs.git --branch 2.1.8 ./libs/requirejs-2.1.8
 * jQuery框架([http://jquery.com](http://jquery.com))：git clone https://github.com/jquery/jquery.git --branch 2.0.3 ./libs/jquery-2.0.3
 * jQuery UI库([http://jqueryui.com](http://jqueryui.com))：git clone https://github.com/jquery/jquery-ui.git --branch 1.10.3 ./libs/jquery-ui-1.10.3
 * jQuery File Upload([blueimp-file-upload](blueimp-file-upload)：git clone https://github.com/blueimp/jQuery-File-Upload.git --branch 8.7.1 ./libs/jquery-file-upload-8.7.1
 * jQuery Validation Plugin([http://jqueryvalidation.org](http://jqueryvalidation.org))：git clone https://github.com/jzaefferer/jquery-validation.git --branch 1.11.1 ./libs/jquery-validation-1.11.1
 * bootstrap框架([http://twitter.github.io/bootstrap](http://twitter.github.io/bootstrap))
 	* clone发布分支：git clone https://github.com/twbs/bootstrap.git --branch v2.3.2 ./libs/bootstrap-v2.3.2
 	* 下载可用版本：http://www.bootcss.com/assets/bootstrap.zip => ./libs/bootstrap-v2.3.2
 * bootstrap框架([http://twitter.github.io/bootstrap](http://twitter.github.io/bootstrap))：git clone https://github.com/twbs/bootstrap.git --branch v3.0.0-rc1 ./libs/bootstrap-v3.0.0-rc1
 * Smarty模板引擎([http://www.smarty.net](http://www.smarty.net))：svn checkout http://smarty-php.googlecode.com/svn/tags/Smarty_3_1_8 ./libs/Smarty_3_1_8

## 使用说明 ##

 * 需要在模型和模型表单引擎库的上级目录（或上上级目录），放置config.inc.php配置文件，定义WEB系统的静态常量。需要的常量如下：
 	* ROOT：整个WEB系统的根目录，用于引用全局的类库。
 	* ModelEngineData：定义模型和表单引擎使用的数据库。
	* 如果需要文件上传表单对象、静态化的存储表单配置数据，则需要指定静态常量，如下：
	 * STATIC_PATH：上传的物理目录
	 * STATIC_HOST：外部访问的地址
 * 需要定义常量jQueryFileUploadLibPath，指向jQuery-File-Upload的类库目录。并且，所有需要用到的JS\CSS\PHP文件在构建后，都要平级存放。
 * 在正式的商业系统中使用时，需要在WEB服务器上（如Apache、Ngix），把模型和模型表单引擎的IOC配置目录（conf）设置为禁止外部访问。
 * 如果需要模型导出的功能，则需要给模型和表单引擎的临时目录（tmp）分配可写权限。
 * 如果应用于商业系统，出于安全的考虑，应该把designer.php和tool.php两个管理页面删除掉。

## 分发目录说明 ##

 * demo：模型和模型表单引擎的演示DEMO
 * dependencies：模型和模型表单引擎所依赖的PHP和JS框架库，可移植。
 * model-engine：可移植的模型和模型表单引擎的类库。具体使用需参考demo中的js和php配置。

## 版本的更新记录 ##

### 0.1.4 ###
 * 修订了单选按钮列表控件的BUG。
 * 优化了在分库的情况下导入、导出的功能。

### 0.1.3 ###
 * 优化表单配置的获取方式，规避可能的跨域问题。

### 0.1.2 ###
 * 修订了数据库导入、导出工具的BUG。

### 0.1.1 ###
 * 增加了模型数据的数据库工具，用于其他系统模块的导入、导出数据。

### 0.1.0 ###
 * 正式发布可使用版本。
 * 优化了DEMO时，JS配置文件的引用。

### 开发内测版本 ###
#### 0.0.11 ####
 * 修改了表单宿主模型的BUG。

#### 0.0.10 ####
 * 优化了表单宿主模型的处理逻辑，更加流畅、优雅。

#### 0.0.9 ####
 * 增加了导入、导出和备份的工具。
 * 表单数据由动态获取优化为可以一次生成，静态获取。
 * 约定了系统模块下的mdd目录存放标准的模型定义数据。

#### 0.0.8 ####
 * 升级使用了，PHP网站系统核心基类和接口库的0.0.4版本。
 * 更新了二级菜单的处理方式。

#### 0.0.7 ####
 * 调整目录结构，使模型和表单引擎遵循网站模块的配置标准。

#### 0.0.6 ####
 * 恢复注释掉的表单描述信息，以使复选框控件显示出描述文本。

#### 0.0.5 ####
 * 升级了PHP网站系统核心基类和接口库的版本。

#### 0.0.4 ####
 * 兼容了配置文件中常量和接口可能重复定义的问题。
 * 为模型和表单引擎定义独立的数据库配置。

#### 0.0.3 ####
 * 增加了列表控件向模型表单传递参数的机制。

#### 0.0.2 ####
 * 修订了因为拼写错误所引起的上传控件BUG。

#### 0.0.1 ####
 * 实现模型和模型表单引擎基本的框架机制。

## 作者信息 ##
 * 电子邮件：peigong@foxmail.com
 * 微博地址：[http://weibo.com/u/3030510210](http://weibo.com/u/3030510210)
 * 博客地址：[http://www.peigong.tk](http://www.peigong.tk)
 * 项目地址：[https://github.com/peigong/php-model-engine](https://github.com/peigong/php-model-engine)