만들기를 클릭하고 Cloud Run이 자리표시자 버전을 사용해서 서비스를 만들 때까지 기다립니다.
콘솔이 함수의 소스 코드를 볼 수 있는 소스로 리디렉션됩니다. 저장 및 재배포를 클릭합니다.
함수가 배포된 후 런타임 버전을 업데이트하는 방법에 대한 자세한 내용은 새 소스 코드 재배포를 참조하세요.
소스 코드 구조
Cloud Run Functions에서 함수 정의를 찾으려면 소스 코드가 특정 구조를 따라야 합니다. 자세한 내용은 Cloud Run Functions 작성을 참조하세요.
PHP 구성
PHP 함수를 함수의 루트 디렉터리에 있는 php.ini 파일과 함께 구성합니다. 다음 코드 샘플에서 보여주는 것처럼 phpinfo() 함수를 사용하여 기존 PHP 구성 설정을 볼 수 있습니다.
use Psr\Http\Message\ServerRequestInterface;function phpInfoDemo(ServerRequestInterface $request): string{ // phpinfo() displays its output directly in the function's // HTTP response, so we don't need to explicitly return it // // Note: we recommend deleting the deployed Cloud Function once you no // longer need it, as phpinfo() may broadcast potential security issues. phpinfo(); return '';}
종속 항목 지정
PHP는 Composer를 사용하여 종속 항목을 관리합니다. composer.json 프로젝트 파일에 종속 항목을 추가하여 함수의 종속 항목을 지정합니다.
Cloud Run Functions PHP 런타임에서는 함수 프레임워크가 명시적 종속 항목이어야 합니다. 함수 프레임워크를 종속 항목으로 추가하려면 함수 코드가 포함된 디렉터리에서 다음 명령어를 실행합니다. 이 디렉터리에 composer.json 파일도 포함되어 있어야 합니다.
composer require google/cloud-functions-framework
이렇게 하면 함수 프레임워크가 composer.json에 추가되고 패키지가 vendor/ 디렉터리에 설치됩니다.
autoload.php 파일
vendor/ 디렉터리에 포함된 파일 중 하나가 autoload.php입니다.
PHP 스크립트 맨 위에 다음 줄을 추가하여 함수의 다른 종속 항목을 자동으로 require하는 autoload.php 파일을 요청합니다.
require_once __DIR__ . '/vendor/autoload.php';
기본적으로 배포 시 보내는 파일 수를 줄이기 위해 vendor/ 디렉터리는 생성된 .gcloudignore 파일에서 무시됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-15(UTC)"],[],[],null,["# The PHP runtime\n\nYour Cloud Run function runs in an environment consisting of an\noperating system version with add-on packages, language support, and\nthe [PHP Functions Framework](https://github.com/GoogleCloudPlatform/functions-framework-php)\nlibrary that supports and invokes your function. This environment is identified\nby the language version, and is known as the runtime ID.\n\nFunction preparation\n--------------------\n\nYou can prepare a function directly from the Google Cloud console or write it on\nyour local machine and upload it. To prepare your local machine for PHP\ndevelopment, see [Use PHP on Google Cloud](/php/docs).\n\nSupported PHP runtimes and base images\n--------------------------------------\n\nSelect your runtime\n-------------------\n\nYou can select one of the supported PHP runtimes for your function during\ndeployment.\n\n\nYou can select a runtime version using the Google Cloud console, or the\ngcloud CLI. Click the tab for instructions on using the tool of\nyour choice: \n\n### gcloud\n\nSpecify the [PHP base image](/run/docs/configuring/services/runtime-base-images#how_to_obtain_base_images) for your function using the `--base-image` flag,\nwhile deploying your function. For example: \n\n gcloud run deploy \u003cvar translate=\"no\"\u003eFUNCTION\u003c/var\u003e \\\n --source . \\\n --function \u003cvar translate=\"no\"\u003eFUNCTION_ENTRYPOINT\u003c/var\u003e \\\n --base-image php84\n\nReplace:\n\n- \u003cvar translate=\"no\"\u003eFUNCTION\u003c/var\u003e with the name of the function you are\n deploying. You can omit this parameter entirely,\n but you will be prompted for the name if you omit it.\n\n- \u003cvar translate=\"no\"\u003eFUNCTION_ENTRYPOINT\u003c/var\u003e with the entry point to your function in\n your source code. This is the code Cloud Run executes when your\n function runs. The value of this flag must be a function name or\n fully-qualified class name that exists in your source code.\n\nFor detailed instructions on deploying a function using the gcloud CLI, see [Deploy functions in Cloud Run](/run/docs/deploy-functions#gcloud).\n\n### Console\n\nYou can select a runtime version when you create or update a Cloud Run function in the Google Cloud console. For detailed\ninstructions on deploying a function, see [Deploy functions in Cloud Run](/run/docs/deploy-functions#deploy-functions).\n\nTo select a runtime in the Google Cloud console when you create a function, follow these steps:\n\n1. In the Google Cloud console, go to the Cloud Run page:\n\n [Go to Cloud Run](https://console.cloud.google.com/run)\n2. Click **Write a function**.\n\n3. In the **Runtime** list, select a PHP runtime version.\n\n4. Click **Create**, and wait for Cloud Run to create the service\n using a placeholder revision.\n\n5. The console will redirect you to the **Source**\n tab where you can see the source code of your function. Click **Save and redeploy**.\n\nFor detailed instructions on updating the runtime version after your function is\ndeployed, see\n[Re-deploy new source code](/run/docs/deploy-functions#update-code-functions).\n\nSource code structure\n---------------------\n\nFor Cloud Run functions to find your function's definition, your\nsource code must follow a specific structure. See\n[Write Cloud Run functions](/run/docs/write-functions#php) for\nmore information.\n\nPHP Configuration\n-----------------\n\nYou configure your PHP function with a [`php.ini`\nfile](https://www.php.net/manual/en/configuration.file.php) in your function's\nroot directory. You can view existing PHP configuration settings with the\n[`phpinfo()`](https://www.php.net/manual/en/function.phpinfo.php) function as\nshown in the following code sample: \n\n\n use Psr\\Http\\Message\\ServerRequestInterface;\n\n function phpInfoDemo(ServerRequestInterface $request): string\n {\n // phpinfo() displays its output directly in the function's\n // HTTP response, so we don't need to explicitly return it\n //\n // Note: we recommend deleting the deployed Cloud Function once you no\n // longer need it, as phpinfo() may broadcast potential security issues.\n phpinfo();\n return '';\n }\n\nSpecifying dependencies\n-----------------------\n\nPHP uses Composer to manage dependencies. You specify dependencies for your\nfunction by adding the dependencies to a project file called `composer.json`.\n\nThe Cloud Run functions PHP runtime requires the Functions\nFramework to be an explicit dependency. To add Functions Framework as a\ndependency, run the following command in the directory containing your function\ncode (this directory must also contain the `composer.json` file): \n\n composer require google/cloud-functions-framework\n\nThis adds the Functions Framework to your `composer.json` and installs the\npackage in the `vendor/` directory.\n\n### `autoload.php` file\n\nOne of the files contained in your `vendor/` directory is `autoload.php`.\n\nAdd the following line to the top of your PHP scripts to require the\n`autoload.php` file, which automatically `require`s your function's other\ndependencies: \n\n require_once __DIR__ . '/vendor/autoload.php';\n\nBy default, the `vendor/` directory is ignored in the generated\n[`.gcloudignore`](/sdk/gcloud/reference/topic/gcloudignore) file to reduce the\nnumber of files sent in deployment."]]
