Triển khai Protobuf

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

  1. C: Sử dụng phần mở rộng Protobuf PHP C, 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, không yêu cầu thêm tiện ích hệ thống.

Hãy sử dụng phương thức triển khai C khi có thể, mặc dù bạn có thể sử dụng phương thức triển khai PHP thuần tuý khi các quy tắc ràng buộc 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 được tự động cài đặt dưới dạng phần phụ thuộc của googleapis/gax-php trong Composer và được dùng trong thời gian chạy chỉ khi quá trình triển khai C không đượ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 như PHP-FPM hoặc Apache; chạy php --ini để tìm tệp cấu hình CLI):

    extension=protobuf.so

Triển khai PHP

Để sử dụng phương thức triển khai PHP thuần tuý, hãy đảm bảo rằng phương thức triển khai C đã bị tắt 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à nội dung 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.

    của thư viện ứng dụng PHP.

Xác định cách triển khai đang được sử dụng

Chạy lệnh sau trong dòng lệnh để 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 kết quả không trống (ví dụ: protobuf support => enabled), thì tức là bạn đang sử dụng phương thức triển khai C.
  • Nếu không, bạn sẽ không sử dụng phương thức triển khai C và thư viện PHP của Google Ads API sẽ tự động quay lại phương thức triển khai PHP thuần tuý do Composer cài đặt.