Installing Node.JS

The best way using CoffeeScript is the installation via Node.js. The setup of Node.js can easily be done with the new Windows-Installer package that is available on the project site. There is nothing special here. After node.js is installed you will need to setup the node.js package manager (npm). You willneed to have a Git-Client installed on your machine. The best you can get is msysgit which brings a git bash console. Please make sure you have version 1.7.6 or newer installed on your PC. Open up a Git-Bash console and change to the folder you want to install npm (C:\Program Files for example). After that execute the following three commands:

Installing CoffeeScript

Installing CoffeeScript is now a piece of cake. Just use the following command:

If you need tutorials or reference material for CoffeeScript here is what I found useful:

• The Little book of CoffeeScript
• Peepcode Screencast for CoffeScript
• CoffeeScript book from Pragmatic Bookshelf

Using Coffee-Script with Assetic

Working with Coffee-Script and the commandline compiler leads to uncomfortable development process. But there is light at the end of the tunnel. As with all assets Assetic will be of great help when using Coffee-Script files in your Symfony project. The AsseticBundle is part of the Symfony2 Standard Edition so there is no need to install anything. You just have to do some configuration work ahead. This is done in the app/config/config.yml file. There you have to add a filter for CoffeeScript.

If you need more infos on how to use CoffeeScript with Assetic take a look at the Blog of Richard Miller

So lets take a look what I did. As always I would love to hear your comments on everything that could be done better or any plugin you find it worth to install.

