Documentación Commerce Guía de instalación

Instalación local de inicio rápido

Last update: Wed Nov 15 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Install

Creado para:

Experienced
Admin
Developer

Las instrucciones de esta página describen cómo instalar Adobe Commerce y Magento Open Source en autoalojado infraestructura. Para obtener instrucciones sobre cómo actualizar una instalación existente, consulte la Guía de actualización.

El Adobe utiliza Compositor para administrar los componentes de Adobe Commerce y Magento Open Source y sus dependencias. Usar Composer para obtener el metapaquete de Adobe Commerce y Magento Open Source ofrece las siguientes ventajas:

Reutilice bibliotecas de terceros sin agruparlas con el código fuente
Reduzca los conflictos de extensiones y los problemas de compatibilidad utilizando una arquitectura basada en componentes con una sólida administración de dependencias
Adherirse a Grupo de Interoperabilidad PHP-Framework (FIG) normas
Volver a empaquetar el Magento Open Source con otros componentes
Uso del software Adobe Commerce o de Magento Open Source en un entorno de producción

NOTE

Los desarrolladores que colaboren con Magento Open Source deben utilizar basado en Git método de instalación.

Requisitos previos

Antes de continuar, debe hacer lo siguiente:

Completar todo tareas previas.
Instalar Compositor.
Obtener claves de autenticación al repositorio de Adobe Commerce y Compositor de Magento Open Source.

Iniciar sesión como propietario del sistema de archivos

Obtenga información acerca de la propiedad, los permisos y el propietario del sistema de archivos en la Tema de información general sobre propiedad y permisos.

Para cambiar al propietario del sistema de archivos:

Inicie sesión en el servidor de aplicaciones como un usuario con permisos para escribir en el sistema de archivos o cambie a.

Si utiliza el shell de bash, puede utilizar la siguiente sintaxis para cambiar al propietario del sistema de archivos e introducir el comando al mismo tiempo:

code language-bash
`su <file system owner> -s /bin/bash -c <command>`

Si el propietario del sistema de archivos no permite inicios de sesión, puede hacer lo siguiente:

code language-bash
`sudo -u <file system owner> <command>`

Para ejecutar comandos CLI desde cualquier directorio, agregue <app_root>/bin a su sistema PATH.

Dado que los shells tienen sintaxis diferente, consulte una referencia como unix.stackexchange.com.

Ejemplo de shell de bash para CentOS:

code language-bash
`export PATH=$PATH:/var/www/html/magento2/bin`

Opcionalmente, puede ejecutar los comandos de las siguientes maneras:

cd <app_root>/bin y ejecútelas como ./magento <command name>
app_root>/bin/magento <command name>
<app_root> es un subdirectorio del servidor web docroot

Obtenga el metapaquete

Para obtener el metapaquete de Adobe Commerce o Magento Open Source:

Inicie sesión en el servidor de aplicaciones como, o cambie a, propietario del sistema de archivos.
Cambie al directorio docroot del servidor web o a un directorio que haya configurado como docroot del host virtual.

Cree un proyecto de Composer utilizando el metapaquete de Adobe Commerce o Magento Open Source.

Magento Open Source

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

Adobe Commerce

code language-bash
`composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>`

Cuando se le solicite, introduzca sus claves de autenticación. Las claves pública y privada se crean y configuran en su Commerce Marketplace.

note note
NOTE
Al usar un Compositor `auth.json` archivo o variable de entorno, no se le pedirá que introduzca sus claves de autenticación.

Si se producen errores, como Could not find package... o ...no matching package found, asegúrese de que no haya errores tipográficos en el comando. Si sigue encontrando errores, es posible que no tenga autorización para descargar Adobe Commerce. Contacto Asistencia de Adobe Commerce para obtener ayuda.

Consulte Solución de problemas para obtener ayuda con más errores.

Ejemplo: versión menor

Las versiones menores contienen nuevas funciones, correcciones de calidad y correcciones de seguridad. Use Compositor para especificar una versión secundaria. Por ejemplo, para especificar el metapaquete de Adobe Commerce 2.4.6:

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

Ejemplo: parche de calidad

Los parches de calidad contienen principalmente parches funcionales y correcciones de seguridad. Sin embargo, a veces también pueden contener nuevas funciones compatibles con versiones anteriores. Use Composer para descargar un parche de calidad. Por ejemplo, para especificar el metapaquete de Adobe Commerce 2.4.6:

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

Ejemplo: parche de seguridad

