禅道RestAPI开发

在老的php系统中使用 PHP 5.3以后的库所谓老的系统，是指没有使用PHP 5.3以上命名空间(namespace)特性编码的系统。

但是，只要你的系统运行在 PHP 5.3及以上的环境，在你的老系统中，是可以使用这些基于新特性如命名空间编码的库或代码的。

以前只是有洁癖不用而已。

比如，我是个工具控，想让所用的禅道系统也像那些国际化开源 Issue 项目一样有一套标准开放的 API - 禅道本身是有套 html、json 自适配模式可以当接口用的，可以用于其他客户端或系统集成。这几天在尝试编写的用于兼容 Redmine REST 风格接口的禅道 PMS API，就有意识的用了这种混合的写法。

由于要兼容 Redmine 的 REST 风格，首先选用了 Slim 这个微服务框架，毫无疑问，它是要求运行环境>5.3的，但我总得复用禅道已有的代码，这样效率才高。

原理很简单，就是一根反斜杠，或者两根。

先用 composer 初始化了 slim 库。

重点部位的代码：

入口文件 index.php

require__DIR__.'/vendor/autoload.php';require__DIR__.'/inc/zentao/nb/Autoloader.php';\zentao\nb\Autoloader::register();$app= \zentao\core\application::app(dirname(ZTNB_ROOT));//禅道的router$slim=new\Slim\Slim();$routes=require__DIR__.'/data/config/routes.php';foreach($routesas$method=>$_routes){if($_routes){foreach($_routesas$rule=>$map){$slim->$method($rule,'\\zentao\\nb\\resource\\'.$map);}

}

}$slim->run();

\zentao\core\Application 是独立封装的兼容禅道原来运行环境的类，由禅道中的 framework/router.class.php 改造而来，主要用于加载禅道中的相关资源如配置文件、模型等。精华应该在这里面，主要是加了一些“\”来让微服务中能跑起来禅道运来的运行环境，并作为一个命名空间的桥梁可以在新的代码中调用。

再看看资源类的父类 \zentao\nb\Resource，片段

<?phpnamespacezentao\nb;/*** 资源类 父类*/classResource {publicfunction__construct(){

}/*** Load the model file of one module.**@paramstring$methodName The method name, if empty, use current module's name.*@accesspublic*@returnobject|bool If no model file, return false. Else return the model object.*/PRotectedfunctionloadModel($moduleName){$modelFile= \helper::setModelFile($moduleName);/* If no model file, try load config. */if(!\helper::import($modelFile)){$this->app->loadConfig($moduleName,false);$this->app->loadLang($moduleName);$this->dao =newdao();returnfalse;}$modelClass=class_exists('ext'.$moduleName.'model')?'ext'.$moduleName.'model':$moduleName.'model';$modelClass='\\'.$modelClass;if(!class_exists($modelClass))$this->app->triggerError(" The model$modelClassnot found",__FILE__,__LINE__,$exit=true);$this->$moduleName=new$modelClass();$this->dao =$this->$moduleName->dao;return$this->$moduleName;}

这样可以在资源类中调用禅道的 model 类。

还有另外一种用法，加载语言包：

<?phpnamespacezentao\nb\resource;usezentao\nb\enum\BugType;/*** 项目自行定义的问题分类*/classIssueCategoryextends\zentao\nb\resource {publicfunctionfetchAll($format='json'){global$app;$types=$app->loadLang('bug')->bug->typeList;$issue_categories=array();foreach($typesas$key=>$name){$issue_categories[]=array('id'=> BugType::getIdByInterId($key),'name'=>$name);}echojson_encode(array('issue_categories'=>$issue_categories));}/*** 根据项目来取其中定义的分类*@paramint$projectId*@paramstring$format*/publicfunctionfetchAllByProjectId($projectId,$format='json'){$model=$this->loadModel('project');$project=$model->getById($projectId);//TODO 支持按项目代号查找if(!$project){$this->responseNotExixted();}global$app;$types=$app->loadLang('bug')->bug->typeList;$issue_categories=array();foreach($typesas$key=>$name){$issue_categories[]=array('id'=> BugType::getIdByInterId($key),'project'=>array('id'=>$projectId,'name'=>$project->name),'name'=>$name);}echojson_encode(array('issue_categories'=>$issue_categories,'total_count'=>2));}

}

基本项目结构如下：

代码：https://github.com/web3d/zentao-rest-api

项目只是初步成型，尚未完成。

这是在 NB 中的任务列表。

这是在 NB 中的任务详情。