Hudson php

版权声明：本文由 [David.Xiao] 原创，转载请务必以超链接形式标明文章原始出处

最近在使用Hudson帮助团队建立每日构建环境，这里梳理一下使用hudson作为php的ci平台一些要点和注意事项。

1. 如果采用直接运行hudson.war的方式，hudson会默认创建.hudson目录，并将war解压缩在该目录下，同时把.hudson作为 HOME目录。.hudson是个隐藏目录，会带来一些不必要的麻烦，例如：phpunit3.4无法识别对隐藏目录下的测试代码目录。可以通过设置 HUDSON_HOME环境变量来改变，例如:

export HUDSON_HOME=/hudson/home

如果你已经配置好了Hudson，担心修改目录会导致重新配置，可以直接把.hudson目录内容打成一个tar包，解压缩到新的HUDSON_HOME下，所有的配置就会和原来一模一样。

2. Hudson的svn插件使用的是svnkit，svnkit对于Negotiate (sspi) authentication的处理有一些问题，如果你的svn server上启用了对于windows 域用户的鉴权，那么你在配置Subversion Authentication时，即使你输入正确的用户名和密码，hudson还是会提示你：

Failed to authenticate: svn: OPTIONS of ‘svn:/trunk’ 401 Authorization Required FAILED: svn: Authentication failed for…

解决办法是：强制指定svnkit使用BASIC和NTLM鉴权，在启动hudson时，增加启动参数：

java -Dsvnkit.http.methods=Basic,NTLM -jar hudson.war

具体解释可以参考：Getting Hudson to work with SVN on Apache and mod_sspi

3.  svn reposity 的本地目录修改后，hudson会自动清空workspace，因此你的ant构建脚本（例如：ci_build.xml）最好不要放在workspace目录下，可以放到workspace的上层目录中。
4. 一般我们希望在linux将hudson作为一个daemon运行，可以在启动时增加参数实现：

java -jar hudson.war –daemon

5. php的每日构建需要：

    1）代码静态检查 – phpCodeSniffer：

          a. 需安装Checkstyle plugin，注意如果你是手工安装的话，它依赖于analysis-core 插件

          b. 如果是手工安装phpCodeSniffer, 注意修改phpcs.php，将@php_bin@替换为你的php可执行文件路径

          C. phpcs会把生成的分析也显示出来，产生大量的Log信息，可以通过redirector定向到文件中，不显示在命令行的Log中，例如：

  <target name="phpcs">

    <exec dir="${basedir}"

        executable="phpcs"

        failοnerrοr="false" >

      <arg line="–report=checkstyle –report-file=${basedir}/build/logs/checkstyle.xml -n source/app/MyApp.php"/>

      <redirector output="${basedir}/build/logs/temp.log" />

    </exec>

  </target>

    2) API文档自动生成–phpDocumentor

          a. 在使用时注意，–ignoresymlinks   外部代码不用生成注释  –quiet  过程提示不输出

   3）单元测试–phpunit

       a. hudson要正确的解析phpunit的生成的报告，需要先安装xunit plugin，否则会无法解析生成report，导致构建失败。

    b.如果要生成代码覆盖率报告，需要先安装clover plugin，注意phpunit需要xdebug扩展才能生成clover报告

 <target name="phpunit">
  <exec dir="${basedir}"
        executable="phpunit"
        failοnerrοr="true">
   <arg line="–log-junit   build/logs/junit.xml
              –coverage-clover build/logs/clover.xml
             source/tests"/>
  </exec>
 </target>