Bring PHP 8.3 compatibility to magento/module-elasticsearch-8

[git-seb]

Description

Tried to install magento/elasticsearch-8 into our Magento 2.4.7 instance through composer but was not able to.

The current composer package only works together with PHP version up to 8.2 as well as psr/http-message up to version 1.1.

Expected behavior

Make compatible with PHP 8.3.* (maybe even 8.4.*?) and psr/http-message ^2.0, so magento/elasticsearch-8 can be installed successfully.

Benefits

Better compatibility

Additional information

No response

Release note

No response

[m2-assistant]

Hi @git-seb. Thank you for your report.
To speed up processing of this issue, make sure that the issue is reproducible on the vanilla Magento instance following Steps to reproduce.

• For more details, review the Magento Contributor Assistant documentation.
• Add a comment to assign the issue: @magento I am working on this
• To learn more about issue processing workflow, refer to the Code Contributions.

---

Join Magento Community Engineering Slack and ask your questions in #github channel.
⚠️ According to the Magento Contribution requirements, all issues must go through the Community Contributions Triage process. Community Contributions Triage is a public meeting.
🕙 You can find the schedule on the Magento Community Calendar page.
📞 The triage of issues happens in the queue order. If you want to speed up the delivery of your contribution, join the Community Contributions Triage session to discuss the appropriate ticket.

[devchris79]

This could be related to #38416

[hostep]

You need to downgrade aws/aws-sdk-php to a lower version, it's them that require psr/http-message >= 2.0 and cause a conflict.

Here's how you can get it to be installed:

$ composer require magento/module-elasticsearch-8 --no-update
$ composer update magento/module-elasticsearch-8 aws/aws-sdk-php -W

This works for me on Magento 2.4.7-p4 with PHP 8.3

(you can discover this by running composer why psr/http-message)

[hostep]

@git-seb: can you confirm the above steps works for you?

The ES8 module is definitely compatible with PHP 8.3, it's just that the output composer gives can be a bit misleading, the true underlying issue is the conflict with psr/http-message which can be solved by downgrading the aws/aws-sdk-php package.

[hostep]

@jeff-matthews : should we update the section "Upgrade Elasticsearch" in https://experienceleague.adobe.com/en/docs/commerce-operations/upgrade-guide/prepare/prerequisites#search-engine with this info? When that documentation was written, this problem didn't happen yet because aws/aws-sdk-php was not requiring psr/http-message >= 2.0 back then.

Also, we should mention on that section that in the upcomming Magento 2.4.8 release those steps aren't needed anymore, because ES8 support is now included by default and you don't need to install that module separately anymore.

[jeff-matthews]

Thanks for tagging me @hostep. Yes, I think it makes sense to update the docs. I'll draft something and ping you in the AdobeDocs/commerce-operations.en repo.

[furan917]

That's not quite the whole picture.
via testing on a new 2.4.7-p4 instance.

opensearch-php Also requires http-message: ^2.0 above version 2.4.0 and if you run the above command you can still get the same error message likely because it conflicts with another require that doesn't directly point that out.

# composer why opensearch-project/opensearch-php
magento/module-open-search        100.4.1  requires opensearch-project/opensearch-php (^1.0 || ^2.0)
magento/product-community-edition 2.4.7-p4 requires opensearch-project/opensearch-php (^1.0 || ^2.0)

So you need both opensearch-php:2.3.1 and aws-sdk-php:3.337.2 at max otherwise you get the another require error message that doesn't get fixed with -W.
Also I think this locks you out of a PHP 8.4 upgrade path until you migrate to opensearch as the AWS later versions are what enable PHP 8.4 support for their package? (Didnt validate, scan read the release note)

[hostep]

You're right @furan917, somehow opensearch was already at a lower version for me, so I didn't notice this problem.

So the correct steps are then:

$ composer require magento/module-elasticsearch-8 --no-update
$ composer update magento/module-elasticsearch-8 aws/aws-sdk-php opensearch-project/opensearch-php -W

As for the future, as far as I know Magento 2.4.8 will launch with PHP 8.4 compatibility and with the ES8 module installed by default, so I guess it should be fine. It's however hard to predict from the outside, but we'll see what happens on 8 April 2025 when Magento 2.4.8 gets released.