Stay organized with collections
Save and categorize content based on your preferences.
Specify the PHP version
By default the PHP Runtime buildpack uses the latest stable version of PHP. If
your application requires a specific version, you can specify one by including
a composer.json file in your application's root directory. For example:
"require":{"php":"8.3.*",}
Configure Composer
By default, the Composer version is 2.1.3. If you require a specific
version of Composer, you can use the GOOGLE_COMPOSER_VERSION environment
variable to specify any supported version of Composer using the full
semantic version. For example:
[[["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-08-29 UTC."],[[["\u003cp\u003eYou can specify a particular PHP version for your application by defining it in the \u003ccode\u003ecomposer.json\u003c/code\u003e file, such as \u003ccode\u003e"php": "8.3.*"\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe default Composer version is \u003ccode\u003e2.1.3\u003c/code\u003e, but you can set a different supported version using the \u003ccode\u003eGOOGLE_COMPOSER_VERSION\u003c/code\u003e environment variable.\u003c/p\u003e\n"],["\u003cp\u003eCustom NGINX configurations can be implemented by specifying a custom configuration file using the \u003ccode\u003eGOOGLE_CUSTOM_NGINX_CONFIG\u003c/code\u003e environment variable.\u003c/p\u003e\n"]]],[],null,["# Building a PHP application\n\nSpecify the PHP version\n-----------------------\n\nBy default the PHP Runtime buildpack uses the latest stable version of PHP. If\nyour application requires a specific version, you can specify one by including\na `composer.json` file in your application's root directory. For example: \n\n \"require\": {\n \"php\": \"8.3.*\",\n }\n\nConfigure Composer\n------------------\n\nBy default, the Composer version is `2.1.3`. If you require a specific\nversion of Composer, you can use the `GOOGLE_COMPOSER_VERSION` environment\nvariable to specify any supported version of Composer using the full\nsemantic version. For example: \n\n pack build sample-php --builder=gcr.io/buildpacks/builder \\\n --env GOOGLE_COMPOSER_VERSION=\"2.2.20\"\n\nCustomizing NGINX configurations\n--------------------------------\n\nTo configure NGINX, you can use the `GOOGLE_CUSTOM_NGINX_CONFIG` environment\nvariable to specify your custom NGINX configuration file. For example: \n\n pack build sample-php --builder=gcr.io/buildpacks/builder \\\n --env GOOGLE_CUSTOM_NGINX_CONFIG=\"nginx-custom.conf\"\n\nWhen NGINX starts, your custom NGINX file is used."]]