phpdox.xml 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131
  1. <?xml version="1.0" encoding="utf-8" ?>
  2. <phpdox xmlns="http://xml.phpdox.net/config" silent="false">
  3. <!-- @silent: true | false to enable or disable visual output of progress -->
  4. <!-- Additional bootstrap files to load for additional parsers, enrichers and/or engines -->
  5. <!-- Place as many require nodes as you feel like in this container -->
  6. <!-- syntax: <require file="/path/to/file.php" /> -->
  7. <bootstrap />
  8. <!-- A phpDox project to process, you can have multiple projects in one config file -->
  9. <project name="phpdox" source="${basedir}/src" workdir="${basedir}/build/phpdox/xml">
  10. <!-- @name - The name of the project -->
  11. <!-- @source - The source directory of the application to process -->
  12. <!-- @workdir - The directory to store the xml data files in -->
  13. <!-- A phpDox config file can define additional variables (properties) per project -->
  14. <!-- <property name="some.name" value="the.value" /> -->
  15. <!-- Values can make use of previously defined properties -->
  16. <!-- The following are defined by default:
  17. ${basedir} Directory the loaded config file is in
  18. ${phpDox.home} Directory of the phpDox installation
  19. ${phpDox.file} The current config file
  20. ${phpDox.version} phpDox' version number
  21. ${phpDox.project.name} The value of project/@name if set, otherwise 'unnamed'
  22. ${phpDox.project.source} The value of project/@source if set, otherwise '${basedir}/src'
  23. ${phpDox.project.workdir} The value of project/@workdir if set, otherwise '${basedir}/build/phpdox/xml'
  24. ${phpDox.php.version} The PHP Version of the interpreter in use
  25. -->
  26. <!-- Additional configuration for the collecting process (parsing of php code, generation of xml data) -->
  27. <collector publiconly="false" backend="parser" encoding="auto">
  28. <!-- @publiconly - Flag to disable/enable processing of non public methods and members -->
  29. <!-- @backend - The collector backend to use, currently only shipping with 'parser' -->
  30. <!-- @encoding - Charset encoding of source files (overwrite default 'auto' if detection fails) -->
  31. <!-- <include / exclude filter for filelist generator, mask must follow fnmatch() requirements -->
  32. <!-- Multiple elements can be added to define more than one mask per filter -->
  33. <include mask="*.php" />
  34. <exclude mask="" />
  35. <!-- How to handle inheritance -->
  36. <inheritance resolve="true">
  37. <!-- @resolve - Flag to enable/disable resolving of inheritance -->
  38. <!-- You can define multiple (external) dependencies to be included -->
  39. <!-- <dependency path="" -->
  40. <!-- @path - path to a directory containing an index.xml for a dependency project -->
  41. </inheritance>
  42. </collector>
  43. <!-- Configuration of generation process -->
  44. <generator output="${basedir}/docs">
  45. <!-- @output - (Base-)Directory to store output data in -->
  46. <!-- A generation process consists of one or more build tasks and of (optional) enrich sources -->
  47. <enrich base="${basedir}/build">
  48. <!-- @base - (Base-)Directory of datafiles used for enrich process -->
  49. <!--<source type="...">-->
  50. <!-- @type - the handler for the enrichment -->
  51. <!-- known types by default are: build, checkstyle, git, phpcs, phploc, phpunit, pmd -->
  52. <!-- every enrichment source can have additional configuration nodes, most probably need a logfile -->
  53. <!-- <file name="path/to/log.xml" /> -->
  54. <!--</source> -->
  55. <!-- add phploc output -->
  56. <!--
  57. <source type="phploc" />
  58. -->
  59. <!-- git vcs information -->
  60. <!--
  61. <source type="git">
  62. <git binary="/usr/bin/git" />
  63. <history enabled="true" limit="15" cache="${phpDox.project.workdir}/gitlog.xml" />
  64. </source>
  65. -->
  66. <!-- PHP Code Sniffer findings -->
  67. <!--
  68. <source type="phpcs">
  69. <file name="logs/phpcs.xml" />
  70. </source>
  71. -->
  72. <!-- PHPMessDetector -->
  73. <!--
  74. <source type="pmd">
  75. <file name="pmd.xml" />
  76. </source>
  77. -->
  78. <!-- PHPUnit Coverage XML -->
  79. <!-- <source type="phpunit"> -->
  80. <!-- <coverage path="" /> -->
  81. <!-- @path - the directory where the xml code coverage report can be found -->
  82. <!--</source>-->
  83. <!--
  84. <source type="phpunit">
  85. <filter directory="${phpDox.project.source}" />
  86. </source>
  87. -->
  88. </enrich>
  89. <!-- <build engine="..." enabled="true" output="..." /> -->
  90. <!-- @engine - The name of the engine this build task uses, use ./phpDox - -engines to get a list of available engines -->
  91. <!-- @enabled - Flag to enable/disable this engine, default: enabled=true -->
  92. <!-- @output - (optional) Output directory; if relative (no / as first char) it is interpreted as relative to generator/@output -->
  93. <!-- An engine and thus build node can have additional configuration child nodes, please check the documentation for the engine to find out more -->
  94. <!-- default engine "html" -->
  95. <build engine="html" enabled="true" output="html">
  96. <template dir="${phpDox.home}/templates/html" />
  97. <file extension="xhtml" />
  98. </build>
  99. </generator>
  100. </project>
  101. </phpdox>