The PHP client library is hosted on [GitHub](https://github.com/googleads/google-ads-php), and is also
available through [Composer](https://getcomposer.org/) and
[Packagist](https://packagist.org/packages/googleads/google-ads-php). It offers several features to help you use the API,
including easier management of credentials and creation of Google Ads API service
clients.

## Requirements

The library requires PHP 8.1 or later. You can check the minimum PHP version
that this library supports in [`composer.json`](https://github.com/googleads/google-ads-php/blob/HEAD/composer.json). The version is
specified as the value of the `php` key under `require`.

As indicated in `composer.json`, the library depends on [gRPC](https://grpc.io/docs/quickstart/php.html).

## Get started

Follow the [quick start guide](https://developers.google.com/google-ads/api/docs/get-started/make-first-call) to make your first API call.

To install the library into your application, use [Composer](https://getcomposer.org/):

    composer require googleads/google-ads-php

## Basic usage

Refer to the [basic usage guide](https://developers.google.com/google-ads/api/docs/client-libs/php/basic-usage) to learn more about how to use the
PHP client library.

## Authentication

The PHP client library supports multiple approaches to authentication and
authorization. Refer to the [authentication guide](https://developers.google.com/google-ads/api/docs/client-libs/php/authentication) to
learn more.

## Configuration and logging

The PHP client library supports multiple [configuration](https://developers.google.com/google-ads/api/docs/client-libs/php/configuration)
and [logging](https://developers.google.com/google-ads/api/docs/client-libs/php/logging) options.

## Utilities

The PHP client library includes utility classes to improve API usability. Refer
to the following guides to learn more:

- [Running in a Docker container](https://developers.google.com/google-ads/api/docs/client-libs/php/docker)
- [Transport](https://developers.google.com/google-ads/api/docs/client-libs/php/transport)
- [Protobuf](https://developers.google.com/google-ads/api/docs/client-libs/php/protobuf)
- [Proxy configuration](https://developers.google.com/google-ads/api/docs/client-libs/php/proxy)
- [FieldMasks](https://developers.google.com/google-ads/api/docs/client-libs/php/fieldmasks)
- [ResourceNames](https://developers.google.com/google-ads/api/docs/client-libs/php/resourcenames)
- [Timeout](https://developers.google.com/google-ads/api/docs/client-libs/php/timeout)

## Performance

Refer to the [Performance guide](https://developers.google.com/google-ads/api/docs/client-libs/php/performance) for recommendations on how
to fine-tune your application's performance.