Configuración inicial de Magento: lo que necesitas saber

Requisitos previos para la instalación de Magento

Antes de comenzar con la instalación de Magento, es crucial preparar todo el entorno y asegurarse de cumplir con los requisitos necesarios.

¿Qué necesitas antes de empezar?

Requisitos del servidor: Apache/NGINX, PHP y MySQL/MariaDB

Para instalar Magento, tu servidor debe cumplir ciertos requisitos. Necesitas:

• Servidor Web: Apache 2.2 o 2.4, o NGINX 1.8.
• PHP: Versión 7.4 o 8.1. Asegúrate de que las extensiones PHP necesarias estén habilitadas, como intl, soap, sockets, sodium, xsl, y gd.
• Base de datos: MySQL 5.6, 5.7 o MariaDB.

Estos componentes son esenciales para que Magento funcione correctamente. Verifica que tu servidor tenga estas versiones instaladas.

Configuración de Elasticsearch para Magento

Magento requiere Elasticsearch para el motor de búsqueda. Debes:

1. Descargar Elasticsearch: Puedes obtener la versión compatible desde el sitio web oficial de Elasticsearch.
2. Instalar Elasticsearch: Sigue las instrucciones del archivo README para instalarlo.
3. Configurar Elasticsearch: Asegúrate de que Elasticsearch esté corriendo en el puerto predeterminado (9200) o ajusta la configuración de Magento para que apunte al puerto correcto.

Elasticsearch ayuda a mejorar la velocidad y precisión de las búsquedas en tu tienda Magento.

Instalación de Composer

Composer es una herramienta necesaria para gestionar dependencias en Magento. Para instalar Composer:

1. Descargar Composer: Ve al sitio oficial de Composer y descarga el instalador.
2. Ejecutar el instalador: Sigue las instrucciones proporcionadas para completar la instalación.
3. Configurar Composer: Añade Composer al PATH de tu sistema para poder usarlo desde cualquier directorio.

Composer te permitirá descargar y gestionar todos los módulos necesarios para Magento.

Preparación del entorno local con XAMPP

Para preparar tu entorno local, necesitas instalar XAMPP:

1. Descargar XAMPP: Ve a Apache Friends y descarga la versión de XAMPP que incluya PHP 7.4 o 8.1.
2. Instalar XAMPP: Ejecuta el archivo descargado y sigue las instrucciones del asistente de instalación. Selecciona componentes como Apache y MySQL.
3. Configurar PHP: En el Panel de Control de XAMPP, edita el archivo php.ini y asegúrate de que las extensiones necesarias estén habilitadas. Ajusta memory_limit a 4G.
4. Editar archivo hosts: Añade la línea 127.0.0.1 www.localhost.com en C:\Windows\System32\drivers\etc\hosts para configurar el acceso local.

Con XAMPP, puedes simular un servidor web en tu máquina local, permitiéndote probar y desarrollar tu tienda Magento antes de lanzarla en un servidor en vivo.

Cómo instalar y configurar XAMPP para Magento

Paso a paso para configurar tu servidor local

Configurar XAMPP para Magento no es complicado si sigues estos pasos.

Descarga e instalación de XAMPP

1. Descargar XAMPP:

• Visita el sitio web de Apache Friends.
• Descarga la versión de XAMPP compatible con PHP 7.4 o 8.1.

1. Instalar XAMPP:

• Ejecuta el archivo descargado.
• Sigue las instrucciones del asistente de instalación.
• Selecciona los componentes necesarios: Apache y MySQL son imprescindibles.
• Elige la carpeta de instalación (por defecto es C:\xampp).

Después de completar estos pasos, XAMPP estará instalado en tu sistema.

Configuración de PHP en XAMPP

1. Abrir el Panel de Control de XAMPP:

• Busca XAMPP Control Panel en tu sistema operativo y ábrelo.

1. Editar el archivo php.ini:

• En el Panel de Control de XAMPP, haz clic en el botón Config en la fila de Apache.
• Selecciona PHP (php.ini) del menú.

1. Habilitar extensiones necesarias:

• Busca las líneas que contienen las extensiones requeridas y quita el punto y coma (;) al inicio de cada línea:
  • extension=intl
  • extension=soap
  • extension=sockets
  • extension=sodium
  • extension=xsl
  • extension=gd
• Cambia memory_limit a 4G para asegurar que Magento funcione sin problemas.

1. Guardar y cerrar:

• Guarda los cambios y cierra el archivo php.ini.

Edición del archivo de hosts en Windows

