RSS 2.0
RSS 0.91
ATOM 0.3
July 6, 2009

New TYPO3 4.x Coding Guidelines

Category: Core

By: Francois Suter & Michael Stucki

It's been a long wait, but they are finally here: brand and shiny new coding guidelines!

The new TYPO3 Coding Guidelines have finally been released. Some may think that it took a very long time. There are many factors that led to this delay and there's no point in dwelling on this. The important thing is that these new CGLs are out now and must be used for all pending and future patches for TYPO3 version 4.x.

This new version of the TYPO3 Coding Guidelines is not just an update. It is actually a full rewrite undertaken by Dmitry Dulepov and based on notes by Ingo Renner (from a CGL meeting at T3DD08). The final draft was polished by Michael Stucki.

The main reason behind this effort was to simplify this document. The previous versions contained a lot of redundant information that could already be found in other documents such "Inside TYPO3" or "Core APIs". There are probably still some redundancies, but we'll try to sort them out in further revisions. It is also worth mentioning that it is not always easy to sort between true guidelines and just best practices. The latter are now in a separate chapter of the CGLs.

So this new version is really more centered on the coding itself and not on the API. There are some very precise rules in particular about PHP syntax, so make sure you read these guidelines closely. Enjoy these new rules and don't hesitate to make suggestions to improve them in the development mailing list (

As always these guidelines are meant for Core development, but developers are strongly encouraged to use them inside their own extensions too.


comment #1
Gravatar: Georg Ringer Georg Ringer July 6, 2009 22:50
great news

comment #2
Gravatar: Tolleiv Tolleiv July 7, 2009 00:04
Thank's for all the work and that somebody took up the task to release it finally :) It's good to have up-to-date CGLs :)

comment #3
Gravatar: Mario Rimann Mario Rimann July 7, 2009 08:59
Thanks for taking care and releasing the new document!

comment #4
Gravatar: Robert Lemke Robert Lemke July 7, 2009 09:50
Finally ;-)
Ah, and don't forget that these CGLs are made for TYPO3 v4. Those for v5 and FLOW3 differ a bit:

comment #5
Gravatar: François Suter François Suter July 8, 2009 09:37
@Robert: good catch! I have slightly changed the wording of this post to reflect that.

comment #6
Gravatar: Alex Alex July 8, 2009 11:54
They're really looking good! Thanks for the great work :)

Just one little remark so far:
In the file system conventions for extensions I didn't find anything about where static TS and constants should go (e.g. in a folder called "static"). Will there be a standard for that or can I do that "as I like"?

comment #7
Gravatar: Cyrill Helg Cyrill Helg July 10, 2009 10:43
The flag on:
is wrong, its the french flag.

Apart from that, great work.

Sorry, comments are closed for this post.