First of all you need a Eclipse installation. I have chosen version 3.7.1 of the “Eclipse IDE for JavaScript Web Developers” (http://eclipse.org/downloads). The first plugin to install is yedit a YAML Editor plugin for Eclipse. There are others but I found this one the best of them.  To install yedit add the Update-Site (Help->Install new Software) in Eclipse. The URL of the Update-Site is http://dadacoalition.org/yedit.

PHP/Symfony

The next plugins to install are the PDT (PHP Development Tools) and the Symfony2 plugin. Now the bumpy road lies ahead of us. The Symfony2-Plugin is in beta state at the moment and needs a development-build of the PDT to work. So installation can produce “interessting” results in form of errors. For a detailed installation instruction consult the installation page of the project. Because of the dependencies and the development speed things will change frequently.
What will you get installing the plugin? Short answer: A bunch of great little helpers for editing Symfony2 Classes. Here is my favorite list:

• Autocomplete of route-names in Twig-Templates
• Code-Assist of Template-paths
• Code-Assist of Container-Services
• Annotation-Support
• Code-Assist for translations

For a more complete list of features please consult the Projects homepage. Here some screenshots (taken from the projects homepage)

PHP Tool integration

Next step is to get a better PHP Tool integration. As I’m addicted to Tools such PHPUnit, CodeSniffer and others I love to have them integrated directly in the IDE. And thats a thing Eclipse is lacking so far. But as always rescue comes by installing a new plugin. In this case PTI(PHP Tool Integration, http://www.phpsrc.org). The Installation can be done via the Update-Site of the Plugin (http://www.phpsrc.org/eclipse/pti/). The current version brings support for PHPUnit, PHP_CodeSniffer, PHP Depends, PHP Copy/Paste Detector. The development speed slowed down the last months, so if you like the plugin just make sure you send you congratulations to Sven Kiera (Twitter)
After installing the plugin you will have to initially configure it in the preferences (there is a new category PHP Tools there)

After installing and congiguring you get new views for your IDE. In these you can start the tools and can work through the results of them.

WicketShell

Chances are good that you never heard anything about WicketShell, although it is a great plugin after all. WicketShell adds a Console Shell as an Eclipse view. This is pretty useful to execute Symfony-Commandline-Operations or doing other console stuff. This is even more useful if you are using Windows because of the lack of a good console. The development activity of the plugin is low but it is usefull nonetheless. The Update-Site for installation: http://www.wickedshell.net/updatesite

Code-Formatting

The default capabilities of Eclipse/PDT are two basic settings for the idention size and the Tab policy. Compared to the possibilities of Netbeans or PHPStorm this is a shame. Luckily there is a plugin for that PHP Code Formatter: http://de.sourceforge.jp/projects/pdt-tools/. There is no updatesite available at the time of writing this. So you will have to download the plugin file and install it as a file (archive) in the under Help->Install New software. After installing the plugin you can creating code formatting rules that fits your Coding Style (hopefully you have one). This is totaly handy for reformating your sources with the Ctrl+Shift+F Shortcut.

Version Control

Even for the support of a version control system you will have to install a plugin. Sometimes there are more than one for the same VCS (for SVN for example). As I’m working with GIT and Mercurial most of the time, I installed these two plugins:

Git: I use EGit, update-site here: http://download.eclipse.org/egit/updates
Mercurial: I use MercurialEclipse, update-site here: http://cbes.javaforge.com/update

Code Coloring

Maybe you are a fan of strong colors or love dark backgrounds in your Editor windows. If this is the case the Eclipse Color Theme plugin is definitly for you. After installing the plugin from its update-site (http://eclipse-color-theme.github.com/update) you can choose and install from a great set of different themes (http://www.eclipsecolorthemes.org/).

That’s it. That brings Eclipse on par with other IDEs. For some things (DI autocompletion, Annotation support) this installation will beat the others.

The installation still has the general problems of an Eclipse installation. The components should be touched / updated carefully. Better don’t touch then if everything is working. The Symfony2-Plugin is still beta and relies on a development build of the PDT, so any update here can break the IDE. But without this you will get a decent PHP/Symfony2 IDE and some features are really a joy to work with. Will I love it? Most probably not, but it is a good choice for all who doesn’t have the free choice or like Eclipse anyway.

Netbeans

Years ago Eclipse was my main IDE for PHP development. I switched to Netbeans with the version 6.5 because it was faster, more stable and got symfony 1 support in one of the 6.x versions. I never looked back. It is fast, stable and has a lot of cool features like PHPUnit-Support or the awesome code-formatter. The symfony 1 support is good, I loved to use the command-line runner and the switching between views and controllers. The PHP support is exellent and supports PHP 5.3. But there is no special support for Symfony2 projects available at the moment. I started a feature request some month ago but there is nothing new here. For a long time there was no Twig-Support either. This can be solved by installing a Plugin but it is sometime a bit buggy and unstable.

PHPStorm

I felt in love with PHPStorm when it was released in Version 1. It is even faster than Netbeans and has all features you need. Debugging-Support is pretty good, PHPUnit is integrated, Good Code-Formatting is available, PHP 5.3 is supported. The lookup of classes and files is fast and convinient. Twig is supported out of the box in the current stable version. All in all it is a great IDE to develop PHP-Projects. There is no special Symfony2 support at the moment. For me the great JavaScript- and CSS-Support is a big bonus, as I develop a lot of code with backbone.js and other JS-Stuff these days. PHPStorm isn’t free but available for reasonable prices. I never regret that I bought a license.

Eclipse

Honestly I was surprised when I checked back the PHP-/Symfony2 support of Eclipse. Two month ago I started to recheck the option to switch back to Eclipse. I was pretty surprised that there are some nice features for Symfony2 developers waiting to be discovered in Eclipse. With some additional plugins you will get a really good Symfony2-IDE. I will write a blog-post about how to setup this as soon as possible (update. Here it is: “How to build a great Eclipse-Environment for Symfony2-Development“). The highlight is definetly the Symfony2 Eclipse-Plugin. It enhance Eclipse to the most advanced Symfony2 features so far. Here are some of them:

• Autocomplete of route-names in Twig-Templates
• Code-Assist of Template-paths
• Code-Assist of Container-Services
• Annotation-Support
• Code-Assist for translations

I still don’t like the IDE itself. It takes lang to get used to it. You have to install a lot of plugins to ge a good feature set. Most of the time you will end in a plugin hell where some plugins only work with Eclipse version x another only with version y. In the end I always had more than one Eclipse-Installations (For PHP-Development, for Java-Development, for Flex-Development…). The PHP Support in general is good but the development is done pretty much out of the view of the community.

PHPEdit

As I blogged some time ago, PHPEdit is a capable PHP IDE. It has the most advaned symfony 1 support of any IDE on the market, but this is limited on symfony 1. There was a survey some days ago about what support for Symfony2 is needed, so the makers of PHPEdit started to work on it but there is nothing ready at the moment. Even Twig is not supported at the moment. As I’m using MAC OSX for private projects and Windows at work I need an IDE that supports both platforms. PHPEdit though is only available for Windows. PHPEdit isn’t free but the pricing is ok for what you will get.

Editors

There are other alternatives too. Some do not use fullfledged IDEs for developing. There are some really cool editors out there. I’m a long-time-user of Textmate but the development nearly stopped and the development of the Version 2 is promised for years now. It is only available on MAC OSX. The best multi-platform alternatives I found are Sublime Text 2 and redcar. Both are really cool. I like Sublime Text 2 most. As TextMate it can enhanced via Bundles, it is small and lightweight.

The day was packed with sessions. Igor Wiedler was first with a nice introduction to the Silex framework. I already used Silex in a small project but nevertheless Igor was pretty inspiring and I’m more convinced that I will use the Framework for some use-cases in the future.

Next up was Marc Weistroff with a talk about developer habits and how to learn from the Symfony2 sourecode. The presentation was nice and there were some useful tidbits but I think it would have been more useful if there would have been more concrete examples.

The last session before the lunch break was held by Stefan Koopmanschap and Christian Schäfer. Their talk about “Catching Opportunities with Open Source” was pretty well prepared (maybe the best prepared at the Symfony Day). The presentation style was fluid, humorous and it was totally motivating. Even if it was not directly Symfony-related there was so much of what you can learn from the two speakers own experience with open-source that it was the right descission to place such a talk at the Symfony-Day.

After the lunch break the sessions got more technical. The frist one was about the Sonata Admin Bundle. This was the session I was looking forward to. I know Thomas Rabaix did a wonderful job with the Admin-Bundle and I havn’t used it except in a small demo which didn’t scratched the surface. So I was eager to hear more about it. Sorry to say the talk doesn’t held up with my expectations. There was to much in detail informations, up to no overview on whats possible or some examples.

Next up was Hugo Hamon with its talk about how to create command-line applications/scripts with Symfony2 and the Console Symfony Component. The talk was really informative, nicely prepared and well presented.

The last session came from Richartd Miller who blogged a lot about Symfony2 and Dependency Injection in the last months. His talk about DI was a pretty good introduction to the topic. Interesstingly Richard was the only native english speaker of the speakers but the one I had most difficulties to understand

The highlight of the day was the Keynote held by Fabien Potencier. Showing his understanding of what Symfony2 is and whats not. His view on MVC, Symfony components was enlightend. He showed the new profiling capabilities of Symfony 2.1 too.

Next year the Symfony Day will become Symfony Live and will be located in Berlin. I hope I will find more time to attend the workshops and the hack-day.

• The basic infrastructure is up and running. That means there is the basic layout, the menues, authentication and user management working.
• From now on I will work on the feature set. I will keep you informed whats up and coming.
• I uploaded a new webpage (rough) on the new Main project website (http://www.cuteflow-project.org). The VServer the page is running is sponsored by the Filloo GmbH. Thanks for it guys. There is only little content at the moment but it will grow as the version will be more complete. BTW the website is built with the Silex Framework.
• The Documentation infrastructure is up and running too. The documentation source (written in ReST, converted by Sphinx) is hosted on GitHub. We use ReadTheDocs to automatically build the HTML-Documentation from the Git-Repository. You can find the current version of the docu here.

I would be still more than happy about helping hands. There is some interest and first code writte by others but more is appreciated. You can find some first information in the documentation.

I will work on CuteFlow nearly fulltime the next weeks, so there is/will good progress. Nonetheless there are a lot of tasks to do, so every help is highly appreciated. If you want to join the project now is the time What I need most at the moment:

1.) Someone creating the infrastructure for the new documentation (Based on ReST and Sphinx). This means creating a documentation project and a automatic job that creates the documentation on the server with the sources from the GitHub repository
2.) Someone setting up a Continuous Integration using Sismo (prefered) or Jenkins
3.) Hosting: To get the things of 1+2 running I’m looking for a Hoster that sponsors the project with free hosting (vserver, PHP 5.3) and the domain.
4.) Helping with the new website (built with Silex, not online at the moment)
5.) Help with documentation writing (english)
6.) Translators for the software
7.) Developers (Need to know Symfony2)

