Triển khai Protobuf

Cảnh báo: Kể từ ngày 31 tháng 3 năm 2024, thư viện ứng dụng API Google Ads cho PHP sẽ không hỗ trợ các phiên bản PHP dưới 8.1 nữa. Để đảm bảo quá trình hoạt động liền mạch, bạn nên nâng cấp phiên bản PHP trước ngày này.

Có hai cách triển khai có thể sử dụng cho PHP:

1. C: Sử dụng tiện ích Protobuf PHP mang lại hiệu suất tốt hơn.
2. PHP: Sử dụng gói google/protobuf PHP dễ triển khai hơn.

Bạn nên sử dụng phương thức triển khai C nếu có thể, nhưng trong một số trường hợp (chẳng hạn như khi bị giới hạn về bảo mật hoặc kỹ thuật), bạn có thể cần đến PHP.

Phương thức triển khai PHP được tự động cài đặt như mọi phần phụ thuộc googleapis/gax-php khác trong Composer. Tuy nhiên, phương thức này chỉ được dùng trong thời gian chạy chỉ khi phương thức triển khai C không được cài đặt và định cấu hình.

Triển khai C

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

1. Chạy sudo pecl install protobuf qua dòng lệnh.
2. Thêm một dòng extension=protobuf.so vào tệp php.ini.

Triển khai PHP

Hãy đảm bảo bạn đã tắt phương thức triển khai C và tất cả các phần phụ thuộc của thư viện googleapis/gax-php đều được cài đặt:

1. Đánh dấu vào dòng extension=protobuf.so bất kỳ trong php.ini.

2. Chạy composer install từ thư mục chứa tệp composer.json của dự án đang được xử lý. composer.json phải chỉ định google-ads-php hoặc bất kỳ dự án nào yêu cầu phần phụ thuộc này.

   Lưu ý quan trọng: Thông thường, phiên bản protobuf mà thư viện PHP này dựa vào sẽ được chỉ định bắc cầu trong composer.json của google/gax, đây là một trong những phần phụ thuộc cốt lõi. Tuy nhiên, vì lý do về hiệu suất hoặc khả năng tương thích, chúng tôi có thể chỉ định phiên bản protobuf ngay trong composer.json của thư viện PHP.

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

Chạy php -i | grep protobuf:

• Nếu không trống, tức là bạn đang sử dụng phương thức triển khai C.
• Nếu không, bạn không sử dụng phương thức triển khai C và thư viện PHP của API Google Ads sẽ dựa vào phương thức triển khai PHP (nếu được cài đặt đúng cách bằng Composer).