Stay organized with collectionsSave and categorize content based on your preferences.
An App Engine app is configured using anapp.yamlfile, that contains CPU, memory, network and disk resources, scaling, and other
general settings including environment variables.
Aboutapp.yamlfiles
You can specify the runtime configuration for your PHP app,
including versions and URLs, in theapp.yamlfile. This file acts as a deployment descriptor of a specificserviceversion.
You must first create theapp.yamlfile for thedefaultservice of your app
before you can create and deployapp.yamlfiles for additional services.
The followingapp.yamldemonstrates how to configure your app to use the latest
PHP version. To use any othersupported versionof PHP,
you must update yourapp.yamlfile. For more information, seePHP runtime.
Depending on the complexity of your app's service, you might only need to define
a few elements in the correspondingapp.yamlfile. The following example
demonstrates what a simple PHP app might require in the
flexible environment:
You can specify a unique name for yourapp.yamlfiles, but then you must
specify the file name with thedeployment
commandas well. For example, if you name yourapp.yamlfileservice-name-app.yamlorapp.flexible.yaml, then you must deploy your app using either:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eAn \u003ccode\u003eapp.yaml\u003c/code\u003e file is essential for configuring an App Engine app, specifying details like CPU, memory, network, disk resources, scaling, and environment variables.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eapp.yaml\u003c/code\u003e file serves as a deployment descriptor for a specific service version of your PHP application, and it must be created for the \u003ccode\u003edefault\u003c/code\u003e service before others.\u003c/p\u003e\n"],["\u003cp\u003eTo use a specific supported version of PHP, you must update the \u003ccode\u003eapp.yaml\u003c/code\u003e file accordingly; the latest version of PHP is used if not otherwise specified.\u003c/p\u003e\n"],["\u003cp\u003eYou can name \u003ccode\u003eapp.yaml\u003c/code\u003e files uniquely, but using a custom name necessitates specifying that file name during the deployment command, such as \u003ccode\u003egcloud app deploy service-name-app.yaml\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSome PHP runtimes have reached their end of support and you are recommended to upgrade your app to the latest version of PHP.\u003c/p\u003e\n"]]],[],null,["# Configuring your app with app.yaml\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\n| **Note:** Some [PHP runtimes](/appengine/docs/flexible/lifecycle/support-schedule#php) have reached [end of support](/appengine/docs/flexible/lifecycle/runtime-lifecycle#end_of_support). You cannot re-deploy versions that use runtimes after their end of support date. We recommend that you [upgrade your app](/appengine/docs/flexible/php/runtime#newversions) to use the latest version of PHP.\n\n\u003cbr /\u003e\n\n\nAn App Engine app is configured using an `app.yaml`\nfile, that contains CPU, memory, network and disk resources, scaling, and other\ngeneral settings including environment variables.\n\n\nAbout `app.yaml` files\n----------------------\n\n\u003cbr /\u003e\n\nYou can specify the runtime configuration for your PHP app, including versions and URLs, in the `app.yaml` file. This file acts as a deployment descriptor of a specific [service](/appengine/docs/flexible/an-overview-of-app-engine) version.\n\n\u003cbr /\u003e\n\n\nYou must first create the `app.yaml` file for the `default` service of your app\nbefore you can create and deploy `app.yaml` files for additional services.\n\n\nThe following `app.yaml` demonstrates how to configure your app to use the latest\nPHP version. To use any other [supported version](/appengine/docs/flexible/lifecycle/support-schedule#php) of PHP,\nyou must update your `app.yaml` file. For more information, see\n[PHP runtime](/appengine/docs/flexible/php/runtime). \n\n runtime: php\n env: flex\n\n runtime_config:\n operating_system: \"ubuntu22\"\n document_root: .\n\nDepending on the complexity of your app's service, you might only need to define a few elements in the corresponding `app.yaml` file. The following example demonstrates what a simple PHP app might require in the flexible environment:\n\nYou can specify a unique name for your `app.yaml` files, but then you must\nspecify the file name with the [deployment\ncommand](/appengine/docs/flexible/testing-and-deploying-your-app)\nas well. For example, if you name your `app.yaml` file `service-name-app.yaml`\nor `app.flexible.yaml`, then you must deploy your app using either: \n\n gcloud app deploy service-name-app.yaml\n gcloud app deploy app.flexible.yaml\n\nTo learn more about structuring multiple services and `app.yaml` files in your app, see [Structuring web services](/appengine/docs/flexible/configuration-files).\n\n\u003cbr /\u003e\n\nAll configuration elements\n--------------------------\n\nFor a complete list of all the supported elements in this configuration file,\nsee the\n[`app.yaml` reference](/appengine/docs/flexible/reference/app-yaml)."]]
