SCM); $className = $scm . 'Repo'; if($scm == 'git') $scm = 'gitrepo'; if(!class_exists($className)) require($scm . '.class.php'); $this->engine = new $className($repo->client, in_array($scm, array('gitlab', 'gitfox')) ? $repo->apiPath : $repo->path, $repo->account, $repo->password, $repo->encoding, $repo); } /** * List files. * * @param string $path * @param string $revision * @access public * @return array */ public function ls($path, $revision = 'HEAD') { if(!scm::checkRevision($revision)) return array(); return $this->engine->ls($path, $revision); } /** * Get tags. * * @param string $path svn use path, git service filter return data. * @param string $revision * @param bool $onlyDir * @param string $orderBy * @param int $limit * @param int $pageID * @access public * @return array */ public function tags($path = '', $revision = 'HEAD', $onlyDir = true, string $orderBy = '', int $limit = 0, int $pageID = 1) { if(!scm::checkRevision($revision)) return array(); return $this->engine->tags($path, $revision, $onlyDir, $orderBy, $limit, $pageID); } /** * Get branch. * * @access public * @param string $showDetail * @param string $orderBy * @param int $limit * @param int $pageID * @param string $label * @param int $showArchived * @return array */ public function branch(string $showDetail = '', string $orderBy = '', int $limit = 0, int $pageID = 1, string $label = '', int $showArchived = 0) { return $this->engine->branch($showDetail, $orderBy, $limit, $pageID, $label, $showArchived); } /** * Create a branch. * * @param string $branchName * @param string $ref * @access public * @return bool */ public function createBranch($branchName = '', $ref = 'master') { if(get_class($this->engine) == 'subversion') return false; return $this->engine->createBranch($branchName, $ref); } /** * 创建标签。 * Creates a new tag with the given name and optional comment. * * @param string $tagName The name of the tag to be created. * @param string $ref The revision from which the tag is created, it can be a commit SHA, another tag name, or branch name. * @param string $comment An optional comment for the tag. * @return array|false Returns false if the engine is Subversion, otherwise returns the result of the createTag method of the engine object. */ public function createTag($tagName, $ref, $comment = '') { if(!in_array(get_class($this->engine), array('gitlabRepo', 'gitfoxRepo'))) return false; return $this->engine->createTag($tagName, $ref, $comment); } /** * Get log. * * @param string $path * @param string $fromRevision * @param string $toRevision * @param int $count * @access public * @return array */ public function log($path, $fromRevision = 0, $toRevision = 'HEAD', $count = 0) { if(!scm::checkRevision($fromRevision)) return array(); if(!scm::checkRevision($toRevision)) return array(); return $this->engine->log($path, $fromRevision, $toRevision); } /** * Blame file. * * @param string $path * @param string $revision * @param bool $showComment * @access public * @return array */ public function blame($path, $revision, $showComment = true) { if(!scm::checkRevision($revision)) return array(); return $this->engine->blame($path, $revision, $showComment); } /** * Get last log. * * @param string $path * @param int $count * @access public * @return array */ public function getLastLog($path, $count = 10) { return $this->engine->getLastLog($path, $count); } /** * Diff file. * * @param string $path * @param string $fromRevision * @param string $toRevision * @param string $parse * @access public * @return array */ public function diff($path, $fromRevision = 0, $toRevision = 'HEAD', $parse = 'yes', $extra = '') { if(!scm::checkRevision($fromRevision) and $extra != 'isBranchOrTag') return array(); if(!scm::checkRevision($toRevision) and $extra != 'isBranchOrTag') return array(); if(!$extra) $diffs = $this->engine->diff($path, $fromRevision, $toRevision); if($extra) { if(get_class($this->engine) == 'gitlab') $diffs = $this->engine->diff($path, $fromRevision, $toRevision, '', $extra); if(get_class($this->engine) != 'gitlab') $diffs = $this->engine->diff($path, $fromRevision, $toRevision, $extra); } if($parse != 'yes') return implode("\n", $diffs); return $this->engine->parseDiff($diffs); } /** * Cat file. * * @param string $entry * @param string $revision * @access public * @return string */ public function cat($entry, $revision = 'HEAD') { if(!scm::checkRevision($revision)) return false; return $this->engine->cat($entry, $revision); } /** * Get info. * * @param string $entry * @param string $revision * @access public * @return object */ public function info($entry, $revision = 'HEAD') { if(!scm::checkRevision($revision)) return false; return $this->engine->info($entry, $revision); } /** * Exec scm cmd. * * @param string $cmd * @access public * @return array */ public function exec($cmd) { return $this->engine->exec($cmd); } /** * Get commit count * * @param int $commits * @param string $lastVersion * @access public * @return int */ public function getCommitCount($commits = 0, $lastVersion = 0) { if(!scm::checkRevision($lastVersion)) return false; return $this->engine->getCommitCount($commits, $lastVersion); } /** * Get latest revision. * * @access public * @return string */ public function getLatestRevision() { return $this->engine->getLatestRevision(); } /** * Get first revision. * * @access public * @return string */ public function getFirstRevision() { return $this->engine->getFirstRevision(); } /** * Get commits. * * @param string $version * @param int $count * @param string $branch * @access public * @return array */ public function getCommits($version = '', $count = 0, $branch = '') { if(!scm::checkRevision($version)) return array(); return $this->engine->getCommits($version, $count, $branch); } /** * Get commits by MR branches. * * @param string $sourceBranch * @param string $targetBranch * @access public * @return array */ public function getMRCommits($sourceBranch, $targetBranch) { return $this->engine->getMRCommits($sourceBranch, $targetBranch); } /** * Get clone url. * * @access public * @return void */ public function getCloneUrl() { return $this->engine->getCloneUrl(); } /** * Check revision * * @param int|string $revision * @static * @access public * @return bool */ public static function checkRevision($revision) { if(preg_match('/[^a-z0-9\-_\.\^\w][\x{4e00}-\x{9fa5}]/ui', $revision)) return false; return true; } /** * Get download url. * * @param string $branch * @param string $savePath * @param string $ext * @access public * @return string */ public function getDownloadUrl($branch = '', $savePath = '', $ext = 'zip') { return $this->engine->getDownloadUrl($branch, $savePath, $ext); } /** * Get all files. * * @param string $path * @param string $revision * @access public * @return string */ public function getAllFiles($path = '', $revision = 'HEAD') { return $this->engine->getAllFiles($path, $revision); } /** * Get files by commit. * * @param string $commit * @access public * @return array */ public function getFilesByCommit($revision) { return $this->engine->getFilesByCommit($revision); } /** * Create mr by api. * * @param object $MR * @param string $openID * @param string $assignee * @access public * @return null|object */ public function createMR($MR, $openID = '', $assignee = '') { return $this->engine->createMR($MR, $openID, $assignee); } /** * Get a mr by api. * * @param int $MRID * @access public * @return array */ public function getSingleMR($MRID) { return $this->engine->getSingleMR($MRID); } /** * Get pipeline list by api. * * @access public * @return array */ public function pipelines() { return $this->engine->pipelines(); } /** * 格式化时间。 * Format date. * * @param int|string $date * @param bool $hasTime * @param bool $isEnd * @access private * @return string */ private function formatDate($date, $hasTime = false, $isEnd = false) { $format = $hasTime ? 'Y-m-d H:i:s' : 'Y-m-d'; if(is_numeric($date)) { if($date > 100000000) return date($format, $date); $date = $isEnd ? "{$date}-12-31" : "{$date}-01-01"; if($isEnd) $date = date('Y-m-d', strtotime($date) + 86400); } elseif($isEnd) { $date = date('Y-m-d', strtotime($date) + 86400); } return date($format, strtotime($date)); } /** * 根据开始时间和结束时间获取提交时间和提交人。 * Get commit count by date. * * @param int $startDate * @param int $endDate * @access public * @return array */ public function getCommitByDate($startDate, $endDate) { $startDate = trim($startDate, '-'); $endDate = trim($endDate, '-'); return $this->engine->getCommitByDate($this->formatDate($startDate), $this->formatDate($endDate, false, true)); } public function __call($funcName, $arguments) { if(method_exists($this->engine, $funcName)) return call_user_func_array(array($this->engine, $funcName), $arguments); } } /** * Escape command. * * @param string $cmd * @access public * @return string */ function escapeCmd($cmd) { $codes = array('#', '&', ';', '`', '|', '*', '?', '~', '<', '>', '^', '[', ']', '{', '}', '$', ',', '\x0A', '\xFF'); if(DIRECTORY_SEPARATOR == '/') $cmd = str_replace('\\', '\\\\', $cmd); foreach($codes as $code) $cmd = str_replace($code, "\\{$code}", $cmd); return $cmd; } /** * Execute command. * * @param string $cmd * @param string $return * @param int $result * @param string $type * @access public * @return array|string */ function execCmd($cmd, $return = 'string', &$result = 0, $type = 'utf-8') { if(file_exists(dirname(__FILE__) . '/config.php')) include dirname(__FILE__) . '/config.php'; if($type != 'utf-8') $cmd = iconv('utf-8', $type . '//TRANSLIT', $cmd); $debug = (isset($config->debug) and $config->debug); if($debug and strpos($cmd, '2>&1') === false) $cmd = $cmd . ' 2>&1'; ob_start(); passthru($cmd, $result); $output = ob_get_clean(); if($debug and $result) { a('The command is ' . $cmd); a('The result is ' . $result); a($output); } /* When output is empty and with chinese then try execute again in windows. */ if(strtolower(substr(PHP_OS, 0, 3)) == 'win' and empty($output) and $type == 'utf-8' and preg_match("/[\x7f-\xff]/", $cmd)) $output = execCmd($cmd, 'string', $result, 'gbk'); if($return == 'array') return explode("\n", trim($output)); return $output; }