Webs y aplicaciones

Instalar y actualizar Magento 2.4 sin Elasticsearch ni OpenSearch

Revisado el 6 min de lectura instalación compatibilidad Magento

Desde la versión 2.4, Magento eliminó la búsqueda por MySQL que usaban las versiones anteriores y exige un motor de búsqueda externo: Elasticsearch u OpenSearch, según la versión (las más recientes usan OpenSearch). Puedes ver cuál pide la tuya en la tabla de requisitos de Adobe Commerce.

Estos motores son servicios que se quedan ejecutándose en segundo plano y necesitan varios GB de memoria, así que no se pueden instalar en un hosting compartido como el nuestro. Tienes dos caminos:

  • Contratar un servicio gestionado de OpenSearch o Elasticsearch, como Elastic Cloud o Bonsai, y configurar sus datos de conexión en Magento. Es lo que recomienda Adobe, pero supone un coste mensual que en tiendas pequeñas o medianas puede no compensar.
  • Desactivar los módulos de Elasticsearch/OpenSearch y usar MySQL como buscador con un módulo gratuito. Es lo que explica esta guía.

Ver qué módulos de búsqueda tiene tu versión

Los nombres de los módulos cambian según la versión de Magento. Por ejemplo, en 2.4.0–2.4.5 existen Magento_Elasticsearch6 y Magento_Elasticsearch7, y en las versiones recientes Magento_Elasticsearch8 y Magento_OpenSearch. Para ver los de tu instalación, entra por SSH en la carpeta de Magento y ejecuta:

php bin/magento module:status | grep -E 'Elasticsearch|OpenSearch'

Usa esos nombres en los comandos de abajo.

Instalar Magento 2.4 sin Elasticsearch

Si instalas Magento a mano, indica en setup:install que no active los módulos del motor de búsqueda con --disable-modules. En una versión reciente:

php bin/magento setup:install \
--disable-modules=Magento_InventoryElasticsearch,Magento_Elasticsearch8,Magento_OpenSearch,Magento_Elasticsearch \
...resto de parámetros de instalación...

En Magento 2.4.0–2.4.5, la lista es Magento_InventoryElasticsearch,Magento_Elasticsearch7,Magento_Elasticsearch6,Magento_Elasticsearch.

Actualizar a Magento 2.4 sin Elasticsearch

Si actualizas una tienda que no tiene motor de búsqueda configurado, setup:upgrade se detendrá con un error de conexión a Elasticsearch u OpenSearch. Desactiva antes los módulos que te ha mostrado module:status:

php bin/magento module:disable Magento_Elasticsearch \
Magento_Elasticsearch8 \
Magento_OpenSearch \
Magento_InventoryElasticsearch

En Adobe Commerce (la versión de pago) añade también Magento_ElasticsearchCatalogPermissions. Después sigue la actualización con normalidad.

Tras desactivar los módulos, la tienda funciona pero no tiene buscador. Para recuperarlo usaremos Legacy MySQL Search de Swissup: un módulo gratuito que recupera en Magento 2.4 la búsqueda por MySQL de la 2.3 y que sigue mantenido (versión 1.1.14).

Desde la carpeta de Magento:

composer config repositories.swissup composer https://docs.swissuplabs.com/packages/
composer require swissup/module-search-mysql-legacy --prefer-source --ignore-platform-reqs
php bin/magento module:enable Swissup_SearchMysqlLegacy Swissup_Core
php bin/magento setup:upgrade --safe-mode=1
php bin/magento setup:di:compile
php bin/magento config:set catalog/search/engine 'lmysql'
php bin/magento indexer:reindex catalogsearch_fulltext

Estos comandos instalan el módulo, lo activan, eligen MySQL como motor de búsqueda y reindexan el catálogo. Si la tienda está en modo producción, ejecuta después php bin/magento setup:static-content:deploy es_ES y php bin/magento cache:flush.

También puedes elegir el motor desde el administrador, en Stores > Configuration > Catalog > Catalog > Catalog Search > Search Engine: desmarca Use system value y selecciona Legacy MySQL (Deprecated).

Campo Search Engine con Legacy MySQL seleccionado en la configuración de Magento

Para comprobar el motor activo:

php bin/magento config:show catalog/search/engine

Debe responder lmysql. Haz una búsqueda en la tienda para confirmar que devuelve productos.

Por defecto, una búsqueda de varias palabras («bolso rojo») devuelve los productos que contienen cualquiera de ellas. Para que solo salgan los que tienen todas, como con Elasticsearch, cambia Multi-word Search Logic (MySQL Legacy) a AND en la misma sección de Catalog Search y ejecuta php bin/magento cache:clean config.

Otra alternativa: Algolia

Algolia es un buscador externo como servicio, con plan gratuito para catálogos y volúmenes de búsqueda pequeños. Tiene extensión oficial para Magento 2; también requiere desactivar los módulos de Elasticsearch/OpenSearch como se explica arriba si no tienes uno configurado.

Errores frecuentes

  • Falta de memoria al ejecutar Composer o bin/magento («Allowed memory size exhausted»): ejecuta el comando con php -d memory_limit=-1, por ejemplo php -d memory_limit=-1 bin/magento setup:di:compile, o sube memory_limit en cPanel.
  • setup:upgrade falla con «Current version of RDBMS is not supported»: no es cosa del buscador. Magento comprueba la versión de la base de datos y solo acepta algunas; por ejemplo, Magento 2.4.8 admite MySQL 8.0 y 8.4, y MariaDB hasta la 10.6 y la 11.4. Escríbenos y te indicamos qué versión tiene tu servidor.

También te puede ayudar

¿Algo no cuadra o ha cambiado? Cuéntanoslo y lo revisamos.