Cómo instalar Magento Open Source en tu servidor

Magento Open Source es una de las plataformas de comercio electrónico más populares y potentes. Sin embargo, su instalación requiere cumplir con ciertos requisitos técnicos. En esta guía, aprenderás cómo preparar tu servidor y sistema para instalar Magento de manera exitosa.

Requisitos para instalar Magento Open Source

Requisitos del servidor y del sistema operativo necesarios

Para instalar Magento Open Source, tu servidor debe cumplir con ciertos requisitos:

Sistema operativo: Aunque Magento puede instalarse en varios sistemas operativos, Linux (preferiblemente CentOS o Ubuntu) es el más recomendado.
RAM: Al menos 2GB de RAM; 4GB es ideal para entornos de producción.
Espacio en disco: Necesitas al menos 2GB de espacio libre para Magento y sus dependencias.
Servidor web: Puedes usar Apache 2.4 o Nginx 1.x. Estos servidores son compatibles y ofrecen buen rendimiento.

Dependencias de software y versiones recomendadas

Magento depende de varios componentes de software. Asegúrate de tener las versiones correctas instaladas:

PHP: Magento requiere PHP 7.4 o superior. Asegúrate de que las siguientes extensiones de PHP estén habilitadas:
ext-gd
ext-mbstring
ext-intl
ext-iconv
Base de datos: MySQL 5.7 o MariaDB 10.4 son compatibles. Asegúrate de configurar adecuadamente las bases de datos para evitar problemas de rendimiento.
Composer: Necesitas Composer para gestionar las dependencias de Magento. Instala Composer siguiendo las instrucciones de su sitio oficial.

Necesidad de contar con claves de autenticación de Magento Composer

Para descargar Magento desde el repositorio oficial, necesitas claves de autenticación. Estas claves se obtienen desde el Magento Marketplace:

Crear una cuenta: Regístrate en el Magento Marketplace.
Obtener claves: En tu cuenta, navega a “Access Keys” y genera una nueva clave pública y privada.
Guardar claves: Guarda estas claves en un lugar seguro ya que las necesitarás para configurar Composer.

Importancia de cumplir con los requisitos antes de la instalación

Cumplir con todos los requisitos antes de iniciar la instalación es crucial. Si no tienes el entorno adecuado:

Errores de instalación: Podrías encontrar errores durante la instalación que son difíciles de solucionar.
Problemas de rendimiento: Un servidor mal configurado puede llevar a un rendimiento subóptimo.
Seguridad: Un entorno que no cumple con los requisitos puede ser vulnerable a ataques.

Asegúrate de verificar cada requisito y configurarlo correctamente antes de proceder con la instalación de Magento Open Source.

Cómo instalar Composer para gestionar dependencias

¿Qué es Composer y por qué es esencial?

Composer es un gestor de dependencias para PHP que facilita la instalación y actualización de librerías necesarias para proyectos de desarrollo. En el contexto de Magento, Composer es crucial porque:

Organiza paquetes: Gestiona todas las librerías y dependencias que Magento necesita.
Facilita actualizaciones: Permite actualizar Magento y sus extensiones de manera sencilla.
Optimiza recursos: Descarga solo las librerías necesarias, lo que reduce el tamaño del proyecto y mejora el rendimiento.

Beneficios de usar Composer para la gestión de dependencias

Estandarización: Composer sigue las normas del PHP Framework Interoperability Group (PHP-FIG), asegurando que las librerías sean compatibles y estén bien integradas.
Automatización: Automatiza la instalación y actualización de paquetes, ahorrando tiempo y reduciendo errores manuales.
Manejo de versiones: Permite especificar versiones exactas de paquetes, evitando conflictos entre librerías.

Instalación de Composer

Pasos para instalar Composer desde la línea de comandos

Descargar el instalador:

   curl -sS https://getcomposer.org/installer | php

Este comando descarga el archivo composer.phar.

Mover el archivo:

   sudo mv composer.phar /usr/local/bin/composer

