功件树

Phmobo_v0.1.0 / README.md

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

本功件树为Web应用程序，基于PHP7+MongoDB3+Bootstrap3开发，其中：
* 网站根目录下的index.php作为网站主页和URLRewrite入口文件，所有网页请求均经过index.php的解析转发至相应功件和功件方法，由功件完成相应Http请求处理并返回相应网页内容；网站根目录下的.htaccess为用于Apache服务器的URLRewrite配置，注意开启http.conf中的“LoadModule rewrite_module modules/mod_rewrite.so”模块，并修改AllowOverride None 为 AllowOverride All；其他种类Web服务器请使用相应的URLRewrite配置；
        其中Apache服务器.htaccess文件示例：
        RewriteEngine on
        RewriteRule !\.(txt|js|html|ico|gif|jpg|png|css|xml|map|woff|woff2|ttf)$ index.php

Nginx服务器配置文件nginx.conf内容示例：
                location / {
                root   html;
                index  index.html index.htm index.php;
                if (!-e \$request_filename){
                     rewrite ^/Phmobo/(.*)$ /Phmobo/index.php?$1 last;
                     break;
                }
        }

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