Cómo instalar y configurar Magento 2 en Localhost mediante XAMPP – Guía detallada

Magento 2 tiene requisitos de servidor muy específicos que requieren mucha configuración y ajustes del servidor, junto con la configuración de Composer (que no es una opción predeterminada en muchas plataformas). En este tutorial, te mostraré cómo instalar y configurar Magento 2 en un host local utilizando XAMPP.

XAMPP es una solución de servidor web multiplataforma gratuita y de código abierto que te permite ejecutar Magento 2 en tu máquina local para fines de desarrollo y pruebas. Al final de este tutorial, tendrás una instalación completamente funcional de Magento 2 ejecutándose en tu localhost.

Ventajas de Magento 2 en Localhost

Estas son las siguientes ventajas de instalar Magento 2 en un localhost:

• Ejecutar Magento 2 en localhost elimina la necesidad de un plan de alojamiento dedicado, que puede ser costoso.
• Una instalación local de Magento 2 te permite trabajar en tu sitio web sin conexión a Internet.
• Una instalación localhost permite a los desarrolladores probar nuevas funciones y extensiones antes de desplegarlas en un sitio activo.
• Una instalación localhost te permite personalizar tu sitio web sin riesgo de romper el sitio en vivo.
• Los entornos localhost suelen funcionar más rápido que los servidores remotos, porque no hay latencia en la comunicación de red.
• Al ejecutar Magento 2 en un host local, puedes proteger tu tienda de accesos no autorizados e intentos de pirateo.
• Una instalación localhost te permite hacer fácilmente copias de seguridad y restaurar tu sitio web en caso de problema.

Experimenta la Tienda Demo Magento 2 de Cloudways – ¡No necesitas conocimientos técnicos!

Experimenta una tienda Magento 2 totalmente funcional construida sobre el renombrado alojamiento Cloudways para ofrecer las velocidades más rápidas.

PRUEBA LA DEMO AHORA

Requisitos previos de Magento 2 para Localhost

Antes de instalar Magento utilizando Composer, debes comprobar los requisitos previos y los requisitos del sistema que deben instalarse.

• Apache/NGINX Versión 2.2 o 2.4
• Versión PHP 7.4.x o 8.1.x
• MySQL/MariaDB Versión 5.6.x, 5.7.x o Maria DB
• Elasticsearch 7.6.x o superior

Lleva tu tienda Magento al siguiente nivel con Cloudways.

Empieza hoy mismo y disfruta de velocidades de carga ultrarrápidas, escalabilidad sin fisuras y asistencia experta 24 horas al día, 7 días a la semana.

¡Prueba 3 días gratis!

Instalar y configurar XAMPP

Cubriré la instalación de Magento 2 en localhost para que no te encuentres con ningún problema mientras sigues el proceso.

Paso: 1 Descarga el Servidor XAMPP

Ve a Amigos de Apache y Descarga el Servidor XAMPP.

Magento recomienda encarecidamente instalar XAMPP con PHP versión 8.1.x para M2.4.5. También puedes instalar Magento 2.4 con PHP 7.3, pero no está probado ni recomendado.

Paso: 2 Instalar el servidor XAMPP

Después de descargar XAMPP, haz doble clic en el archivo para instalarlo en tu ordenador.

Pulsa el botón Siguiente.

Deja la selección por defecto como en la imagen. Pulsa el botón Siguiente.

Elige tu carpeta de instalación. La ubicación por defecto es C:\xampp, pero se recomienda seleccionar un directorio distinto de la unidad C:\ como D:\ o E:\ según te convenga.

Si necesitas cambiar, haz clic en el icono Examinar para cambiar el destino del programa XAMPP y, a continuación, haz clic en el botón Siguiente para ir al paso siguiente.

Pulsa el botón Siguiente.

Pulsa el botón Siguiente.

Espera a que el asistente de configuración instale XAMPP en tu ordenador.

Una vez finalizada la configuración, verás la opción «¿Quieres iniciar ahora el Panel de Control?«. Mantenla seleccionada. Pulsa Finalizar para salir de la instalación y entrar en el Panel de Control de XAMPP.

Paso: 3 Configurar PHP

En el Panel de Control de XAMPP, haz clic en el botón Config de la fila Apache, y haz clic en PHP (php.ini).

 