1. Acceder al archivo de hosts:

• Abre el explorador de archivos y navega a C:\Windows\System32\drivers\etc\.
• Busca el archivo hosts y ábrelo con un editor de texto (como Notepad).

1. Añadir la entrada para localhost:

• Al final del archivo, añade la línea: 127.0.0.1 www.localhost.com.

1. Guardar los cambios:

• Guarda y cierra el archivo.

Esta configuración permite que tu navegador reconozca www.localhost.com como una dirección válida para tu entorno local.

Inicio de servicios Apache y MySQL

1. Iniciar Apache y MySQL:

• Vuelve al Panel de Control de XAMPP.
• Haz clic en Start en las filas de Apache y MySQL.

1. Verificar que los servicios están corriendo:

• Asegúrate de que ambos servicios muestren el estado Running.
• Accede a http://localhost en tu navegador para confirmar que Apache está funcionando correctamente.

Con estos pasos, tu servidor local con XAMPP estará listo para la instalación de Magento.

Creación de la base de datos en phpMyAdmin

Acceso a phpMyAdmin y creación de la base de datos

1. Acceso a phpMyAdmin:

• Abre tu navegador.
• Accede a http://localhost/phpmyadmin para abrir la interfaz de phpMyAdmin.

1. Crear la base de datos:

• En la página principal de phpMyAdmin, ve a la pestaña Bases de datos.
• En el campo Crear base de datos, escribe un nombre para tu base de datos, por ejemplo, magento2.
• Haz clic en Crear.

Configuración de permisos y usuarios para la base de datos

1. Crear un nuevo usuario:

• En la pestaña Usuarios, haz clic en Añadir usuario.
• Ingresa un Nombre de usuario y una Contraseña. Por ejemplo, magento_user y password123.

1. Asignar privilegios:

• En la sección Privilegios globales, selecciona Marcar todos. Esto dará a tu usuario permisos completos sobre la base de datos.
• Haz clic en Continuar para guardar el nuevo usuario y sus privilegios.

1. Asignar la base de datos al usuario:

• Vuelve a la pestaña Bases de datos.
• Busca tu base de datos creada (magento2).
• Selecciona Privilegios y asigna el nuevo usuario (magento_user) a esta base de datos.

Verificación de la creación exitosa de la base de datos

1. Comprobar la base de datos:

• En el menú de la izquierda, busca y selecciona magento2.
• Asegúrate de que la base de datos aparece en la lista y está vacía. Esto confirma que la base de datos se creó correctamente.

Preparación para la instalación de Magento en la base de datos

1. Reunir información necesaria:

• Anota los detalles de conexión de la base de datos:
  • Nombre de la base de datos: magento2
  • Nombre de usuario: magento_user
  • Contraseña: password123
  • Host de la base de datos: localhost

1. Verificar configuración de MySQL:

• Asegúrate de que el servicio MySQL está corriendo en el Panel de Control de XAMPP.
• Confirma que phpMyAdmin puede acceder y gestionar la base de datos sin problemas.

Estos pasos aseguran que tu base de datos esté lista para la instalación de Magento.

Instalación de Magento usando Composer

¿Cómo descargar Magento?

Comandos para descargar Magento con Composer

1. Abrir la terminal:

• En Windows, abre el Símbolo del sistema o PowerShell.
• En Mac o Linux, abre la Terminal.

1. Navegar al directorio de instalación:

• Usa el comando cd para moverte al directorio donde deseas instalar Magento. Por ejemplo:
  bash cd C:\xampp\htdocs

1. Ejecutar el comando Composer:

• Introduce el siguiente comando para descargar Magento:
  bash composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition magento2
• Reemplaza magento2 con el nombre del directorio donde quieres instalar Magento.

Creación de claves de autenticación en el Marketplace de Magento

1. Acceso al Marketplace de Magento:

• Ve a https://marketplace.magento.com/ y haz login con tu cuenta.

1. Generación de claves:

• Haz clic en tu nombre de usuario en la parte superior derecha y selecciona My Profile.
• Navega a la pestaña Access Keys y selecciona Create a New Access Key.
• Asigna un nombre a las claves, por ejemplo, MagentoSetup, y haz clic en OK.
• Copia el Public Key y el Private Key, los necesitarás para la instalación.

Configuración de acceso y descarga de módulos necesarios

1. Introducción de las claves en Composer:

• Cuando Composer te pida las claves de autenticación, introduce el Public Key como el nombre de usuario y el Private Key como la contraseña.
• Composer usará estas claves para descargar los módulos necesarios desde el repositorio de Magento.

