00d4ca8d91
Before diving into any of the patterns, readers should be reminded of two fundamental laws in software architecture: 1.Everything is a trade-ff 2."Why is more important than the how" So, readers face the nuances and reality of these patterns from the beginning. These two laws are coined by two thought leaders in software architecture: Mark Richards and Neal Ford. They have explained these two laws in various conference talks and books. For example, here you can read about these two laws here: https://www.infoq.com/podcasts/software-architecture-hard-parts/ Also, here is a book for reference: https://a.co/d/fKOodW9
DesignPatternsPHP
Read the Docs of DesignPatternsPHP or Download as PDF/Epub
This is a collection of known design patterns and some sample codes on how to implement them in PHP. Every pattern has a small list of examples.
I think the problem with patterns is that often people do know them but don't know when to apply which. Remember that each pattern has its own trade-offs. And you need to pay attention more to why you're choosing a certain pattern than to how to implement it.
Installation
You should look at and run the tests to see what happens in the example.
To do this, you should install dependencies with Composer first:
$ composer install
Read more about how to install and use Composer on your local machine here.
To run the tests use phpunit:
$ ./vendor/bin/phpunit
Using Docker (optional)
You can optionally build and browse the documentation using Docker for Mac, Windows or Linux.
Just run:
$ docker-compose up --build
Go to http://localhost:8080/ to read the generated documentation.
If you want to localize your documentation you can pass the locale as an argument to the docker build:
$ docker-compose build --build-arg language=de
$ docker-compose up
Patterns
The patterns can be structured in roughly three different categories. Please click on the 📓 for a full explanation of the pattern on Wikipedia.
Creational
- AbstractFactory 📓
- Builder 📓
- FactoryMethod 📓
- Pool 📓
- Prototype 📓
- SimpleFactory
- Singleton 📓
- StaticFactory
Structural
- Adapter 📓
- Bridge 📓
- Composite 📓
- DataMapper 📓
- Decorator 📓
- DependencyInjection 📓
- Facade 📓
- FluentInterface 📓
- Flyweight 📓
- Proxy 📓
- Registry 📓
Behavioral
- ChainOfResponsibilities 📓
- Command 📓
- Interpreter 📓
- Iterator 📓
- Mediator 📓
- Memento 📓
- NullObject 📓
- Observer 📓
- Specification 📓
- State 📓
- Strategy 📓
- TemplateMethod 📓
- Visitor 📓
More
Localization & Supported Languages
The following languages are currently available. However not all are actively supported. The current policy is: if there are no native-speaking maintainers we cannot support the given language. We will still leave the translation as is but we will not update it as the base (English) changes. The table below list which language version is considered "supported" and who maintains it.
We're sorry. We would love to maintain them but it is not possible for us. So if you would like to take care of one or more languages - contact us.
| Code | Language | Documentation | Actively Supported? | Maintainer |
|---|---|---|---|---|
| en | English | Docs 📓 | YES | -- |
| de | German | Docs 📓 | NO | - |
| ca | Catalan | Docs 📓 | NO | - |
| zh_CN | Chinese | Docs 📓 | NO | - |
| nl | Dutch | Docs 📓 | NO | - |
| bg | Bulgarian | Docs 📓 | YES | -- |
| ja | Japanese | Docs 📓 | NO | - |
| pl | Polish | Docs 📓 | NO | - |
| pt_BR | Portuguese-Brazil | Docs 📓 | NO | - |
| ru | Russian | Docs 📓 | NO | - |
| es | Spanish | Docs 📓 | NO | - |
| es_MX | Spanish-Mexican | Docs 📓 | NO | - |
| tr | Turkish | Docs 📓 | NO | - |
| fr | French | Docs 📓 | NO | - |
| it | Italian | Docs 📓 | NO | - |
| uk | Ukrainian | Docs 📓 | NO | - |