En el archivo php.ini, busca estas filas y elimina el punto y coma (😉 antes de cada fila:

;extensión=intl

;extension=jabón

;extensión=sockets

;extensión=sodio

extensión=xsl

;extensión=gd

Amplía el límite_de_memoria a 4G:

memory_limit=4G

Cuando lo hayas hecho, guarda y cierra el archivo. A continuación, haz clic en el botón Iniciar en 2 filas de Apache y MySQL para iniciarlos. No salgas de XAMPP después de este paso, sólo deja que se ejecute.

Paso: 4 Configurar el Archivo Hosts

Accede al directorio C:\Windows\System32\drivers\etc\hosts.

Añade la siguiente línea a la última fila:

127.0.0.1 www.localhost.com

Abre el Panel de Control de XAMPP e inicia las aplicaciones Apache y MySQL .

Crear una base de datos en phpMyAdmin

Accede a la URL http://localhost/phpmyadmin, para crear una base de datos. Introduce un nombre de base de datos (por ejemplo, Magento2) y haz clic en Crear.

Pulsa el botón Siguiente para crear la base de datos.

Base de datos creada correctamente.

Nota: Recuerda el nombre de la base de datos que vas a crear, ya que más adelante querrás instalar Magento en ella.

Instalar Composer para Magento

La última versión de Magento, la 2.4.0 de código abierto en adelante, es compatible con Composer 2. Así que necesitas instalar Composer 2 para descargar Magento 2 con la última versión.

La mejor forma de hacerlo es descargar y ejecutar Composer-Setup.exe. Esto instalará la última versión y configurará tu ruta para «llamar» aComposer desde cualquier directorio.

Haz clic en el botón Siguiente y busca la ruta PHP en la carpeta XAMPP.

Es opcional introducir la URL de tu proxy.

Ahora pulsa el botón Instalar para iniciar el paso final.

Pulsa el botón Siguiente.

Pulsa el botón Finalizar.

Inicia el símbolo del sistema y ejecuta el comando Composer para comprobar que se ha instalado sin problemas.

Descargar Magento Using Composer

A continuación, cd a C:\xampp\htdocs y ejecuta el siguiente comando utilizando Composer para Descargar una versión específica de Magento 2.

composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition=2.4.5 <install-directory-name>

Magento Código Abierto

composer create-project --repository-url=https://repo.magento.com/magento/project-community-edition:2.4.5

Adobe Commerce (Empresa)

composer create-project --repository-url=https://repo.magento.com/magento/project-enterprise-edition:2.4.5

Con el comando anterior, puedes especificar la versión concreta de Magento (2.0, 2.1, 2.2.1, 2.2.2, 2.2.3, 2.2.4, 2.2.5, 2.2.6, 2.3, 2.4). Si no es así, omite la versión y simplemente ejecuta el comando que aparece a continuación:

A continuación, introduce tus claves de autenticación de Magento. Las claves públicas y privadas se crean y configuran en tu cuenta de Magento marketplace.

Navega hasta el nombre de la Cuenta en la parte superior derecha de la página y selecciona Mi Perfil.

A continuación, haz clic en las Claves de acceso de la pestaña Mercado .

Haz clic en Crear una nueva clave de acceso. Introduce un nombre específico para las claves (por ejemplo, el nombre del desarrollador que recibe las claves) y haz clic en Aceptar.

Copia la Clave Pública en el nombre de usuario y la Clave Privada en la contraseña para instalar Magento.

El compositor debería tardar un rato en descargar e instalar todos los módulos necesarios. Cuando todo haya terminado, esto es lo que deberías ver:

Instalar Elasticsearch para Magento 2

Elasticsearch es una extensión muy recomendable para las versiones 2.4.X de Magento.

Descarga Elasticsearch 7.6.0: https://www.elastic.co/downloads/past-releases/elasticsearch-7-6-0 (Magento 2.4.x sólo se ha probado con Elasticsearch 7.6.x. Puedes utilizar otras versiones 7.x a tu discreción, pero te recomendamos que utilices la versión probada de Elasticsearch).

Extrae el archivo .zip que acabas de descargar. En una ventana de terminal, ve al directorio extraído y ejecuta este comando:

.\bin\elasticsearch.bat

También puedes comprobar la disponibilidad de Elasticsearch en el puerto:9200. Escribe local:9200 en el navegador, y obtendrás los detalles de la extensión Elasticsearch instalada.

{
"name" : "DESKTOP-Jyoti",
"cluster_name" : "elasticsearch",
"cluster_uuid" : "ONNrUlTWQCSoigYBy6WF9g",
"version" : {
"number" : "7.9.3",
"build_flavor" : "default",
"build_type" : "zip",
"build_hash" : "c41E4fgiueQSoiytrBW",
"build_date" : "2023-02-02T09:51:41.449Z",
"build_snapshot" : false,
"lucene_version" : "8.7.0",
"minimum_wire_compatibility_version" : "6.8.3",
"minimum_index_compatibility_version" : "6.8.3"
},
"tagline" : "You Know, for Search"
}

Instalar Magento 2 usando la línea de comandos

Abre la ventana del símbolo del sistema. A continuación, ve al directorio de Magento y ejecuta el comando:

php bin/magento setup:install --base-url="http://localhost/magento2/" --db-host="localhost" --db-name="dbmagento241" --db-user="root" --admin-firstname="admin" --admin-lastname="admin" --admin-email="[email protected]" --admin-user="admin" --admin-password="admin123" --language="en_US" --currency="USD" --timezone="America/Chicago" --use-rewrites="1" --backend-frontname="admin" --search-engine=elasticsearch7 --elasticsearch-host="localhost" --elasticsearch-port=9200

Nota: Asigna la URL base según tu ruta, anota el nombre de usuario y la contraseña del administrador y no utilices el puerto de Elasticsearch.

Sustituye estos valores:

• -base-url: tu carpeta de instalación de magento 2
• -db-name: el nombre de tu base de datos al crearla
• -db-contraseña: la contraseña de tu base de datos
• -db-user: un usuario de base de datos con todos los permisos. Utilizaremos el usuario raíz por defecto.
• -db-password: la contraseña de tu usuario de base de datos. Déjalo en blanco si utilizas el usuario de base de datos «root».
• -admin-nombre: Nombre del administrador
• -admin-apellido: Apellido del administrador
• -email-admin: Dirección de correo electrónico del administrador
• -admin-user: el nombre de usuario que utilizarás para acceder al Panel de Administración
• -contraseña-admin: la contraseña que utilizarás para acceder al Panel de Administración
• -idioma: el idioma que utilizarás en tu Panel de Administración y en tu escaparate. Utiliza un código de idioma como en_US.
• -admin-email: cámbialo por tu correo electrónico
• -moneda: establece la moneda predeterminada que se utilizará en tu tienda. Introduce php bin/magento info:moneda:lista para obtener una lista de las monedas admitidas junto con sus códigos.
• -timezone: cambia a la zona horaria en la que te encuentres. Consulta la lista de zonas horarias admitidas para tener una idea más clara de la que debes rellenar.
• -url-rewrites: ponlo a 1 para activar las Reescrituras del Servidor Web. Esto ayudará al posicionamiento de tu sitio.
• -backend-frontname: establece tu URL de Admin. Si omites este parámetro, aparecerá una URL generada aleatoriamente para tu ruta de administración de Magento (por ejemplo, admin_jkhgdfq).
• -search-engine: establece la versión de Elasticsearch que quieres utilizar para esta instalación de Magento. Por defecto es elasticsearch7
• -elasticsearch-host: el nombre de host o la dirección IP donde se ejecuta Elasticsearch. Por defecto es localhost
• -elasticsearch-port: el número de puerto en el que escucha Elasticsearch. Por defecto es 9200

Los demás valores son opcionales, podemos cambiarlos más adelante.

Ahora, si todo se ha hecho correctamente, Composer 2 empezará a instalar Magento 2. El proceso durará unos 10 minutos.

Ten paciencia, ya que puede llevar algún tiempo instalar todas las instancias y módulos necesarios para configurar Magento 2.4.5.

Tras la instalación, obtendrás estos resultados.

Ejecuta los comandos

Ahora, tienes que ejecutar los siguientes comandos.

php bin/magento indexer:reindex

php bin/magento setup:upgrade

php bin/magento setup:static-content:deploy -f

php bin/magento cache:flush

Ahora pulsa la URL (normalmente localhost/magento2/pub/) o la URL base que estableciste anteriormente para la in base-url durante la instalación.

Para Admin: Accede a la url con http://localhost/magento2/pub/admin.

¡Enhorabuena!

Ya has instalado correctamente Magento 2.4.5-p1 en tu host local. Puedes empezar a hacer las personalizaciones que prefieras y lanzar una tienda de comercio electrónico totalmente funcional en la máquina local.

Problemas comunes con las versiones de Magento 2

Existe la posibilidad de que te encuentres con algún problema durante el proceso de instalación de Magento 2.4.1 o versiones inferiores. Aquí tienes algunos de los más comunes, junto con una solución.

1. Página gris en blanco – Panel de administración de Magento

Sólo tienes que ir a la ruta del directorio …\vendor\magento\framework\View\Element\Template\File\Validator.php

En la función isPathInDirectories, añade una línea.

$realPath = str_replace('', '/', $this->fileDriver->getRealPath($path));

Consulta en la siguiente imagen el punto en el que debes insertar la línea:

2. Si recibes un error de autenticación

Si no has podido iniciar sesión en el panel de administración de Magento y te encuentras con un error de autenticación, simplemente ejecuta el siguiente comando en el Compositor:

php bin/magento module:disable Magento_TwoFactorAuth

Resumen

Así es como puedes instalar Magento 2.4.5-p1 en el host local utilizando el Compositor. Una vez que estés listo para poner en marcha tu tienda, no tienes que preocuparte por el rendimiento porque el Alojamiento Gestionado Magento de Cloudways está aquí para aumentar tus ventas y eliminar las molestias de gestión del servidor. Si te enfrentas a algún problema como un Error Interno de Servidor 500 después de aplicar los pasos anteriores, consulta aquí para solucionar el error.

Sólo tienes que centrarte en crear una tienda Magento 2 impresionante, y Cloudways se encargará del resto. Y si tienes algún problema al instalar Magento 2, puedes preguntarme a través de la sección de comentarios.