If you need more information or want to help please mail on the CuteFlow-Dev-Mailinglist  or contact me directly via Timo.Haberkern@fantastic-bits.de

While most of the books are written in english, there are some written in german (as i’m a german native speaker). A lot of the books are describing good development practise but doesn’t use PHP as a language to describe them.

Web-/PHP-Development

• PHP Design Patterns
• Test Driven JavaScript Development (Developer’s Library)
• Ext JS in Action
• JavaScript: The Good Parts: Working with the Shallow Grain of JavaScript
• JavaScript: The Definitive Guide (Definitive Guides)

Development practise

• Head First Design Patterns
• Growing Object-Oriented Software, Guided by Tests (Beck Signature)
• Real-World Solutions for Developing High-Quality PHP Frameworks and Applications
• The Pragmatic Programmer. From Journeyman to Master
• Code Complete: A Practical Handbook of Software Construction
• Refactoring: Improving the Design of Existing Code (Object Technology Series)
• Test Driven Development. By Example (Addison-Wesley Signature)
• Domain-Driven Design: Tackling Complexity in the Heart of Software
• Clean Code: A Handbook of Agile Software Craftsmanship (Robert C. Martin)
• Scrum mit User Stories
• User Stories Applied: For Agile Software Development (Addison Wesley Signature Series)
• Pro Git (Expert’s Voice in Software Development)
• Mercurial: The Definitive Guide

