Protobuf 구현

PHP에서 사용할 수 있는 Protobuf 구현은 두 가지입니다.

  1. C: Protobuf PHP C 확장 프로그램을 사용하며, 런타임 성능이 훨씬 더 좋습니다.
  2. PHP: 추가 시스템 확장 프로그램이 필요하지 않은 google/protobuf PHP 패키지를 사용합니다.

가능한 경우 C 구현을 사용하세요. 보안 또는 환경 제약으로 인해 C 확장 프로그램을 설치할 수 없는 경우 순수 PHP 구현을 사용할 수 있습니다.

PHP 구현은 Composer에서 googleapis/gax-php의 종속 항목으로 자동 설치되며 C 구현이 설치되고 사용 설정되지 않은 경우에만 런타임에 사용됩니다.

C 구현

Protobuf PHP C 확장 프로그램을 설치하고 구성하려면 다음 단계를 따르세요.

  1. PECL을 사용하여 확장 프로그램을 설치합니다.

    sudo pecl install protobuf

  2. 활성 php.ini 파일에서 확장 프로그램을 사용 설정합니다(CLI 및 웹 서버 환경(예: PHP-FPM 또는 Apache) 모두에 해당. php --ini를 실행하여 CLI 구성 파일을 찾음).

    extension=protobuf.so

PHP 구현

순수 PHP 구현을 사용하려면 C 구현이 사용 중지되어 있고 googleapis/gax-php의 모든 종속 항목이 설치되어 있는지 확인하세요.

  1. php.ini 파일에서 extension=protobuf.so (또는 extension=php_protobuf.dll) 줄을 주석 처리하거나 삭제합니다.

  2. 프로젝트의 composer.json 파일이 포함된 디렉터리에서 composer install를 실행합니다. composer.json 파일은 googleads/google-ads-php을 종속 항목으로 지정해야 합니다.

사용 중인 구현 확인

터미널에서 다음 명령어를 실행하여 PHP CLI 환경에서 C 확장 프로그램이 사용 설정되어 있는지 확인합니다.

php -i | grep protobuf
  • 출력이 비어 있지 않으면 (예: protobuf support => enabled) C 구현을 사용하고 있는 것입니다.
  • 그렇지 않으면 C 구현을 사용하지 않는 것이며 Google Ads API PHP 라이브러리는 Composer에 의해 설치된 순수 PHP 구현으로 자동 대체됩니다.