{"id":2267,"date":"2012-05-02T22:31:13","date_gmt":"2012-05-02T21:31:13","guid":{"rendered":"http:\/\/www.haydnwilliams.com\/blog\/?p=2267"},"modified":"2022-04-11T21:33:29","modified_gmt":"2022-04-11T20:33:29","slug":"php-development-in-eclipse-on-mac-osx-lion","status":"publish","type":"post","link":"https:\/\/www.haydnwilliams.com\/blog\/php-development-in-eclipse-on-mac-osx-lion\/","title":{"rendered":"PHP Development in Eclipse"},"content":{"rendered":"

I used Eclipse on a Mac to work with Java during my PhD<\/a>, so familiarity made it seem the logical choice for some recent PHP development I’ve been doing. This post runs through the various plugins I added to support the development process, including checking code quality, running unit tests, and creating documentation.<\/p>\n

The first step is obviously to install Eclipse<\/a>. To ensure compatibility with all the plugins mentioned, I found it necessary to download the standard version<\/a> of Eclipse and then install the PDT tools<\/a> afterwards. The dedicated all-in-one PDT version<\/a> of Eclipse didn’t play ball with everything I needed it to.<\/p>\n

 <\/p>\n

Version Control – Subclipse<\/strong><\/span>
\nI use Subversion<\/a>\u00a0(SVN) for version control, and\u00a0Subclipse<\/a> seems to to be the de-facto<\/em>\u00a0client for Eclipse. However, there are some pitfalls to be aware of. If you install Subclipse and then try to add a respository in the SVN Perspective, you may get an error telling you that you need version 1.7 or higher of the JavaHL library. This is part of the Subversion binary, so your copy of SVN must be out of date. If you nip over to Collabnet<\/a>\u00a0for the latest version you’ll find that they only have 1.6, so instead you’ll need to visit WANDisco<\/a>. Once 1.7 is installed, you should then be able to connect with Subclipse using the JavaHL library. Thanks to peeps on Stackoverflow<\/a> for pointing this out.<\/p>\n

Unfortunately JavaHL still failed for me, telling me that the network connection closed unexpectedly. I tried to use the SVNKit adapter instead of JavaHL, but it turns out that SVNKit isn’t supported in version 1.8 of Subclipse<\/a>, (the most recent version). I therefore uninstalled Subclipse v1.8 and installed v1.6 instead. That still didn’t work because apparently SVNKit doesn’t currently support SVN 1.7 (see previous link). Anyway, this turned out to be all a bit misleading, because when I tried it everything just worked.<\/p>\n

 <\/p>\n

Debgugging – Xdebug<\/strong><\/span>
\nIf you want to debug PHP, then you’ll need either Xdebug or Zend Debugger. I chose the former for reasons I can’t quite recall. But setting it up required the following steps in Eclipse:<\/p>\n

    \n
  1. In Preferences > PHP > PHP Executables<\/em>, set up your PHP executable. Mine, the default Lion version, was at \/usr\/bin\/php<\/em>, and php.ini was at \/etc\/php.ini<\/em><\/li>\n
  2. In Preferences > PHP > \u00a0PHP Servers<\/em>, set up your PHP server. I had to delete the “default” one first.<\/li>\n
  3. In Preferences > PHP > Debug<\/em>, set your debugger, server and executable.<\/li>\n
  4. If you’ve changed the Xdebug port from the default of 9000 for any reason (I had problems with my initial Xdebug install, and that was one of the suggested fixes), don’t forget to correct it in Preferences > PHP > Debug > Installed Debuggers<\/em>.
    \n
    \n<\/strong><\/span><\/li>\n<\/ol>\n

     <\/p>\n

    \"Debugging

    Debugging with Xdebug. The 'debug' panel shows the methods which are currently running, while the relevant code is shown below. Panel on the right shows variables and their current values.<\/p><\/div>\n


    \n<\/strong><\/span><\/p>\n

    Coding Standards – PHP Code Sniffer<\/strong><\/span><\/p>\n

    To ensure that your code is up to standard(s), you can install PHP_CodeSniffer with PEAR:<\/p>\n

    pear install PHP_CodeSniffer<\/pre>\n
    There’s more detail on their\u00a0homepage<\/a>, including information on the –report<\/em> flag to get a summary of the errors in your entire project instead of all the detail for every file. I’d recommend creating your own customised standard<\/a> so you can exclude errors you’re not bother about (variables with single-letter names, for example). Once you’ve done that, you can also\u00a0make your standard the default\u00a0<\/a>to be used each time you run PHPCS.<\/p>\n
    \"PHP
    PHP Code Sniffer summary report.<\/p><\/div>\n

    \n<\/strong><\/span><\/p>\n
    Coding Problems – PHP Mess Detector<\/strong><\/span><\/p>\n
     PHP Mess Detector<\/a>\u00a0does a good job of finding nasty bits of code. This includes ‘dead’ code that’s never run, complicated loops \/ nested ifs, \u00a0It’s worth reading the section on how to create a custom ruleset<\/a>, because the defaults may include tests that you want to exclude.<\/p>\n

    \nUnit Testing – PHPUnit<\/strong><\/span><\/p>\n
    Unit testing is a great habit to get into, and test-driven development takes this to its logical conclusion. PHPUnit<\/a> and SimpleTest<\/a> both provide unit testing in PHP; I chose PHPUnit because there seemed to be more material online about how to use it. To install\u00a0PHPUnit<\/em>\u00a0you can use\u00a0PEAR<\/em><\/a>. Unfortunately\u00a0PEAR<\/em>\u00a0wasn’t installed on my Lion system, but you can\u00a0install it using\u00a0wget<\/em><\/a>. \u00a0Unfortunately\u00a0wget<\/em>\u00a0wasn’t installed on my Lion system, but you can install it with\u00a0a number of terminal commands<\/a>.<\/p>\n
    Once wget is installed and then PEAR is installed and then PHPUnit is installed (!), you can\u00a0set up Eclipse to run it as an external tool<\/a>. However, it’s much nicer to get it integrated into your Eclipse installation. To do this, I used MakeGood. The instructions on their website <\/a>are pretty easy to follow and essentially boil down to:<\/p>\n
      \n
    1. Install the MakeGood plugin from within Eclipse, using http:\/\/eclipse.piece-framework.com<\/em> as the URL<\/li>\n
    2. DON’T<\/em>\u00a0 ignore the lines about having to specify a PHP executable; I did (because I already had an executable defined), but for some reason the executable had disappeared from my Eclipse preferences and so I had to add it again after much head-scratching.<\/li>\n
    3. DO<\/em>\u00a0display the MakeGood ‘view’ in your Eclipse window as soon as possible – it has a nice little message which explains what might be stopping you running your tests.<\/li>\n
    4. A message about Stagehand_Testrunner led me to install that separately, using PEAR (instructions are on the Stagehand website<\/a>)<\/li>\n
    5. Despite adding my PEAR folder as a library to the project build path, I was still getting a message saying that PHPUnit_Framework_TestCase<\/em> could not be found when I ran a test. I resolved this by adding\u00a0\/Users\/Haydn\/pear\/share\/pear\/PHPUnit<\/em> to the build path too, and using require_once<\/em> in the test class: \u00a0require_once ‘PHPUnit\/Autoload.php’;<\/em><\/li>\n<\/ol>\n
      \n
      \"MakeGood
      MakeGood showing a successful test in Eclipse.<\/p><\/div>\n
      Once PHPUnit is working correctly, if you want to test database operations too then you’ll need the DbUnit extension. There’s extensive help regarding this whole subject area in the PHP Unit manual<\/a>. Note that SQL Server isn’t supported by default.<\/p>\n
       <\/p>\n
      Documentation – PHPDoc<\/strong><\/span>
      \nIf you’re documenting your code then you’ll want phpdoc –       installation instructions<\/a> are on their website. Just use the two PEAR commands on their homepage, and ignore other websites (which generally omit the ‘-alpha<\/em>‘ reference). If you try and generate some documentation but get an error about GraphViz not being installed (“Unable to find the `dot` command of the GraphViz package. Is GraphViz correctly installed and present in your path?”)<\/em>, go to the GraphViz website <\/a>to download a .pkg <\/em>file\u00a0for Lion and install it. If you get a message about timezones, ensure that the correct one is set in your php.ini<\/em> file (e.g. date.timezone = Europe\/London<\/em>).<\/p>\n
       <\/p>\n<\/div>\n
      Automation – ANT<\/strong><\/span>
      \nOnce all the above are in place, it’s nice to be able to run them all together. You can use       ANT<\/a> to do this; here’s an example of my ANT build.xml file:<\/div>\n
      \n
      \r\n&lt;?xml version=&quot;1.0&quot;?&gt;\r\n&lt;!DOCTYPE project&gt;\r\n&lt;project name=&quot;MyProject&quot; default=&quot;test&quot;&gt;\r\n    &lt;property name=&quot;docs_dir&quot; value=&quot;docs&quot; \/&gt;\r\n    &lt;property name=&quot;log_file&quot; value=&quot;MyLogFile.log&quot; \/&gt;\r\n    &lt;target name=&quot;dtd&quot; description=&quot;Creates a DTD for this build.xml file.&quot;&gt;\r\n        &lt;antstructure output=&quot;project.dtd&quot;\/&gt;\r\n    &lt;\/target&gt;\r\n    &lt;target name=&quot;clean&quot; description=&quot;Deletes temporary and compiled files.&quot;&gt;\r\n        &lt;delete dir=&quot;${docs_dir}&quot;\/&gt;\r\n        &lt;delete dir=&quot;output&quot;\/&gt;\r\n    &lt;\/target&gt;\r\n    &lt;target name=&quot;messdetect&quot; description=&quot;Runs PHP Mess Detector on PHP files.&quot;&gt;\r\n        &lt;exec executable=&quot;\/Users\/Haydn\/pear\/bin\/phpmd&quot; failonerror=&quot;true&quot;&gt;\r\n            &lt;arg value=&quot;.&quot; \/&gt;\r\n            &lt;arg value=&quot;text&quot; \/&gt;\r\n            &lt;arg value=&quot;anciliary\/PHPMD_custom_ruleset.xml&quot; \/&gt;\r\n        &lt;\/exec&gt;\r\n    &lt;\/target&gt;\r\n    &lt;target name=&quot;codesniff&quot; description=&quot;Runs PHP Code Sniffer on PHP files.&quot;&gt;\r\n        &lt;exec executable=&quot;\/Users\/Haydn\/pear\/bin\/phpcs&quot; failonerror=&quot;true&quot;&gt;\r\n            &lt;arg value=&quot;.&quot; \/&gt;\r\n            &lt;arg value=&quot;--standard=MyStandard&quot; \/&gt;\r\n            &lt;arg value=&quot;--extensions=php&quot; \/&gt;\r\n            &lt;arg value=&quot;--report=summary&quot; \/&gt;\r\n        &lt;\/exec&gt;\r\n    &lt;\/target&gt;\r\n    &lt;target name=&quot;test&quot; description=&quot;Runs all PHPUnit tests.&quot;&gt;\r\n        &lt;exec executable=&quot;\/Users\/Haydn\/pear\/bin\/phpunit&quot; failonerror=&quot;true&quot;&gt;\r\n            &lt;arg value=&quot;test&quot; \/&gt;\r\n        &lt;\/exec&gt;\r\n    &lt;\/target&gt;\r\n    &lt;target name=&quot;document&quot;  depends=&quot;clean&quot; description=&quot;Generates documentation for PHP files.&quot;&gt;\r\n        &lt;exec executable=&quot;\/Users\/Haydn\/pear\/bin\/phpdoc&quot; failonerror=&quot;true&quot;&gt;\r\n            &lt;arg value=&quot;-d&quot; \/&gt;\r\n            &lt;arg value=&quot;.&quot; \/&gt;\r\n            &lt;arg value=&quot;-t&quot; \/&gt;\r\n            &lt;arg value=&quot;${docs_dir}&quot; \/&gt;\r\n        &lt;\/exec&gt;\r\n    &lt;\/target&gt;\r\n    &lt;target name=&quot;build&quot; depends=&quot;clean,messdetect,codesniff,test,document&quot; description=&quot;Run everything.&quot;&gt;\r\n    &lt;\/target&gt;\r\n&lt;\/project&gt;\r\n<\/pre>\n<\/div>\n
      <\/div>\n
      Next?<\/strong><\/span><\/div>\n
      The next step is to move to continuous integration, using packages like Cruise Control<\/a> or phpUnderControl<\/a>, which will automatically test and build your code on a regular schedule. As a one-man project I always know the status of my work, so that’s not been necessary so far. Hopefully the above will be of help in getting you up-and-running with a decent PHP development workflow in Eclipse.<\/div>\n","protected":false},"excerpt":{"rendered":"
      I used Eclipse on a Mac to work with Java...<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[882,879,93,870,881,867,249,865,878,866,322,323,880,869,868],"class_list":["post-2267","post","type-post","status-publish","format-standard","hentry","category-it","tag-ant","tag-code-sniffer","tag-eclipse","tag-eclipse-pdt","tag-mess-detector","tag-pear","tag-php","tag-php-unit","tag-phpdoc","tag-phpunit","tag-subclipse","tag-subversion","tag-tdd","tag-unit-testing","tag-wget"],"_links":{"self":[{"href":"https:\/\/www.haydnwilliams.com\/blog\/wp-json\/wp\/v2\/posts\/2267","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.haydnwilliams.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.haydnwilliams.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.haydnwilliams.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.haydnwilliams.com\/blog\/wp-json\/wp\/v2\/comments?post=2267"}],"version-history":[{"count":0,"href":"https:\/\/www.haydnwilliams.com\/blog\/wp-json\/wp\/v2\/posts\/2267\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.haydnwilliams.com\/blog\/wp-json\/wp\/v2\/media?parent=2267"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.haydnwilliams.com\/blog\/wp-json\/wp\/v2\/categories?post=2267"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.haydnwilliams.com\/blog\/wp-json\/wp\/v2\/tags?post=2267"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}