Project Management

• Producing Open Source Software: How to Run a Successful Free Software Project
• The Art of Community: Building, Managing, and Supporting Cooperation Over the Internet: Building the New Age of Participation
• Rework
• Kanban and Scrum – Making the Most of Both
• Scrumban – Essays on Kanban Systems for Lean Software Develo
• Kanban
• Ship It!: A Practical Guide to Successful Software Projects (Pragmatic Programmers)
• Scrum and XP from the Trenches (Enterprise Software Development)

Management

• The Mythical Man-Month. Essays on Software Engineering
• Peopleware: Productive Projects and Teams
• Behind Closed Doors. Secrets of Great Management
• Drive: The Surprising Truth About What Motivates Us
• Switch: How to Change Things When Change is Hard

die neue Version 2 des Symfony-Frameworks wirft seine Schatten voraus. In Kürze wird die Version 2.0 als stabile Version freigegeben werden. Mit der neuen Version ändert sich die Entwicklung von Symfony-Projekten deutlich. Bereits heute wird Symfony2 von vielen für Produktivsysteme eingesetzt, da es große Verbesserungen mit sich bringt und bereits sehr stabil und performat arbeitet.

Nachdem die Schulung im Juni auf großes Interesse gestoßen ist, wird es im August wird es daher eine weitere offene Schulung zu Symfony2 geben. In drei Tagen werden alle Themen behandelt, die notwendig sind, um anschließend effektiv mit der neuen Symfony-Version zu arbeiten. Die Veranstaltung ist als Workshop ausgelegt und ist entsprechend praxisorientiert.

