Como usar a API Modules
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A API Modules oferece funções que retornam informações sobre o ambiente operacional
atual (módulo, versão e instância).
A API Modules também tem funções que recuperam o endereço de um módulo, uma versão ou uma instância. Isso permite que um aplicativo envie solicitações de uma instância para outra nos ambientes de desenvolvimento e de produção.
Adicione a seguinte instrução de uso à parte superior do seu arquivo:
Veja na seguinte amostra de código como saber o nome do módulo e o código da instância para uma solicitação:
O ID da instância de um módulo com escalonamento automático será retornado como um valor exclusivo
com codificação base64, por exemplo e4b565394caa.
É possível estabelecer comunicação entre os módulos no mesmo app, buscando o nome do host
do módulo de destino:
Também é possível usar o serviço Busca de URL.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-19 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[[["\u003cp\u003eThe Modules API provides information about the current operating environment, including module, version, and instance details.\u003c/p\u003e\n"],["\u003cp\u003eThis API allows applications to retrieve the address of a module, version, or instance, facilitating inter-instance communication within the development and production environments.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Modules API, you must include the \u003ccode\u003euse google\\appengine\\api\\modules\\ModulesService;\u003c/code\u003e statement at the top of your file.\u003c/p\u003e\n"],["\u003cp\u003eThe API can get the current module name and instance ID, and an automatically scaled module's instance ID will be a unique base64 encoded value.\u003c/p\u003e\n"],["\u003cp\u003eCommunication between modules within the same application can be achieved by fetching the hostname of the target module using the \u003ccode\u003eModulesService::getHostname()\u003c/code\u003e function.\u003c/p\u003e\n"]]],[],null,["# Using the Modules API\n\n| This API is supported for first-generation runtimes and can be used when [upgrading to corresponding second-generation runtimes](/appengine/docs/standard/\n| php-gen2\n|\n| /services/access). If you are updating to the App Engine PHP 7/8 runtime, refer to the [migration guide](/appengine/migration-center/standard/migrate-to-second-gen/php-differences) to learn about your migration options for legacy bundled services.\n\nThe Modules API provides functions that return information about the current\noperating environment (module, version, and instance).\n\nThe Modules API also has functions that retrieve the address of a module, a\nversion, or an instance. This allows an application to send requests from one\ninstance to another, in both the development and production environments.\n\nAdd the following use statement to the top of your file: \n\n use google\\appengine\\api\\modules\\ModulesService;\n\nThe following code sample shows how to get the module name and instance id for\na request: \n\n $module = ModulesService::getCurrentModuleName();\n $instance = ModulesService::getCurrentInstanceId();\n\nThe instance ID of an automatic scaled module will be returned as a unique\nbase64 encoded value, e.g. `e4b565394caa`.\n\nYou can communicate between modules in the same app by fetching the hostname of\nthe target module: \n\n use google\\appengine\\api\\modules\\ModulesService;\n\n $url = 'http://' . ModulesService::getHostname('my-backend') . '/';\n $result = file_get_contents($url);\n\nYou can also use the [URL Fetch](/appengine/docs/legacy/standard/php/issue-requests) service."]]
