Sismo 技术文档

1. 安装指南

Sismo 是一个 PHP 编写的持续测试服务器。安装 Sismo 非常简单，只需下载 sismo.php 文件并将其放置在 Web 根目录下即可。安装 Sismo 需要至少 PHP 5.3.3 版本。

2. 项目的使用说明

构建项目

通过运行以下命令构建所有配置的项目：

$ php sismo.php build --verbose

如果构建失败，Sismo 将发送通知。

查看构建输出

要查看项目的最新构建输出，使用以下命令：

$ php sismo.php output 项目名称

如果已配置 Sismo 通过 Web 界面访问，也可以在 Web 界面中查看构建输出。

配置 Git 钩子

要将 Sismo 配置为在每次提交时运行，可以将以下脚本保存为项目中的 .git/hooks/post-commit 并确保它是可执行的：

#!/bin/sh

nohup php /path/to/sismo.php --quiet --force build 项目名称 `git log -1 HEAD --pretty="%H"` &>/dev/null &

使用内置 Web 服务器

如果使用 PHP 5.4.0 或更高版本，可以使用 Sismo 内置的 Web 服务器：

$ php sismo.php run localhost:9000

然后在浏览器中打开 http://localhost:9000/sismo.php。

3. 项目 API 使用文档

Sismo 的 API 使用非常简单。以下是一些关键类的简要说明：

• Sismo\Notifier\Notifier：通知器基类，用于创建自定义通知器。
• Sismo\Commit：表示提交信息的类，包含多个方法获取提交详情。
• Sismo\Project：表示项目的类，可以设置仓库、分支、构建命令等。

4. 项目安装方式

安装 Sismo 的方式非常简单，只需执行以下步骤：

1. 下载 sismo.php 文件。
2. 将文件放置在 Web 根目录下。
3. 确保服务器运行 PHP 5.3.3 或更高版本。

以上就是 Sismo 的安装和使用说明。有关更多配置和高级使用，请参考项目 Wiki 和 README 文件。