Nähere Infos sind unter http://bit.ly/lIPvVk verfügbar. Dort können Sie sowohl die Schulungsinhalte als auch Informationen zum Schulungsort finden.

Ich würde mich freuen Sie oder einen Ihrer Mitarbeiter bei dieser Schulung begrüßen zu dürfen.

Grüße

Timo Haberkern

The things the attendees loved:

• The flexibility of Symfony. It seems that is nothing you can’t do with Symfony2
• The annotation way of developing. Having the configuration metadata of Entities and Controllers all in one place (the DocBlock of the method).
• The maturity of the underlying concepts. You can see that all concepts are really well-thought. I wasn’t able to count the amounts of “brilliant” shouts of the attendees in these three days but there were lots of them.
• Twig! Everybody liked Twig. Most loved: The inheritance possibility of the templates
• Assetic. This is one of the killer features of Symfony. Assetic is really great and powerful. We faced some problems with beta3 on windows with YUICompressor. After an update to beta4 some of them seems to be fixed, others remained.
• Doctrine: Symfony1-Users like how lightweighted Doctrine2 is. New-time users love Doctrine for the features, abstraction and Query-Language.
• Unit-Testing: Using PHPUnit is feeling really good. The WebTestCase is a easy way to test controllers and pages.

There are still some glitches with Symfony2 that brings up

• Long-Time Symfony1 user are missing the magic sometimes. There is a bit irritation sometimes that there is that many configuration work.
• Because Symfony2 is moving that fast, there is the problem that some interessting Third-Party-Bundles can’t keep up with all the changes. This is a problem until we have a stable release.
• The last betas and PRs changed a lot of syntax (take annotations for example). All these changes made sense but the problem is that there are tons of tutorials in the web that use the old ways. That is not a Symfony2 problem at all but brings up a lot of questions.
• Documentation: The official Symfony-Documentation is getting better and better. Ryan Weaver and the others are doing a brilliant Job there, the problem is that everything that is not in the core has only little, outdated or nearly no documentation at all. Take the Assetic usage in Symfony2 for example, or the FrameworkExtraBundle. It is sometimes difficult to find the right place to start your search for information. For Symfony2-beginners it’s a challenging problem.
• Symfony1-Users are missing the out-of-the-box behaviours of Doctrine1. Sure you can install them using the DoctrineExtraBundle but we were not able to use this Bundle with beta3.

After three days packed with Symfony2 and Doctrine-Stuff I have a very positive feeling that we are getting close to a very stable and good release of 2.0. It is pretty amazing how much more flexibility new version brings and lightweighted I feels.

As always I’m looking forward to the next Symfony2 training session.

die neue Version 2 des Symfony-Frameworks wirft seine Schatten voraus. In Kürze wird die Version 2.0 als stabile Version freigegeben werden. Mit der neuen Version ändert sich die Entwicklung von Symfony-Projekten deutlich.
Bereits heute wird Symfony2 von vielen für Produktivsysteme eingesetzt, da es große Verbesserungen mit sich bringt und bereits sehr stabil und performat arbeitet.

Aus diesem Anlass wird es im Juni die erste offene deutsche Symfony2-Schulung geben. In drei Tagen werden alle Themen behandelt, die notwendig sind, um anschließend effektiv mit der neuen Symfony-Version zu arbeiten. Die Veranstaltung ist als Workshop ausgelegt und ist entsprechend praxisorientiert.

Nähere Infos sind unter http://bit.ly/lIPvVk verfügbar. Dort können Sie sowohl die Schulungsinhalte als auch Informationen zum Schulungsort finden.

Ich würde mich freuen Sie oder einen Ihrer Mitarbeiter bei dieser Schulung begrüßen zu dürfen.

Grüße

Timo Haberkern