Để thảo luận và đưa ra ý kiến phản hồi về các sản phẩm của chúng tôi, hãy tham gia kênh Discord chính thức của Google Ads trong máy chủ Cộng đồng quảng cáo và đo lường của Google.
Bạn nên sử dụng phương thức triển khai C nếu có thể, nhưng có thể cần đến PHP trong một số trường hợp (chẳng hạn như khi bị giới hạn bởi các quy tắc ràng buộc về bảo mật hoặc kỹ thuật).
Hoạt động triển khai PHP được cài đặt tự động như mọi phần phụ thuộc googleapis/gax-php khác trong Composer, nhưng chỉ được dùng trong thời gian chạy nếu hoạt động triển khai C chưa được cài đặt và định cấu hình.
Triển khai C
Cách cài đặt và định cấu hình tiện ích Protobuf PHP:
Chạy sudo pecl install protobuf từ dòng lệnh.
Thêm một dòng extension=protobuf.so vào tệp php.ini.
Triển khai PHP
Đảm bảo rằng chế độ triển khai C bị vô hiệu hoá và tất cả các phần phụ thuộc của thư viện googleapis/gax-php đều được cài đặt:
Đánh dấu ghi chú cho mọi dòng extension=protobuf.so trong php.ini.
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 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 php -i | grep protobuf:
Nếu not trống, tức là bạn đang sử dụng việc triển khai C.
Nếu không, bạn không sử dụng chế độ triển khai C và thư viện PHP Google Ads API sẽ dựa vào chế độ triển khai PHP (nếu được cài đặt đúng cách bằng Composer).
[null,null,["Cập nhật lần gần đây nhất: 2025-08-27 UTC."],[[["\u003cp\u003eThe Google Ads API for PHP offers two implementations: C (for performance) and PHP (for ease of use).\u003c/p\u003e\n"],["\u003cp\u003eThe C implementation utilizes the Protobuf PHP extension and requires manual installation via \u003ccode\u003epecl\u003c/code\u003e and \u003ccode\u003ephp.ini\u003c/code\u003e configuration.\u003c/p\u003e\n"],["\u003cp\u003eThe PHP implementation is automatically installed with \u003ccode\u003egoogleapis/gax-php\u003c/code\u003e dependencies but is used only if the C implementation is unavailable.\u003c/p\u003e\n"],["\u003cp\u003eUsers can determine the active implementation by running \u003ccode\u003ephp -i | grep protobuf\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Protobuf implementations\n\nThere are two implementations that are available for PHP:\n\n1. **C** : Uses the [Protobuf PHP extension](//pecl.php.net/package/protobuf) which gives better performance.\n2. **PHP** : Uses the [`google/protobuf` PHP\n package](//packagist.org/packages/google/protobuf) which is easier to implement.\n\nWe recommend using the C implementation if you can, but PHP may be needed in\nsome cases (such as when limited by security or technical constraints).\n\nThe PHP implementation is automatically installed like any other\n[`googleapis/gax-php`](https://github.com/googleapis/gax-php) dependencies in\nComposer, but it is used at runtime **only if** the C implementation is not\ninstalled and configured.\n\nC implementation\n----------------\n\nTo install and configure the Protobuf PHP extension:\n\n1. Run `sudo pecl install protobuf` from the command line.\n2. Add an `extension=protobuf.so` line to the `php.ini` file.\n\nPHP implementation\n------------------\n\nMake sure the C implementation is disabled and all the dependencies of\nthe [`googleapis/gax-php`](https://github.com/googleapis/gax-php) library are\ninstalled:\n\n1. Comment out any `extension=protobuf.so` line in `php.ini`.\n2. Run `composer install` from the directory that contains the\n `composer.json` file of the project being worked on. The `composer.json`\n should specify `google-ads-php` or any project that requires it as a\n dependence.\n\n | **Key Point:** Typically, the protobuf version that this PHP library relies on is transitively specified in [`composer.json`](https://github.com/googleapis/gax-php/blob/master/composer.json) of `google/gax`, which is one of the core dependencies. But for performance or compatibility reasons, we may specify the protobuf version directly in the PHP library's [`composer.json`](https://github.com/googleads/google-ads-php/blob/HEAD/composer.json).\n\nDetermine which implementation is being used\n--------------------------------------------\n\nRun `php -i | grep protobuf`:\n\n- If *not* empty, you're using the C implementation.\n- Otherwise, you're *not* using the C implementation and the Google Ads API PHP library will rely on the PHP implementation (if installed correctly using Composer)."]]
