功件树

PhpWebBoot / README.md

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

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

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

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