1. Descarga de módulos adicionales:

• Si necesitas módulos adicionales, puedes agregarlos al archivo composer.json ubicado en el directorio raíz de tu instalación de Magento.
• Usa el comando:
  bash composer require vendor/module-name
• Reemplaza vendor/module-name con el nombre del módulo que deseas instalar.

Verificación de la instalación de Magento

1. Verificación de archivos descargados:

• Una vez completada la instalación, verifica que todos los archivos de Magento estén en el directorio especificado.
• Asegúrate de que las carpetas app, bin, lib, y vendor estén presentes.

1. Comprobación de la configuración:

• Ejecuta el siguiente comando para verificar que la instalación se realizó correctamente:
  bash php bin/magento setup:install --base-url=http://localhost/magento2 --db-host=localhost --db-name=magento2 --db-user=magento_user --db-password=password123 --admin-firstname=Admin --admin-lastname=User --admin-email=admin@example.com --admin-user=admin --admin-password=admin123 --language=en_US --currency=USD --timezone=America/Mexico_City --use-rewrites=1
• Reemplaza los valores con los detalles de tu instalación.

1. Acceso a la interfaz de administración:

• Abre tu navegador y accede a http://localhost/magento2/admin para iniciar sesión con las credenciales de administrador que configuraste.

Estos pasos aseguran una instalación exitosa de Magento usando Composer, preparándote para la configuración inicial magento.

Configuración inicial de Magento después de la instalación

¿Cómo configurar Magento después de la instalación?

Ejecución de comandos de configuración en la línea de comandos

1. Actualizar la base de datos:

• Ejecuta el comando:
  bash php bin/magento setup:upgrade
• Este comando actualiza el esquema de la base de datos y los datos de la aplicación.

1. Reindexar el índice:

• Reindexar asegura que los datos en tu tienda estén actualizados:
  bash php bin/magento indexer:reindex

1. Desplegar contenido estático:

• Despliega archivos estáticos necesarios para la interfaz:
  bash php bin/magento setup:static-content:deploy -f

1. Limpiar caché:

• Limpia la caché para que los cambios surtan efecto:
  bash php bin/magento cache:flush

Configuración del URL base y detalles del administrador

1. Acceder al panel de administración:

• Abre tu navegador y ve a http://localhost/magento2/admin.
• Ingresa tus credenciales de administrador.

1. Configurar el URL base:

• Navega a Stores > Configuration > Web.
• En la sección Base URLs, introduce el URL de tu tienda, por ejemplo, http://localhost/magento2/.
• Haz clic en Save Config para guardar los cambios.

1. Detalles del administrador:

• Ve a System > All Users.
• Selecciona tu usuario administrador y actualiza los detalles como nombre, correo electrónico y contraseña si es necesario.
• Guarda los cambios haciendo clic en Save User.

Personalización de configuraciones de idioma, moneda y zona horaria

1. Idioma:

• Ve a Stores > Configuration > General > Locale Options.
• Selecciona el idioma deseado desde el menú desplegable Locale.
• Guardar los cambios con Save Config.

1. Moneda:

• Ve a Stores > Configuration > General > Currency Setup.
• Configura Base Currency, Default Display Currency y Allowed Currencies según tus necesidades.
• No olvides hacer clic en Save Config para aplicar los cambios.

1. Zona horaria:

• En Stores > Configuration > General > Locale Options, selecciona tu Time Zone.
• Guarda los cambios con Save Config.

Solución de problemas comunes durante la configuración inicial

1. Error de permisos:

• Si encuentras problemas de permisos, asegúrate de que las carpetas y archivos tengan los permisos correctos:
  bash find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} + find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} + chmod u+x bin/magento

1. Problemas con la caché:

• Si los cambios no se reflejan, limpia la caché desde el panel de administración o usando el comando:
  bash php bin/magento cache:clean

1. Errores de configuración de PHP:

• Asegúrate de que las extensiones PHP necesarias estén habilitadas en tu archivo php.ini y reinicia Apache:
  bash ;extension=intl ;extension=soap ;extension=sockets ;extension=sodium ;extension=xsl ;extension=gd

1. Problemas de conexión con la base de datos:

• Verifica que los detalles de la base de datos en el archivo app/etc/env.php sean correctos y que el servidor MySQL esté ejecutándose.

Estos pasos te guiarán a través de la configuración inicial Magento, asegurando que tu tienda esté lista para personalizaciones y ajustes adicionales.