Buy

Extensibility with Interfaces & Aliases

With a Subscription, click any sentence in the script to jump to that part of the video!

Login Subscribe

I want to make two other changes to the new "word provider" setup. The first is optional: it's another common method for making the word provider configurable.

Go back into our services.xml file. Right now, we set the first argument inside of the XML file, then override that argument in the extension class, if a different value is provided. Another option - and we'll talk about the advantages later - is to use a service alias.

Copy the alias we created earlier in order to enable autowiring. Create a new alias whose id is knpu_lorem_ipsum.word_provider and set the alias to the knp_word_provider service id above.

18 lines lib/LoremIpsumBundle/src/Resources/config/services.xml
... lines 1 - 6
<services>
... lines 8 - 13
<service id="knpu_lorem_ipsum.word_provider" alias="knpu_lorem_ipsum.knpu_word_provider" public="false" />
... line 15
</services>
... lines 17 - 18

Thanks to this, there is now a new service in the container called knpu_lorem_ipsum.word_provider. But when someone references it, it actually just points to our knpu_lorem_ipsum.knpu_word_provider. Now, for the argument to KnpUIpsum, pass the alias id instead.

18 lines lib/LoremIpsumBundle/src/Resources/config/services.xml
... lines 1 - 7
<service id="knpu_lorem_ipsum.knpu_ipsum" class="KnpU\LoremIpsumBundle\KnpUIpsum" public="true">
<argument type="service" id="knpu_lorem_ipsum.word_provider" />
</service>
... lines 11 - 18

So far, this won't change anything. But open the extension class. Instead of changing the argument, we can override the alias to point to their service id. Do this with $container->setAlias(). First pass knpu_lorem_ipsum.word_provider and set this alias to $config['word_provider']. We don't need the new Reference() here because the setAlias() method expects this to be a service ID.

34 lines lib/LoremIpsumBundle/src/DependencyInjection/KnpULoremIpsumExtension.php
... lines 1 - 10
class KnpULoremIpsumExtension extends Extension
{
public function load(array $configs, ContainerBuilder $container)
{
... lines 15 - 21
if (null !== $config['word_provider']) {
$container->setAlias('knpu_lorem_ipsum.word_provider', $config['word_provider']);
}
... lines 25 - 26
}
... lines 28 - 32
}

And before even trying it, copy the service alias, find your terminal, and run:

php bin/console debug:container --show-private knpu_lorem_ipsum.word_provider

Yes! This is an alias to our CustomWordProvider. And that means that the first argument to KnpUIpsum will use that. Refresh to make sure it still works. It does!

There's no amazing reason to use this alias strategy versus what we had before, but there are two minor advantages. First, if we needed to reference the word provider service in multiple places - probably in services.xml - using an alias is easier, because you don't need to remember to, for example, replace 5 different arguments where the service is used. And second, if we wanted this service to be used directly by our users, creating an alias is the only way to give them a service id they can reference, even if they override the word provider to be something else.

Creating a WordProviderInterface

Ok, our setup is really, really nice. But there is one restriction we're putting on our user that we really do not need to! Open KnpUIpsum and scroll all the way to the constructor. The first argument is type-hinted with KnpUWordProvider. This means that if the user wants to create their own word provider, they must extend our original KnpUWordProvider. We are doing this... because we just want to add a new word to the list, but this should not be required! All we care about is that the service has a getWordList() method that returns an array.

In other words, this is the perfect use-case for an interface! Wooo! In the bundle, create a new PHP class. Call it WordProviderInterface and change the "kind" from class to interface.

Inside, add the getWordList() method and make it return an array. This is also the perfect place to add some documentation about what this method should do.

14 lines lib/LoremIpsumBundle/src/WordProviderInterface.php
... lines 1 - 4
interface WordProviderInterface
{
/**
* Return an array of words to use for the fake text.
*
* @return array
*/
public function getWordList(): array;
}

With the interface done, go back to KnpUIpsum, change the type-hint to WordProviderInterface. The user can now pass anything they want, as long as it has this getWordList() method... because that is what we're using at the bottom of KnpUIpsum.

211 lines lib/LoremIpsumBundle/src/KnpUIpsum.php
... lines 1 - 9
class KnpUIpsum
{
... lines 12 - 17
public function __construct(WordProviderInterface $wordProvider, bool $unicornsAreReal = true, $minSunshine = 3)
... lines 19 - 209
}

Then, of course, we also need to go open our provider and make sure it implements this interface: implements WordProviderInterface.

143 lines lib/LoremIpsumBundle/src/KnpUWordProvider.php
... lines 1 - 4
class KnpUWordProvider implements WordProviderInterface
{
... lines 7 - 142
}

If you try it now... not broken! And yea, our CustomUserProvider will still extend KnpUWordProvider, but that's now optional - we could just implement the interface directly.

Next, let's take a big step and move our bundle out of our code and give it it's own composer.json file!

Leave a comment!