In this new post to his site Vinícius Krolow shares some tips he thinks will help to make your PHP code more readable in the long run.
What about code readability, from my point of view is one of the most important thing in the code. Who writes code that is easy to read, writes good code. Probably reading code is where you spent most part of your time, and not only your code, probably code of your team mates, or maybe code from the open source community, so write code that is simple and is easy to understand it’s really important.
His tips (seven of them) are:
- Comment before write your code (DocBlock)
- Return frequently, Return early
- Break, Continue
- Code Standard / Name conventions
- Throw Exception
- Comment often, but not write stupid comments
- Methods can be always smaller than they are
It's a little difficult to read as the English isn't the speaker's native tongue, but it gets the point across. He also recommends reading this if you'd like more information about writing better OOP code that's easier to read.