The Foundations course is live
Building Maintainable PHP Applications: Foundations is the first course on Codyssey, and all 17 lessons are now published. The course is free. It opens a six-course series on writing PHP applications that stay easy to change after the first few years.
What the course is about
The project arc is familiar: the first month feels fast and the codebase fits in your head. Two years later, a two-line change takes a day because nobody is sure what else it breaks, and someone proposes a rewrite.
Instead of blaming the framework, the course looks at how the way we think about code pulls projects toward that state. It covers the mindset that comes before patterns, architectures, and "clean code" rules. None of it depends on which framework you use. It's more theory than code, on purpose: the "why" comes before the "how".
What's inside
The 17 lessons are split into four chapters:
- Setting the Stage (lessons 1 to 4): why codebases rot, how context and the cost-of-change curve shape every decision, and why code should be written for the people who read it later.
- The Forces That Shape Code (lessons 5 to 9): coupling and cohesion, essential versus accidental complexity, under-engineering versus over-engineering, premature abstraction, and technical debt versus the Boy Scout Rule.
- How We Think About Code (lessons 10 to 13): moving from framework-driven, data-shaped thinking to modeling business processes, naming code by intent, and planning use cases before writing the implementation.
- Living With Code You Didn't Write (lessons 14 to 17): strategic versus tactical programming, framework MVC as the baseline most inherited codebases share, reading a codebase before you change it, and recording the reasons behind decisions so the next reader can tell a deliberate shortcut from a mistake.
The course is marked intermediate. It's written for developers who already build PHP applications and keep ending up in codebases that are hard to change.
What comes next
Patterns and Principles is the second course in the series. It moves from how to think to what to do in the codebase you already have: patterns and habits you can use in an existing Laravel, Symfony, or plain PHP project without a rewrite. The course page is up and the lessons follow.
Free content keeps coming
Insights and quick tips stay free to read, and new free courses, learning paths, code reviews, insights, quick tips and projects keep being released alongside the paid catalogue.
Follow along
New content is announced on X, Bluesky, LinkedIn, Facebook, Instagram, as well as the newsletter as it publishes.