Description of a manual installation is missing about mezzio

[froschdesign]

So, adding this to documentation would suffice?

We need a separate page which shows the different ways for an installation. Creating a project via the skeleton application is one of them. The manual installation may be another.
An entry "Installation" is completely missing in the navigation: https://docs.mezzio.dev/mezzio/

[weierophinney]

It's not broken, you are missing a psr/http-message-implementation, e.g. zendframework/zend-diactoros

So I guess this would do:
composer require zendframework/zend-expressive zendframework/zend-diactoros

---

Originally posted by @JoeBengalen at zendframework/zend-expressive#624 (comment)

[weierophinney]

@ksemeks One new tool for you: composer why-not <package>. This will give you detailed information on what blocks installation of a package.

That said, your error message indicates the issue:

zendframework/zend-httphandlerrunner 1.0.1 requires psr/http-message-implementation ^1.0 -> no matching package found.

We do not currently cover installation within an existing project, which tells me this should be documented. I'm adding the "documentation" and "help wanted" labels presently, so somebody can pick that up.

---

Originally posted by @weierophinney at zendframework/zend-expressive#624 (comment)

[arueckauer]

Currently Mezzio requires an implementation of psr/http-message-implementation as well as laminas/laminas-httphandlerrunner. This can be achieved with e.g.:

composer require laminas/laminas-diactoros laminas/laminas-httphandlerrunner mezzio/mezzio

However, this does not add the same value as utilizing mezzio/mezzio-skeleton which in addition sets up a directory structure and installs a DI, a router and optionally a template engine and error handler.

The documentation of this process is cumbersome and of little value, since it first adds little value for very few users using this scenario and secondly it is much easier to run the mezzio/mezzio-skeleton installer and copy the necessary components over to the existing project.

IMO this is a won't fix of an edge case.

[froschdesign]

@arueckauer

The documentation of this process is cumbersome and of little value, since it first adds little value for very few users using this scenario and secondly it is much easier to run the mezzio/mezzio-skeleton installer and copy the necessary components over to the existing project.

A documentation page for the installation is still missing and a manual installation should also be added there.

composer require laminas/laminas-diactoros laminas/laminas-httphandlerrunner mezzio/mezzio

laminas-httphandlerrunner can be omitted from this command:

mezzio/composer.json

Lines 39 to 43 in d5bf81f

	"require": {
	"php": "~7.4.0||~8.0.0||~8.1.0",
	"fig/http-message-util": "^1.1.5",
	"laminas/laminas-httphandlerrunner": "^2.1",
	"laminas/laminas-stratigility": "^3.5",

[arueckauer]

A documentation page for the installation is still missing and a manual installation should also be added there.

I am missing something here. What is the value of adding only mezzio/mezzio to an existing project? Would the documentation cover routing and DI, application structure, ...?

composer require laminas/laminas-diactoros laminas/laminas-httphandlerrunner mezzio/mezzio

laminas-httphandlerrunner can be omitted from this command:

mezzio/composer.json

Lines 39 to 43 in d5bf81f

	"require": {
	"php": "~7.4.0||~8.0.0||~8.1.0",
	"fig/http-message-util": "^1.1.5",
	"laminas/laminas-httphandlerrunner": "^2.1",
	"laminas/laminas-stratigility": "^3.5",

You are right. Good catch!

[froschdesign]

I am missing something here. What is the value of adding only mezzio/mezzio to an existing project? Would the documentation cover routing and DI, application structure, ...?

Sorry, I was a bit unclear here. I mean only the manual installation, not any integration. I think an integration or a migration can be a topic for blog post or something similar.

[arueckauer]

So, adding this to documentation would suffice?

Prior to manually installing Mezzio, check if the project has an implementation of psr/http-message-implementation. If does not, add one of your choice, e.g.:

composer require laminas/laminas-diactoros mezzio/mezzio

[froschdesign]

Will be fixed with #119