Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/googleapis/gax-php
Google API Extensions for PHP
https://github.com/googleapis/gax-php
Last synced: about 6 hours ago
JSON representation
Google API Extensions for PHP
- Host: GitHub
- URL: https://github.com/googleapis/gax-php
- Owner: googleapis
- License: bsd-3-clause
- Created: 2016-04-29T23:57:18.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-12-11T18:13:35.000Z (22 days ago)
- Last Synced: 2024-12-26T06:02:40.719Z (7 days ago)
- Language: PHP
- Homepage: http://googleapis.github.io/gax-php/
- Size: 22 MB
- Stars: 243
- Watchers: 48
- Forks: 54
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Google API Core for PHP
- [Documentation](https://googleapis.github.io/gax-php)
Google API Core for PHP (gax-php) is a set of modules which aids the development
of APIs for clients based on [gRPC][] and Google API conventions.
Application code will rarely need to use most of the classes within this library
directly, but code generated automatically from the API definition files in
[Google APIs][] can use services such as page streaming and retry to provide a
more convenient and idiomatic API surface to callers.
[gRPC]: http://grpc.io
[Google APIs]: https://github.com/googleapis/googleapis/
## PHP Versions
gax-php currently requires PHP 8.0 or higher.
## Contributing
Contributions to this library are always welcome and highly encouraged.
See the [CONTRIBUTING][] documentation for more information on how to get
started.
[CONTRIBUTING]: https://github.com/googleapis/gax-php/blob/main/.github/CONTRIBUTING.md
## Versioning
This library follows [Semantic Versioning][].
This library is considered GA (generally available). As such, it will not
introduce backwards-incompatible changes in any minor or patch releases. We will
address issues and requests with the highest priority.
[Semantic Versioning]: http://semver.org/
## Repository Structure
All code lives under the src/ directory. Handwritten code lives in the
src/ApiCore directory and is contained in the `Google\ApiCore` namespace.
Generated classes for protobuf common types and LongRunning client live under
the src/ directory, in the appropriate directory and namespace.
Code in the metadata/ directory is provided to support generated protobuf
classes, and should not be used directly.
## Development Set-Up
These steps describe the dependencies to install for Linux, and equivalents can
be found for Mac or Windows.
1. Install dependencies.
```sh
> cd ~/
> sudo apt-get install php php-dev libcurl3-openssl-dev php-pear php-bcmath php-xml
> curl -sS https://getcomposer.org/installer | php
> sudo pecl install protobuf
```
2. Set up this repo.
```sh
> cd /path/to/gax-php
> composer install
```
3. Run tests.
```sh
> composer test
```
4. Updating dependencies after changing `composer.json`:
```sh
> composer update
`
```
5. Formatting source:
```sh
> composer cs-lint
> composer cs-fix
```
## License
BSD - See [LICENSE][] for more information.
[LICENSE]: https://github.com/googleapis/gax-php/blob/main/LICENSE