PHP 5.5와 PHP 7/8의 차이점

이 페이지는 App Engine 표준 환경에서 PHP 5.5 앱을 PHP 7/8 런타임으로 마이그레이션하는 방법을 설명합니다.

PHP 5.5와 PHP 7/8 간의 호환성 문제

공식 PHP 문서는 서로 다른 PHP 버전에서의 이전에 대한 정보를 제공합니다.

app.yaml 파일 마이그레이션

애플리케이션에서 모든 라우팅을 처리하는 프런트 컨트롤러를 배치해야 합니다. 자세한 내용은 애플리케이션 시작을 참조하세요.

PHP 7/8 런타임에서는 script 핸들러 요소를 맞춤설정할 수 없습니다. 모든 트래픽은 entrypoint 명령어를 통해 제공되므로 유일한 유효 값은 auto입니다. 모든 비정적 URL 핸들러에 script: auto가 포함되어야 성공적으로 배포됩니다.

app.yaml 구성 파일의 일부 요소 동작이 수정되었습니다.

요소유형 변경설명
entrypoint추가됨선택사항. 이 필드를 사용하여 앱 시작 시 실행할 명령어를 지정합니다.
threadsafe지원 중단됨모든 애플리케이션이 스레드 안전으로 간주됩니다. 즉, 인스턴스 한 개가 동시에 여러 요청을 처리할 수 있습니다.
api_version지원 중단됨이전에는 필수 항목이었지만 PHP 7/8 런타임에서는 필요하지 않습니다.
application_readable지원 중단됨
builtins지원 중단됨
libraries지원 중단됨composer.json 메타데이터 파일을 사용하여 임의의 타사 종속 항목을 설치할 수 있습니다.
handlers수정된 대비율
  • script 필드는 선택사항이며 auto 값만 허용됩니다. 요청이 특정 경로에 도달할 때 스크립트를 실행하려면 인앱 라우팅과 웹 프레임워크(예: Laravel, Symfony, Slim 또는 유사한 옵션)를 사용합니다.
  • login 필드는 지원되지 않습니다. 사용자 관리에 ID 및 액세스 관리(IAM)를 사용합니다.

지원 중단된 필드를 사용하면 앱 배포 시 오류가 발생합니다.

자세한 내용은 app.yaml 참조 문서를 확인하세요.

런타임 제한 감소

PHP 7/8 런타임은 PHP 5.5 런타임에 비해 제한이 적습니다.

자세한 내용은 PHP 7/8 런타임 환경 문서를 참조하세요.

App Engine PHP SDK에서 이전

런타임 마이그레이션의 번거로움과 복잡성이 줄어들도록 App Engine 표준 환경에서는 Memcache와 같은 PHP 7/8 런타임의 다양한 기존 번들 서비스와 API에 액세스할 수 있습니다. PHP 7/8 앱은 PHP 7/8용 App Engine SDK를 통해 번들 서비스 API를 호출하고 PHP 5 런타임의 경우와 동일한 기능에 대부분 액세스할 수 있습니다. PHP 5에서 사용할 수 있는 모든 기존 번들 서비스에 대해 PHP 7/8에 상응하는 서비스가 있지는 않습니다. PHP 7/8에서 사용할 수 있는 기존 번들 서비스 API의 전체 목록은 기존 번들 서비스 API 참조 문서를 확인하세요.

기존 번들 서비스와 비슷한 기능을 제공하는 Google Cloud 제품을 사용할 수도 있습니다. 이러한 Google Cloud 제품은 관용적인 Google Cloud CLI 클라이언트 라이브러리를 제공합니다. Google Cloud에서 검색과 같이 별도의 제품으로 제공되지 않는 기존 번들 서비스의 경우 타사 제공업체 또는 다른 해결 방법을 사용할 수 있습니다. 번들되지 않은 서비스로 마이그레이션하는 방법에 대한 자세한 내용은 번들 서비스에서 마이그레이션을 참조하세요.

로컬에서 애플리케이션 실행

애플리케이션을 테스트하고 로컬에서 실행하려면 다음 안내를 따르세요.

  1. App Engine 표준 환경에서 사용할 수 있는 PHP 7/8 이상 런타임 중 하나에 해당하는 PHP 버전을 로컬로 설치합니다.
  2. 웹 서버를 설치하고 이 서버를 사용하여 앱을 로컬에서 제공합니다.

예를 들어 다음 명령어를 실행하여 HTTP 서버를 시작합니다.

php -S localhost:8080

그런 다음 웹브라우저(http://localhost:8080)에서 애플리케이션을 확인합니다.