Los parches de seguridad solo contienen correcciones de seguridad. Están diseñadas para que el proceso de actualización sea más rápido y sencillo.

Los parches de seguridad utilizan la convención de nombres del Compositor 2.4.6-px. Use el Compositor para especificar un parche. Por ejemplo, para descargar el metapaquete Adobe Commerce 2.4.6-p1:

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

Definición de permisos de archivo

Debe establecer permisos de lectura y escritura para el grupo de servidores web antes de instalar Adobe Commerce o Magento Open Source. Esto es necesario para que la línea de comandos pueda escribir archivos en el sistema de archivos.

cd /var/www/html/<magento install directory>
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

Instalación de la aplicación

Debe utilizar la línea de comandos para instalar Adobe Commerce o Magento Open Source.

En este ejemplo se supone que el nombre del directorio de instalación es magento2ee, el db-host está en el mismo equipo (localhost), y que la variable db-name, db-user, y db-password son todos magento:

bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15

TIP

Puede personalizar el URI de administrador con la variable --backend-frontname opción. Sin embargo, Adobe recomienda omitir esta opción y permitir que el comando de instalación genere automáticamente un URI aleatorio. Un URI aleatorio es más difícil de explotar para los piratas informáticos o para el software malintencionado. El URI se muestra en la consola cuando se completa la instalación.

TIP

Para obtener una descripción completa de las opciones de instalación de CLI, consulte Instale la aplicación desde la línea de comandos.

Resumen de comandos

Para mostrar una lista completa de comandos, escriba:

bin/magento list

Para obtener ayuda acerca de un comando concreto, escriba:

bin/magento help <command>

Por ejemplo:

bin/magento help setup:install

bin/magento help cache:enable

En la tabla siguiente se resumen los comandos disponibles. Los comandos sólo se muestran en forma de resumen. Para obtener más información acerca de un comando, haga clic en el vínculo en la columna Comando.

Comando

Descripción

Requisitos previos

magento setup:install

Instala la aplicación

Ninguno

magento setup:uninstall

Quita la aplicación.

Aplicación instalada

magento setup:upgrade

Actualiza la aplicación.

Configuración de implementación

magento maintenance:{enable/disable}

Activa o desactiva el modo de mantenimiento (en este modo, solo las direcciones IP exentas pueden acceder al administrador o a la tienda).

Aplicación instalada

magento setup:config:set

Crea o actualiza la configuración de implementación.

Ninguno

magento module:{enable/disable}

Habilitar o deshabilitar módulos.

Ninguno

magento setup:store-config:set

Establece opciones relacionadas con la tienda, como la dirección URL base, el idioma y la zona horaria.

Configuración de implementación

magento setup:db-schema:upgrade

Actualiza el esquema de la base de datos.

Configuración de implementación

magento setup:db-data:upgrade

Actualiza los datos de la base de datos.

Configuración de implementación

magento setup:db:status

Comprueba si la base de datos está actualizada con el código.

Configuración de implementación

magento admin:user:create

Crea un usuario administrador.

Puede crear usuarios para lo siguiente:

Configuración de implementación

Habilite como mínimo la Magento_User y Magento_Authorization módulos

Base de datos (la forma más sencilla es usar bin/magento setup:upgrade)

magento list

Muestra todos los comandos disponibles.

Ninguno

magento help

Proporciona ayuda para el comando especificado.

Ninguno

Argumentos comunes

Los siguientes argumentos son comunes a todos los comandos. Estos comandos se pueden ejecutar antes o después de instalar la aplicación:

Versión larga

Versión corta

Significado

--help

-h

Obtener ayuda para cualquier comando. Por ejemplo, ./magento help setup:install o ./magento help setup:config:set.

--quiet

-q

Modo silencioso; sin salida.

--no-interaction

-n

No hay preguntas interactivas.

--verbose=1,2,3

-v, -vv, -vvv

Nivel de detalle. Por ejemplo, --verbose=3 o -vvv muestra el nivel de detalle de la depuración, que es el resultado más detallado. El valor predeterminado es --verbose=1 o -v.

--version

-V

Mostrar esta versión de la aplicación

--ansi

n/a

Forzar salida ANSI

--no-ansi

n/a

Deshabilitar salida ANSI

NOTE

¡Felicidades! Ha completado la instalación rápida. ¿Necesita ayuda más avanzada? Consulte la Instalación avanzada guía.

recommendation-more-help

0f8e7db5-0e9c-4002-a5b8-a0088077d995