Documentación Commerce Guía de Commerce en la infraestructura en la nube

Propiedad web

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

Administrador
Desarrollador

La propiedad web define cómo se expone la aplicación a la web (en HTTP), determina cómo la aplicación web proporciona contenido y controla cómo el contenedor de la aplicación responde a las solicitudes entrantes estableciendo reglas en cada ubicación bloque. Un bloque representa una ruta absoluta que lleva a una barra diagonal (/).

web:
    locations:
        "/":
            # The public directory of the app, relative to its root.

Puede ajustar la configuración de locations con los siguientes valores clave para cada bloque locations:

Atributo

Descripción

allow

Proporcione archivos que no coincidan con las "reglas". Valor predeterminado = true

expires

Establezca el número de segundos para almacenar en caché el contenido en el explorador. Esta clave habilita los encabezados cache-control y expires para el contenido estático. Si no se establece este valor, la directiva expires y los encabezados resultantes no se incluyen al servir archivos de contenido estático. Un valor negativo 1 (-1) no genera almacenamiento en caché y es el valor predeterminado. Puede expresar el valor de tiempo con las siguientes unidades: ms (milisegundos), s (segundos), m (minutos), h (horas), d (días), w (semanas), M (meses, 30d) o y (años, 365d)

headers

Establezca encabezados personalizados, como X-Frame-Options, para el contenido estático servido desde esta ubicación.

index

Enumere los archivos estáticos para su aplicación, como el archivo index.html. Esta clave espera una colección. Esto solo funciona si la clave allow o rules de esta ubicación "permite" el acceso al archivo o archivos.

rules

Especificar invalidaciones para una ubicación. Utilice una expresión regular para que coincida con una solicitud. Si una solicitud entrante coincide con la regla, las claves utilizadas en ella anulan la gestión regular de la solicitud.

passthru

Configure la URL utilizada en caso de que no se encuentre un archivo estático o PHP. Normalmente, esta dirección URL es el controlador principal de las aplicaciones, como /index.php o /app.php.

root

Establezca la ruta relativa a la raíz de la aplicación que se expone en la web. El directorio público (ubicación "/") para un proyecto de Cloud está establecido en "pub" de forma predeterminada.

scripts

Permitir la carga de scripts en esta ubicación. Establezca el valor en true para permitir scripts.

La configuración predeterminada permite lo siguiente:

Desde la ruta de acceso raíz (/), solo se puede acceder a la web y a los medios
Se puede tener acceso a cualquier archivo desde las rutas de acceso ~/pub/static y ~/pub/media

El siguiente ejemplo muestra la configuración predeterminada en el archivo .magento.app.yaml para un conjunto de ubicaciones accesibles desde la web asociadas a una entrada en la propiedad mounts:

 # The configuration of app when it is exposed to the web.
web:
    locations:
        "/":
            # The public directory of the app, relative to its root.
            root: "pub"
            # The front-controller script to send non-static requests to.
            passthru: "/index.php"
            index:
                - index.php
            expires: -1
            scripts: true
            allow: false
            rules:
                \.(css|js|map|hbs|gif|jpe?g|png|tiff|wbmp|ico|jng|bmp|svgz|midi?|mp?ga|mp2|mp3|m4a|ra|weba|3gpp?|mp4|mpe?g|mpe|ogv|mov|webm|flv|mng|asx|asf|wmv|avi|ogx|swf|jar|ttf|eot|woff|otf|html?)$:
                    allow: true
                ^/sitemap(.*)\.xml$:
                    passthru: "/media/sitemap$1.xml"
        "/media":
            root: "pub/media"
            allow: true
            scripts: false
            expires: 1y
            passthru: "/get.php"
        "/static":
            root: "pub/static"
            allow: true
            scripts: false
            expires: 1y
            passthru: "/front-static.php"
            rules:
                ^/static/version\d+/(?<resource>.*)$:
                    passthru: "/static/$resource"

NOTE

Este ejemplo muestra la configuración web predeterminada de un proyecto en la nube configurado para admitir un solo dominio. Para un proyecto que requiere compatibilidad con varios sitios web o tiendas, la configuración de web debe estar configurada para admitir dominios compartidos. Consulte Configurar ubicaciones para dominios compartidos.

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26