Add ability to modify docker-compose configuration

[rmccue]

Adds the ability for any Composer package (including the root/project itself) to modify the docker-compose configuration, making it possible for modules to add containers or alter the existing configuration.

This can be used for better modularity and conditional behaviour, such as for optional features like Elasticsearch or Node.js. It also provides the ability for users to customise Docker behaviour fairly directly in their project.

My plan is to transition the ES + Kibana containers to the Enhanced Search package, and then eventually someday remove it from the default bundle, allowing a clearer opt-in for customers who have actually bought it. PR for that incoming soon.

[mikelittle]

A couple of suggestions.
Also, the lint issues will need fixes (mostly missing docs).

[mikelittle]

Suggested change

	Local Server internally uses Docker Compose to create and manage containers for the Altis environment. When a user runs the `composer server start` command, Local Server dynamically provisions a `docker-compose.yml` file based on the user's preferences. (This file is only regenerated when starting Local Server to avoid conflicts or surprising behaviour for users.)
	Local Server internally uses Docker Compose to create and manage containers for the Altis environment. When a user runs the `composer server start` command, Local Server dynamically provisions a `docker-compose.yml` file based on the user's preferences. (This file is only regenerated when starting Local Server to avoid conflicts or surprising behaviour for users.)

[mikelittle]

Could you also wrap lines at 132 chars please? As per our MD linting standards.

[mikelittle]

This would be clearer as a positive test:

Suggested change

	if ( ! isset( $extra['altis'] ) || ! isset( $extra['altis']['local-server'] ) ) {
	if ( isset( $extra['altis'] ) && isset( $extra['altis']['local-server'] ) ) {
	$config[ $name ] = $extra['altis']['local-server'];
	}

[rmccue]

I'd agree if it were a straight if/else, but this is more of a return-early pattern. Not strongly opinionated so if you feel it's much more readable that way I'll update

[mikelittle]

Maybe empty would read better. if (empty( $extra['altis']) || (empty($extra['altis']['local-server']))

[mikelittle]

I like the idea of this.
It might be an opportunity to stop using the implicit dependency and networking configuration of links. Instead, we should use explicit depends_on and networks attributes.

[CodeProKid]

@rmccue Just noting that we'd love to have the ability to do modify the docker compose from our own project! Our immediate use case for this would be to prefix all of the image names in the generated docker-compose file with our internal docker hub proxy URL so they get pulled from there instead of directly from docker hub which will prevent us from running into docker hub API limits in CI.

It looks like we'd be able to achieve this quite easily with the way this feature has been designed 😃

[mikelittle]

I did test this locally with the ES example. It highlighted a weird error that I think it is a dependency issue, though it doesn't make sense.
With this branch and the ES PR checked out, I get the following error on startup:

$ composer server start
Starting...
PHP Fatal error:  Declaration of Symfony\Component\Console\Input\ArrayInput::hasParameterOption(array|string $values, bool $onlyParams = false): bool must be compatible with Symfony\Component\Console\Input\InputInterface::hasParameterOption($values, bool $onlyParams = false) in /Users/mikelittle/sandbox/02-altis/product-dev/vendor/symfony/console/Input/ArrayInput.php on line 50

Fatal error: Declaration of Symfony\Component\Console\Input\ArrayInput::hasParameterOption(array|string $values, bool $onlyParams = false): bool must be compatible with Symfony\Component\Console\Input\InputInterface::hasParameterOption($values, bool $onlyParams = false) in /Users/mikelittle/sandbox/02-altis/product-dev/vendor/symfony/console/Input/ArrayInput.php on line 50

Grep-ing for the function gets me three hits—all correct:

$ grep -r 'hasParameterOption'
... skipping calls
vendor/symfony/console/Input/ArrayInput.php:    public function hasParameterOption(string|array $values, bool $onlyParams = false): bool
vendor/symfony/console/Input/ArgvInput.php:    public function hasParameterOption(string|array $values, bool $onlyParams = false): bool
vendor/symfony/console/Input/InputInterface.php:    public function hasParameterOption(string|array $values, bool $onlyParams = false): bool;

So far, I made it work by specifying "symfony/console": "5.4" as a requirement in dev-tools. I've not committed this yet, But will see if the problem shows up elsewhere.

However, this issue apart, the code did work. I could enable/disable the Elastic Search container from the Enhanced Search module.