Triển khai Protobuf

Có 2 cách triển khai Protobuf cho PHP:

  1. C: Sử dụng tiện ích C Protobuf PHP, giúp cải thiện đáng kể hiệu suất thời gian chạy.
  2. PHP: Sử dụng gói PHP google/protobuf. Gói này không yêu cầu các tiện ích hệ thống bổ sung.

Sử dụng việc triển khai C nếu có thể, mặc dù bạn có thể sử dụng việc triển khai PHP thuần tuý khi các hạn chế về bảo mật hoặc môi trường ngăn việc cài đặt các tiện ích C.

Quá trình triển khai PHP sẽ tự động được cài đặt dưới dạng một phần phụ thuộc của googleapis/gax-php trong Composer và chỉ được dùng trong thời gian chạy nếu quá trình triển khai C chưa được cài đặt và bật.

Triển khai C

Cách cài đặt và định cấu hình tiện ích Protobuf PHP C:

  1. Cài đặt tiện ích bằng PECL:

    sudo pecl install protobuf

  2. Bật tiện ích trong tệp php.ini đang hoạt động (cho cả môi trường CLI và máy chủ web, chẳng hạn như PHP-FPM hoặc Apache; chạy php --ini để xác định vị trí tệp cấu hình CLI):

    extension=protobuf.so

Triển khai PHP

Để sử dụng quy trình triển khai PHP thuần tuý, hãy đảm bảo rằng quy trình triển khai C bị vô hiệu hoá và tất cả các phần phụ thuộc của googleapis/gax-php đều được cài đặt:

  1. Đánh dấu là nhận xét hoặc xoá mọi dòng extension=protobuf.so (hoặc extension=php_protobuf.dll) trong tệp php.ini.

  2. Chạy composer install từ thư mục chứa tệp composer.json của dự án. Tệp composer.json phải chỉ định googleads/google-ads-php làm phần phụ thuộc.

Xác định phương thức triển khai đang được sử dụng

Chạy lệnh sau trong thiết bị đầu cuối để kiểm tra xem tiện ích C có được bật trong môi trường PHP CLI hay không:

php -i | grep protobuf
  • Nếu đầu ra không trống (ví dụ: protobuf support => enabled), thì bạn đang sử dụng chế độ triển khai C.
  • Nếu không, bạn không sử dụng việc triển khai C và thư viện PHP Google Ads API sẽ tự động quay lại việc triển khai PHP thuần tuý do Composer cài đặt.