Esto coloca Composer en una ubicación accesible globalmente.

Verificar la instalación:

   composer --version

Si Composer se instaló correctamente, verás la versión instalada en la terminal.

Alternativa: descarga del archivo de instalación desde el sitio oficial de Composer

Visitar el sitio oficial: Ve a getcomposer.org y descarga el archivo de instalación para tu sistema operativo.
Mover el archivo: Después de la descarga, mueve el archivo a una ubicación dentro de tu $PATH (por ejemplo, /usr/local/bin/ en macOS o Linux).
Renombrar el archivo:

   mv composer.phar composer

Verificar la instalación:

   composer --version

Verificación de la instalación de Composer

Después de seguir cualquiera de los métodos anteriores, asegúrate de que Composer esté instalado correctamente:

Comando de verificación:

  composer --version

Esto debe mostrar la versión actual de Composer.

Prueba de instalación: Ejecuta un comando sencillo como composer list para listar los comandos disponibles y verificar que Composer funciona correctamente.

Instalar Composer es un paso esencial antes de proceder con la instalación de Magento, ya que gestiona todas las dependencias necesarias de manera eficiente.

Pasos para instalar Magento Open Source usando Composer

Paso 1: Descargar Magento con Composer

Para instalar Magento Open Source usando Composer, primero necesitas descargar Magento desde el repositorio oficial. Aquí te explicamos cómo hacerlo:

Obtener claves de autenticación:

Ve a Magento Marketplace.
Inicia sesión y navega a “Mi cuenta” > “Mis claves”.
Genera un par de claves: Clave pública (username) y Clave privada (password).

Configurar Composer con las claves de autenticación:

Añade las claves a Composer ejecutando:
bash composer config --global http-basic.repo.magento.com <public_key> <private_key>

Descargar Magento:

Navega al directorio donde deseas instalar Magento.
Usa el siguiente comando para descargar Magento:
bash composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <nombre-del-directorio>
Durante la ejecución, Composer pedirá las claves de autenticación. Ingresa la clave pública y la clave privada generadas en el paso 1.

Paso 2: Configurar permisos y preparar el directorio de instalación

Una correcta configuración de permisos es vital para una instalación exitosa de Magento. Aquí te mostramos cómo hacerlo:

Importancia de los permisos adecuados:

Seguridad: Los permisos adecuados protegen los archivos críticos del sistema.
Operatividad: Aseguran que Magento pueda leer y escribir archivos según sea necesario durante la instalación y operación.

Establecer permisos en archivos y directorios críticos:

Permisos para archivos:
bash find . -type f -exec chmod 644 {} \;
Permisos para directorios:
bash find . -type d -exec chmod 755 {} \;
Permisos especiales para directorios de Magento:
bash chmod -R 777 var pub/static pub/media chmod 777 app/etc chmod 644 app/etc/*.xml chmod u+x bin/magento

Verificación:

Asegúrate de que los permisos se hayan aplicado correctamente revisando los archivos y directorios críticos:
bash ls -l var pub/static pub/media app/etc bin/magento

Al seguir estos pasos, te aseguras de que Magento esté listo para instalarse en tu servidor, con todos los permisos y configuraciones necesarias.

Creación y configuración de la base de datos para Magento

Proceso para crear una base de datos MySQL/MariaDB vacía

Para instalar Magento, necesitas una base de datos MySQL o MariaDB vacía. Esto servirá como el lugar donde Magento almacenará toda su información, desde productos hasta configuraciones de usuario.

Comandos necesarios para crear y configurar la base de datos

Accede a MySQL o MariaDB:

Abre tu terminal y conéctate al servidor de base de datos:
bash mysql -u root -p
Ingresa la contraseña de tu usuario root.

Crear una base de datos vacía:

Una vez dentro del entorno de MySQL o MariaDB, ejecuta el siguiente comando para crear una nueva base de datos:
sql CREATE DATABASE magento_db;
Nota: Cambia magento_db por el nombre que prefieras para tu base de datos.

Crear un usuario y otorgar permisos:

Crea un nuevo usuario especificando un nombre de usuario y una contraseña:
sql CREATE USER 'magento_user'@'localhost' IDENTIFIED BY 'tu_contraseña_segura';
Otorga todos los permisos necesarios al usuario sobre la base de datos que acabas de crear:
sql GRANT ALL PRIVILEGES ON magento_db.* TO 'magento_user'@'localhost';
Aplica los cambios:
sql FLUSH PRIVILEGES;

Parámetros esenciales que deben incluirse en la configuración de la base de datos

Cuando configures Magento, necesitarás proporcionar ciertos parámetros esenciales para que pueda conectarse y utilizar la base de datos correctamente. Estos son los parámetros que debes tener a mano:

Nombre de la base de datos: magento_db (o el nombre que elegiste).
Nombre de usuario: magento_user.
Contraseña del usuario: tu_contraseña_segura.
Host de la base de datos: localhost (o la IP del servidor de base de datos si está en una máquina diferente).
Prefijo de tabla (opcional): Un prefijo para las tablas de la base de datos, útil si compartes la base de datos con otras aplicaciones.

Ejemplo de configuración:

php bin/magento setup:install \
    --base-url=http://tu-dominio.com/ \
    --db-host=localhost \
    --db-name=magento_db \
    --db-user=magento_user \
    --db-password=tu_contraseña_segura \
    --backend-frontname=admin \
    --admin-firstname=Admin \
    --admin-lastname=User \
    --admin-email=admin@tu-dominio.com \
    --admin-user=admin \
    --admin-password=admin123 \
    --language=es_ES \
    --currency=USD \
    --timezone=America/Mexico_City \
    --use-rewrites=1

Con estos pasos y parámetros, tu base de datos estará lista para soportar la instalación de Magento, asegurando un entorno robusto y bien configurado.

Ejecutar el script de instalación de Magento

Paso 1: Iniciar el script de instalación

Para iniciar la instalación de Magento, debes ejecutar un comando desde la línea de comandos. Este comando configura Magento utilizando los parámetros que proporcionas.

Ejecuta el comando de instalación:
- Navega al directorio raíz de tu instalación de Magento.
- Ejecuta el siguiente comando:
php bin/magento setup:install \ --base-url=http://tu-dominio.com/ \ --db-host=localhost \ --db-name=magento_db \ --db-user=magento_user \ --db-password=tu_contraseña_segura \ --backend-frontname=admin \ --admin-firstname=Admin \ --admin-lastname=User \ --admin-email=admin@tu-dominio.com \ --admin-user=admin \ --admin-password=admin123 \ --language=es_ES \ --currency=USD \ --timezone=America/Mexico_City \ --use-rewrites=1
Parámetros y opciones esenciales:
- –base-url: La URL donde estará tu tienda Magento.
- –db-host: El servidor de la base de datos (generalmente localhost).
- –db-name: El nombre de la base de datos que creaste.
- –db-user: El nombre del usuario con acceso a la base de datos.
- –db-password: La contraseña del usuario de la base de datos.
- –backend-frontname: La ruta de acceso para el backend de Magento (por ejemplo, admin).
- –admin-firstname y –admin-lastname: Nombre y apellido del administrador.
- –admin-email: El correo electrónico del administrador.
- –admin-user y –admin-password: Credenciales de acceso para el administrador.
- –language: Idioma predeterminado (por ejemplo, es_ES para español).
- –currency: Moneda predeterminada (por ejemplo, USD).
- –timezone: Zona horaria de tu tienda (por ejemplo, America/Mexico_City).
- –use-rewrites: Habilitar reescrituras URL para URLs amigables.

Paso 2: Verificación y configuración post-instalación

Una vez que el script de instalación haya terminado, es crucial verificar que todo esté funcionando correctamente y realizar configuraciones adicionales si es necesario.

Verificar la instalación:
- Comprobación del backend: Accede a la URL del backend que especificaste (http://tu-dominio.com/admin). Inicia sesión con las credenciales de administrador que configuraste.
- Comprobación del frontend: Visita la URL base de tu tienda (http://tu-dominio.com/). Verifica que la página de inicio se cargue correctamente.
Configuraciones adicionales:
- Permisos de archivos y directorios:
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 {} + \ chown -R :www-data . # Ubuntu \ chmod u+x bin/magento
- Activar modo de desarrollador (opcional, útil para pruebas y desarrollo):
php bin/magento deploy:mode:set developer
- Desactivar caché (para facilitar el desarrollo y pruebas):
php bin/magento cache:disable
Comprobación del estado del sistema:
- Leeriness Check: Asegúrate de que todos los componentes y configuraciones estén correctos:
php bin/magento setup:check:readiness
Actualizar índices y caché:
- Índices:
  bash php bin/magento indexer:reindex
- Caché:
  bash php bin/magento cache:clean php bin/magento cache:flush

Con estos pasos, habrás ejecutado el script de instalación de Magento exitosamente y verificado que la instalación funciona correctamente.

Consejos para solucionar problemas comunes durante la instalación

Mensaje de “Fatal error: Allowed memory size exhausted” y cómo solucionarlo

Este error ocurre cuando PHP no tiene suficiente memoria asignada para completar una tarea. Para solucionarlo:

Aumentar el límite de memoria en php.ini:
- Abre el archivo php.ini. Puedes encontrarlo en el directorio de configuración de PHP.
- Busca la línea memory_limit y aumenta su valor, por ejemplo:
memory_limit = 2G
- Guarda los cambios y reinicia el servidor web.
Especificar el límite de memoria en la línea de comandos:
- Si no puedes editar php.ini, puedes hacerlo directamente desde la línea de comandos al ejecutar Composer:
  bash php -d memory_limit=-1 /usr/local/bin/composer install

Problemas con extensiones PHP faltantes y cómo instalarlas

Magento requiere varias extensiones PHP para funcionar correctamente. Si falta alguna, recibirás un mensaje de error específico. Aquí te mostramos cómo instalar algunas comunes:

Instalar la extensión intl:
- Ejecuta el siguiente comando:
sudo apt-get install php-intl
- Reinicia el servidor web para aplicar los cambios.
Instalar la extensión iconv:
- Usa el siguiente comando:
sudo apt-get install php-iconv
Instalar la extensión mbstring:
- Ejecuta:
sudo apt-get install php-mbstring
Verificar todas las extensiones necesarias:
- Lista todas las extensiones que Magento necesita y asegúrate de que estén instaladas. Puedes encontrar la lista completa en la documentación oficial de Magento.

Errores comunes con el archivo composer.phar y cómo resolverlos

Composer no encontrado:
- Si recibes un mensaje de que composer.phar no se encuentra, asegúrate de estar en el directorio correcto o de que Composer esté instalado globalmente.
- Verifica la instalación con:
composer --version
Permisos de archivo composer.phar:
- Si hay problemas de permisos, puedes ajustarlos con:
chmod +x composer.phar
Actualización de Composer:
- Mantén Composer actualizado para evitar errores:
  bash composer self-update

Otros problemas frecuentes y sus soluciones prácticas

Permisos de archivos y directorios:
- Asegúrate de que los permisos sean correctos para que Magento pueda escribir en los directorios necesarios:
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 {} + \ chown -R :www-data . # Ubuntu \ chmod u+x bin/magento
Cache y Reindexación:
- Si los cambios no se reflejan, limpia la caché y reindexa:
php bin/magento cache:clean php bin/magento cache:flush php bin/magento indexer:reindex
Configuración del archivo .htaccess:
- Si tienes problemas con las URLs amigables, revisa y ajusta el archivo .htaccess para asegurarte de que las reescrituras de URL estén habilitadas.
Comprobación de requisitos del sistema:
- Revisa que tu sistema cumpla con todos los requisitos mínimos de Magento, incluyendo versión de PHP, MySQL y otros componentes necesarios.

Con estos consejos, podrás solucionar problemas comunes que pueden surgir al instalar Magento, asegurando una instalación más fluida y eficiente.

Cómo mantener y actualizar tu instalación de Magento

Importancia de mantener Magento actualizado para seguridad y rendimiento

Mantener Magento actualizado es crucial para garantizar la seguridad y el rendimiento de tu tienda en línea. Las actualizaciones incluyen parches de seguridad que protegen contra vulnerabilidades conocidas y mejoras de rendimiento que optimizan la experiencia del usuario. Ignorar las actualizaciones puede dejar tu tienda expuesta a ataques y puede afectar negativamente la velocidad y funcionalidad del sitio.

Pasos para actualizar Magento usando Composer

Para actualizar Magento de manera efectiva, Composer es una herramienta esencial. Aquí te explico cómo hacerlo:

Preparar el entorno:
- Asegúrate de que tu entorno de desarrollo esté listo y que tengas acceso a la línea de comandos.
- Verifica que Composer esté instalado y actualizado:
composer --version composer self-update
Crear una copia de seguridad:
- Antes de cualquier actualización, realiza una copia de seguridad completa de tu base de datos y archivos.
Actualizar el archivo composer.json:
- Abre el archivo composer.json ubicado en el directorio raíz de tu instalación de Magento.
- Modifica la versión de Magento a la nueva versión deseada, por ejemplo:
"require": { "magento/product-community-edition": "2.4.6" }
Ejecutar la actualización con Composer:
- En la línea de comandos, navega al directorio raíz de Magento y ejecuta:
composer update
Aplicar actualizaciones de base de datos y caché:
- Después de actualizar los archivos, ejecuta los siguientes comandos para aplicar las actualizaciones de base de datos y limpiar la caché:
  bash php bin/magento setup:upgrade php bin/magento cache:clean php bin/magento cache:flush

Cómo manejar dependencias y conflictos durante las actualizaciones

Actualizar Magento puede traer conflictos de dependencias. Aquí algunos consejos para manejarlos:

Revisar dependencias:
- Antes de actualizar, revisa las dependencias en el archivo composer.json y asegúrate de que todas las versiones sean compatibles con la nueva versión de Magento.
Resolver conflictos:
- Si Composer detecta conflictos, revisa el mensaje de error y ajusta las versiones de las dependencias en composer.json.
- Usa el comando composer why-not para investigar por qué una dependencia específica no puede ser instalada:
composer why-not vendor/package
Actualizar extensiones personalizadas:
- Si usas extensiones personalizadas, verifica que sean compatibles con la nueva versión de Magento y actualízalas si es necesario.

Consejos para respaldar tu instalación antes de realizar actualizaciones

Antes de cualquier actualización, es vital realizar respaldos para evitar pérdidas de datos. Aquí algunos pasos recomendados:

Copia de seguridad de la base de datos:
- Ejecuta el siguiente comando para crear una copia de seguridad de tu base de datos:
mysqldump -u [usuario] -p [nombre_base_datos] > backup.sql
Copia de seguridad de archivos:
- Crea un archivo comprimido de todo el directorio raíz de tu instalación de Magento:
tar -czvf backup.tar.gz /ruta/a/tu/magento
Usar herramientas de respaldo:
- Considera usar herramientas de respaldo automatizadas que puedan programar y gestionar las copias de seguridad de manera eficiente.
Verificar las copias de seguridad:
- Asegúrate de que las copias de seguridad se hayan realizado correctamente y que puedas restaurarlas sin problemas en caso de necesitarlo.

Mantener y actualizar tu instalación de Magento es esencial para garantizar la seguridad y el rendimiento óptimo de tu tienda en línea. Siguiendo estos pasos, podrás manejar las actualizaciones de manera efectiva y sin contratiempos.

Expertos Magento Open Source, Adobe Commerce, WooCommerce