Removing Static - There and Back Again

The more companies I meet, the more I see static and new everywhere. Not like new Product, but rather new ProductRepository(new Database()). Not just Laravel, but across all PHP frameworks. I wish frameworks could prevent antipatterns, but they don't, do they?

Instead of "refactor all the things" step by step, class by class, I'd like share my thoughts when exploring full automated path. I look for feedback to improve this process.

1. Show Code

I usually start with a minimal code snippet possible, that explore the problem. No comments, no types, just the code. This is the real code I'm currently refactoring:

<?php

final class Product
{
    private $price;

    public function __construct(float $price)
    {
        $this->price = $price;
    }

    public function getPrice(): Price
    {
        return new Price($this->price, CurrencyProvider::get());
    }
}

final class Price
{
    private $amount;

    private $currency;

    public function __construct(float $amount, Currency $currency)
    {
        $this->amount = $amount;
        $this->currency = $currency;
    }

    public function getAmount()
    {
        return $this->currency->convertFromCzk($this->amount);
    }
}

2. Describe the Code

Then I describe the problem with a few words using your common sense. No censorship, just flow of words.

"There is a Product object... no, an entity since I can have multiple products. It has active record pattern since it creates Price in itself. There is also static service locator CurrencyProvider::get() to get current currency. I have no idea where the currency is set and it can be overridden multiple times during code run.

The goal of all this is probably to have price always in the same currency. Which is not true, since I can change the currency anytime I want. The price computation is input/output relations - so it should be solved by service, not an entity. I'm confused."

3. Break The Code

My favorite part. How can we break this code?

<?php

$product = new Product(100.0);

CurrencyProvider::set('czk');
$product->getPrice(); // 100

CurrencyProvider::set('eur'); // this will be invoked in some other method, where the user needs a special price for newletter in Germany
$product->getPrice(); // ups, 2500?
1. An entity with the same ID can return different values on different calls of the same method.

It's like my name would be "Tom" in the morning and "John" in the afternoon.


<?php

$product = new Product(100.0);
$product->getPrice(); // Error: 2nd argument of price cannot be null

CurrencyProvider::set('czk');
2. Due to a static design of CurrencyProvider, we cannot set currency at the single place of application, e.g. container creation, but we have to put it in the "right" place so it doesn't break the code. Here it broke the code because we set it too late.

<?php

$product = new Product(100.0);

$allCurrencies = /* get from database */;
foreach ($allCurrencies as $currency) {
    CurrencyProvider::set($currency);
    echo $product->getPrice();
}

// what is the currency now?
3. How do I show a price for all the currencies we support?

3. The Ideal World

Now I imagine how I want this code to be designed in an ideal world, with enough time and skills. My goal is to make code work, while minimal as possible, while readable as quickly as possible. So when I leave the company, the person who reads the code will understand it at the same speed as I did.

  1. There will be a service that will take care of price computation.

  2. It will accept Product and Currency as an argument.

  3. That way it's easy to tests, method parameters are clearly stating dependencies, nothing to surprise.

4. Put Ideal World into Code

Now put that ideal into PHP code:

<?php

final class Product
{
    private $price;

    public function __construct(float $price)
    {
        $this->price = $price;
    }

    public function getPrice()
    {
        return $this->price;
    }
}

final class Currency
{
    private $name;

    public function __construct(string $name)
    {
        $this->name = $name;
    }
}

final class PriceCalculator
{
    public function calculatePriceForProductAndCurrency(Product $product, Currency $currency): float
    {
        // ... computing algorithm ...
        return $price;
    }
}

And then use:

<?php

final class ProductController
{
    public function render()
    {
        $product = new Product(1000.0);
        $currency = new Currency('czk'); // default will be configured parameters in config.yaml

        $price = $this->priceCalculator->calculatePriceForProductAndCurrency($product, $currency);

        echo $price;
    }
}

This is the thought process of most refactorings. It is mostly intuition until now. A small piece of code → the problem → the idea of how code should look like → the solution. Just commit and send for review, right?


Martin Fowler once said:

Refactoring is a controlled technique for improving the design of an existing code base. Its essence is applying a series of small behavior-preserving transformations, each of which "too small to be worth doing".

However the cumulative effect of each of these transformations is quite significant. By doing them in small steps you reduce the risk of introducing errors. You also avoid having the system broken while you are carrying out the restructuring - which allows you to gradually refactor a system over an extended period of time.

This worked well for a long period of time. Today I feel confident enough to say this paradigm is dead - and it's a good thing!

In 2019, we can do refactoring in one big step in short period of time - and still get working application in the end.

Clear proof is PHPStorm refactorings over the whole code base. They're still dumb compared to human and sometimes cause errors, but they get better and better each version. Trend beats the status quo. You probably also know Php Inspections (EA Extended) plugin to PHPStorm.


It's easy to use these tools, but they still tend to solve the most generic problems. Instead of just blindly using rules in these tools, we'll learn how to build them to solve your problem.


5. Extract The Journey

Back to the thinking process. This last step might seem a bit weird. We already have the clear code up and running and it's ready to ship. Why would we invest more energy into this? If I don't learn from this, I'm sentencing my future self to do it again in the future. It's funny to watch companies how they go for "a business value", try to delivery features fast, but never pause to realize, that they do mostly repetitive tasks for the same price as the first one. So by this strategy to deliver business value fast, they cut their business value in half.

Think Big Think Absolute

Instead, I ask myself: "how would I describe the process step by step to a machine, so it could refactor all PHP code on Github, Gitlab and the whole world with the same issue to the one in the end?" There could be billions of such cases in the whole-world PHP code base.

If we're able to describe the process, we'll turn billions of use cases to 1 pattern transformation.

Imagine you try to fix typos one-by-one manually. Or you could write a function, that fixes 5 most common typos for the user and hooks it on the Internet and SMS network (regardless of security) - to process every electronic message in the world. Just like that, the world became smarter thanks to you single function.

I disagree with Martin's statement: "Its essence is applying a series of small behavior-preserving transformations". It's not about the behavior of code anymore. Much more important is the pattern in the code. We don't care about Price, nor Currency (it could be also called Name and Invoice).


Instead we look at "static call in an object".


And what we did with that pattern it? Give your ideas in the comments or wait for the next post.


Happy coding!




Do you learn from my contents or use open-souce packages like Rector every day?
Consider supporting it on GitHub Sponsors. I'd really appreciate it!