功件树

Phmobo_v0.0.1 / README.md

这是一种全新开发方式，通过开发新的功件或更新旧的功件，在功件的自动发现、自动装配机制下，可以组合不同的功件以生成具备不同业务功能的软件产品；通过将软件的整体开发转为功件的个体开发，降低开发成本，提高开发速度。

本发布版本仅包含一个功件：User，包括用户的注册、登录、更改密码、信息展示功能。

本功件树基于PHP7+MongoDB3+Bootstrap3开发：
* 项目根目录下的index.php作为网站主页和URLRewrite入口文件，项目根目录下的.htaccess为用于Apache服务器的URLRewrite配置，注意开启http.conf中的“LoadModule rewrite_module modules/mod_rewrite.so”模块，并修改AllowOverride None 为 AllowOverride All；其他种类服务器请使用相应的URLRewrite配置；
* 项目根目录下的phplib为功件共享类库文件目录，功件主目录下的phplib为功件专有类库文件目录，类库文件目录下的config.php为全局或功件专有配置文件；
* 项目根目录下的jslib为功件共享前端库文件目录，同样的，功件主目录下的jslib为功件专有前端库文件目录；功件共享图片位置：http://WEB_DOMAIN/ROOT_PATH/images/功件名称，如images/index/logo.png；
* 网站主页包含网页顶部、底部以及可以定制内容的中部，网页顶部为网站导航菜单，中部为首页内容和其他功件的显示内容；
* 如果网站访问URL中未明确声明调用某功件时，默认显示首页内容，由网站主页通过调用功件的x方法获取homePage的声明内容组合而成；网站主页通过功件x方法中的menu声明获取菜单项，动态生成网站导航菜单，通过功件x方法中的homePage声明获取首页中部显示内容，写入网站主页的内容显示区域；功件本身的的HTML显示内容，则通过功件方法的返回值，写入网站主页的内容显示区域；
* php开发的功件位于php目录下，功件主文件名称规范：功件名称.php，如User.php，功件主文件有且仅有一个，其内部有一个公共类，类名称即为功件名称，如User；功件主目录名称为功件名称的小写，如user/，功件主目录包含该功件相关的所有附属文件；
* 功件类实现规范：每个功件必须实现一个由功件名称命名的主类，其必须实现功件的一级方法：x方法；其中x方法为默认方法，即如果URL中未明确声明调用某方法时，默认调用功件的x方法返回该功件的相关内容；其中功件名称和功件方法名称均为英文字母、数字、下划线等组成；
* 功件方法实现规范：功件的x方法，有且仅有一个参数param_arr，为索引数组，返回值为return_arr，为关联数组；功件内部方法调用或URL访问方法名称、参数可自定义，返回值均为return_arr，return_arr的返回值格式类似如下：[ "result"=>"HTML字符串", "menu"=>menuArray, "permission"=>permissionArray, "homePage"=>homePageArray, "activeMenu"=>activeMenuArray ]；
* menu格式：array( 'id'=>"UserInfo", 'name'=>"用户信息", 'path'=>"User/info", 'children'=>[] )；其中id为菜单项唯一标识，用于菜单激活显示；name为菜单项名称和显示内容；path为菜单项链接相对路径；children为菜单子项
* permission格式：array( 'id'=>"UserA", 'name'=>"增加用户" )，id为权限唯一标识，name为权限名称和显示内容
* homePage格式：array( 'name'=>"最新用户", 'path'=>"User/b", 'position'=>"right", 'children'=>[
            array('name'=>"用户1",'path'=>"User/b?id=1"),
            array('name'=>"用户2",'path'=>"User/b?id=2")
        ] )；其中name为显示内容标题；path为链接相对路径；position为内容显示区域（top：显示在顶部；left：显示在左侧，宽度为9，用于显示长内容；right：显示在右侧，宽度为3，用于显示短内容；bottom：显示在底部）；children为内容详细
* activeMenu格式：array(menuId)，其中menuId为菜单项ID，对应上述menu中的id。
* 功件访问URL规范：http://WEB_DOMAIN/ROOT_PATH/功件名称/功件方法?param1=value1¶m2=value2。