PHP 5는 지원이 종료되었으며 2026년 1월 31일에 지원 중단됩니다. 지원 중단 후에는 조직에서 이전에 조직 정책을 사용하여 레거시 런타임의 배포를 다시 사용 설정한 경우에도 PHP 5 애플리케이션을 배포할 수 없습니다. 기존 PHP 5 애플리케이션은 지원 중단 날짜 이후에도 계속 실행되고 트래픽을 수신합니다. 지원되는 최신 PHP 버전으로 마이그레이션하는 것이 좋습니다.
앱에서 사용하는 인증 옵션에 관계없이 UserService::getCurrentUser() 함수를 사용할 수 있습니다.
이메일 주소를 사용하여 User 인스턴스를 생성할 수도 있습니다.
$user = new User('Albert.Johnson@example.com');
유효한 Google 계정에 해당하지 않는 이메일 주소로 User::__construct()를 호출할 경우 객체가 생성되지만 실제 Google 계정에 상응하지 않게 됩니다. 객체가 저장된 이후에 누군가가 해당 이메일 주소로 Google 계정을 만드는 경우에도 마찬가지입니다. 생성 당시 Google 계정을 나타내지 않는 이메일 주소를 사용하는 User 값은 절대로 실제 사용자를 나타내는 User 값과 일치하지 않습니다.
유효한 사용자의 User 객체는 사용자가 이메일 주소를 변경해도 그대로 유지되는 고유한 ID 값을 사용자에게 제공합니다. getUserId() 메서드는 이 ID인 string 값을 반환합니다.
[[["이해하기 쉬움","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-09-04(UTC)"],[[["\u003cp\u003eThe \u003ccode\u003eUser\u003c/code\u003e class represents a unique user, and two equal instances signify the same user.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eUserService::getCurrentUser()\u003c/code\u003e retrieves the \u003ccode\u003eUser\u003c/code\u003e instance for the current user, regardless of the authentication method.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003eUser\u003c/code\u003e instance can be created from an email address, but it may not correspond to a valid Google account.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetUserId()\u003c/code\u003e method of a \u003ccode\u003eUser\u003c/code\u003e object provides a unique ID that remains consistent even if the user's email changes.\u003c/p\u003e\n"],["\u003cp\u003eThis API is only for first-generation runtimes, and a migration guide is available for updates to PHP 7/8 runtimes.\u003c/p\u003e\n"]]],[],null,["# User Objects\n\nAn instance of the [User](/appengine/docs/legacy/standard/php/refdocs/classes/google.appengine.api.users.User) class represents a user. User instances are unique and comparable. If two instances are equal, then they represent the same user.\n| This page describes how to use the legacy bundled services and APIs. This API can only run in first-generation runtimes in the App Engine standard environment. 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 application can access the User instance for the current user by calling the [`UserService::getCurrentUser()`](/appengine/docs/legacy/standard/php/refdocs/classes/google.appengine.api.users.UserService#method_getCurrentUser) function. \n\n use google\\appengine\\api\\users\\UserService;\n\n $user = UserService::getCurrentUser();\n\n if (isset($user)) {\n return sprintf('Welcome, %s! (\u003ca href=\"%s\"\u003esign out\u003c/a\u003e)',\n $user-\u003egetNickname(),\n UserService::createLogoutUrl('/'));\n } else {\n return sprintf('\u003ca href=\"%s\"\u003eSign in or register\u003c/a\u003e',\n UserService::createLoginUrl('/'));\n }\n\nYou can use the `UserService::getCurrentUser()` function no matter which authentication option your app uses.\n\nA User instance can be also constructed from an email address: \n\n $user = new User('Albert.Johnson@example.com');\n\nIf the [`User::__construct()`](/appengine/docs/legacy/standard/php/refdocs/classes/google.appengine.api.users.User#method___construct) is called with an email address that does not correspond with a valid Google account, the object will be created but it will not correspond with a real Google account. This will be the case even if someone creates a Google account with the given email address after the object is stored. A User value with an email address that does not represent a Google account at the time it is created will never match a User value that represents a real user.\n\nThe User object for a valid user can provide a unique ID value for the user that stays the same even if the user changes her email address. The [`getUserId()`](/appengine/docs/legacy/standard/php/refdocs/classes/google.appengine.api.users.User#method_getUserId) method returns this ID, a `string` value.\n\nThe User object has the same form no matter which method of authentication your app uses."]]