Google Cloud PHP v0.31.0

Google Cloud PHP v0.31.0

Cloud Pub/Sub v0.5.1

• When calling Pub/Sub methods subject to a feature whitelist (related to snapshot and seek currently), any exceptions of type Google\Cloud\Core\Exception\NotFoundException will include a reminder of whitelist status in the error message. (#482)

Cloud Spanner v0.2.0

• Generated GAPIC clients have been updated. (#508)

Cloud Speech v0.4.0

• Generated GAPIC clients have been updated. (#508)

Cloud Core v1.5.0

• Added Google\Cloud\Core\WhitelistTrait, and optional argument (bool) $whitelist = false to Google\Cloud\Core\GrpcTrait::send() and Google\Cloud\Core\RestTrait::send(). If this argument is toggled, any thrown exceptions of type Google\Cloud\Core\Exception\NotFoundException will be modified to include a reminder of whitelist status in the error message. (#482)

Google Cloud PHP v0.30.1

Google Cloud PHP v0.30.1

Cloud Spanner v0.1.1

• A bug while passing extraStatements to a Google\Cloud\Spanner\Database::create() call has been fixed. Big thanks to @bshaffer for the quick PR. (#499)
• Bumped the version requirement for google/proto-client-php. (#501)
• A bug using composite keys in a Google\Cloud\Spanner\KeySet has been fixed. (#505)

Cloud Core v1.4.1

• Fixed a bug preventing installation of packages relying on google/cloud-core. (#503)

Cloud Error Reporting v0.2.1

• Bumped the version requirement for google/proto-client-php. (#501)

Cloud Error Monitoring v0.2.1

• Bumped the version requirement for google/proto-client-php. (#501)

Google Cloud PHP v0.30.0

Google Cloud PHP v0.30.0

PLEASE NOTE v0.29.0 was also released today. Be sure to review the release notes for that version as well when upgrading your application.

Cloud Core v1.4.0

• Cloud Core v1.4.0 introduces a new Locking mechanism, with a default adapter for Symfony's new lock component. (#438)
• A new Google\Cloud\Core\Exception\AbortedException type has been introduced as part of Cloud Spanner, indicating when an operation was aborted by the server. (#438)
• A new Google\Cloud\Core\Exception\FailedPreconditionException type has been introduced as part of Cloud Spanner. This exception corresponds to HTTP status code 412. (#438)
• Google\Cloud\Core\Exception\ServiceException has been updated to provide a new method, getMetadata(), which may include additional information about the error. (#438)
• Cloud Core v1.4.0 introduces support for Long Running Operations, or LRO. LRO makes it possible to begin an operation, and poll its status in the future. LRO is supported as part of Cloud Spanner's administrative API, and will be implemented in other APIs in the future. (#438)
• Support for null values in gRPC has been improved. (#438)
• A generic Google\Cloud\Core\Retry class has been added. It functions similarly to Google\Cloud\Core\ExponentialBackoff, but requires the implementor to supply a retry delay for each iteration. (#438)

Cloud Spanner v0.1.0

• Introducing support for Cloud Spanner. Spanner is Google's horizontally scalable, globally consistent, relational database service. Google Cloud PHP supports Cloud Spanner in an alpha state, which means that we believe it is fully usable, but still may be subject to changes and improvements as it moves towards general availability. Please note that the Cloud Spanner client is gRPC only, and currently does not support REST. (#438)

Google Cloud PHP v0.29.0

Google Cloud PHP v0.29.0

BigQuery v0.2.1

• Fixed a bug in Google\Cloud\BigQuery\BigQueryClient::jobs() where the projectId was not being set correctly. (#484)

Cloud Core v1.3.0

• The ability to remove a binding from an IAM policy has been added. (#480)
• REST now always defaults as the transport, due to a memory leak discovered in gRPC. The memory leak has been addressed and this change is intended to be reverted once we upgrade to the latest version of gRPC. (#477)

Cloud Error Reporting v0.2.0

• The gRPC extension is now required in the composer.json. (#475)

Cloud Monitoring v0.2.0

• The gRPC extension is now required in the composer.json. (#475)

Cloud PubSub v0.5.0

• REST now always defaults as the transport, due to a memory leak discovered in gRPC. The memory leak has been addressed and this change is intended to be reverted once we upgrade to the latest version of gRPC. (#477)

Stackdriver Logging v1.2.0

• REST now always defaults as the transport, due to a memory leak discovered in gRPC. The memory leak has been addressed and this change is intended to be reverted once we upgrade to the latest version of gRPC. (#477)

Cloud Video Intelligence v0.1.0

• A GAPIC generated layer has been added. (#492)

Google Cloud PHP v0.28.0

Google Cloud PHP v0.28.0

Cloud Vision v0.3.0

• A GAPIC generated layer for vision has been added. (#463)

Cloud Logging v1.1.0

• Support for insertId and timestamp on Logger::entry(). (#462)

Cloud PubSub v0.4.0

• ❗ BREAKING CHANGE The Google\Cloud\PubSub\Duration and Google\Cloud\PubSub\Timestamp classes have been moved out of PubSub and into Core to be shared. Subsequently, PubSubClient::timestamp() and PubSubClient::duration() now return Google\Cloud\Core\Timestamp and Google\Cloud\Core\Duration instances. (#462)
• Shoutout to @adriankirchner for addressing a doc issue in the publish methods. (#460)

Cloud Core v1.2.0

• Google\Cloud\Core\Duration and Google\Cloud\Core\Timestamp classes have been added. (#462)
• A fix for an issue with handling sub second precision while using gRPC. (#462)

Google Cloud PHP v0.27.0

Google Cloud PHP v0.27.0

Cloud Speech v0.3.0

• ❗ BREAKING CHANGE SpeechClient::recognize() and Operation::results() now return an array of Result items which allow you full access to the response from the upstream API. (#449)
• ❗ BREAKING CHANGE The client library no longer attempts to detect sample rate or encoding type. The upstream API has been improved significantly and can do this job for us. (#449)
• A language code is no longer required at the constructor level, but will be required at the request level if a default is not set. (#449)

Cloud Core v1.1.1

• A bug has been fixed in the StreamableUploader where the content-length header was being handled incorrectly. This issue was exposed by not using cURL as the HTTP transport.
  (#448)

Google Cloud PHP v0.26.0

Google Cloud PHP v0.26.0

Cloud Language v0.3.0

• google/cloud-natural-language is now known as google/cloud-language. (#436)
• ❗ BREAKING CHANGE The Google\Cloud\NaturalLanguage
  namespace has changed to Google\Cloud\Language. (#436)
• Added support for Cloud Natural Language via gRPC at v1beta2. (#436)

Cloud Pub/Sub v0.3.0

• Cloud Pub/Sub now supports Snapshots. Snapshots may not yet be available in your project. (#428)

Cloud Core v1.1.0

• Google\Cloud\Core\PhpArray::__construct() now accepts an optional second parameter controlling whether snake case keys should be converted to camel case. (#428)

Google Cloud PHP v0.25.1

Google Cloud PHP v0.25.1

Cloud Pub/Sub

• Please note that Google Cloud PHP's Pub/Sub support was previously marked incorrectly as Beta. It should be considered alpha-quality at this time.

Cloud Core v1.0.1

• Fixed incorrect namespace reference in Google\Cloud\Core\Upload\StreamableUploader. (#427)

Google Cloud PHP v0.25.0

Google Cloud PHP v0.25.0

Cloud BigQuery v0.2.0

• ❗ BREAKING CHANGE All methods returning a Generator have been updated to return an iterator. In most cases, this change will not require changes in implementing code. Iterators function the same as the previous Generators did, but offer much more flexibility for us, and for you as a user. (#399)
• ❗ BREAKING CHANGE The constructor of Google\Cloud\BigQuery\Job has changed; $mapper is now required, and the arguments have been reordered.
• Cloud BigQuery now requires Google Cloud PHP Core at version 1.0. (#402)

Cloud Core v1.0.0

Google Cloud PHP Core is now supported at v1.0.0. This means that we consider the API to be solid and reliable, and while we'll continue to work to improve it, we will not introduce breaking changes very often, and when we do, they will come with full Semantic Versioning compliance, giving you the peace of mind to develop without worrying about an unstable API!

• ❗ BREAKING CHANGE Google\Cloud\Core\Iam\Iam::testPermissions() now returns an array of permission names, rather than the API response containing a permissions key. (#395)

Cloud Datastore v1.0.0

Google Cloud PHP now supports Cloud Datastore at v1.0.0. This means that we consider the API to be solid and reliable, and while we'll continue to work to improve it, we will not introduce breaking changes very often, and when we do, they will come with full Semantic Versioning compliance, giving you the peace of mind to develop without worrying about an unstable API!

• ❗ BREAKING CHANGE All methods returning a Generator have been updated to return an iterator. In most cases, this change will not require changes in implementing code. Iterators function the same as the previous Generators did, but offer much more flexibility for us, and for you as a user. (#399)
• Cloud Datastore now requires Google Cloud PHP Core at version 1.0. (#402)

Stackdriver Logging v1.0.0

Google Cloud PHP now supports Stackdriver Logging at v1.0.0. This means that we consider the API to be solid and reliable, and while we'll continue to work to improve it, we will not introduce breaking changes very often, and when we do, they will come with full Semantic Versioning compliance, giving you the peace of mind to develop without worrying about an unstable API!

• ❗ BREAKING CHANGE All methods returning a Generator have been updated to return an iterator. In most cases, this change will not require changes in implementing code. Iterators function the same as the previous Generators did, but offer much more flexibility for us, and for you as a user. (#399)
• Stackdriver Logging now requires Google Cloud PHP Core at version 1.0. (#402)

Cloud Natural Language v0.2.0

Google Cloud PHP now supports Cloud Natural Language at a beta level. This means that we will not make many breaking changes going forward. While we may introduce changes prior to v1.0.0, they will be relatively rare, and changes will mostly focus on improvements to your developer experience within the bounds we've already defined.

• Cloud Natural Language now requires Google Cloud PHP Core at version 1.0. (#402)

Cloud Pub/Sub v0.2.0

Google Cloud PHP now supports Cloud Pub/Sub at a beta level. This means that we will not make many breaking changes going forward. While we may introduce changes prior to v1.0.0, they will be relatively rare, and changes will mostly focus on improvements to your developer experience within the bounds we've already defined.

• ❗ BREAKING CHANGE All methods returning a Generator have been updated to return an iterator. In most cases, this change will not require changes in implementing code. Iterators function the same as the previous Generators did, but offer much more flexibility for us, and for you as a user. (#399)
• Cloud Pub/Sub now requires Google Cloud PHP Core at version 1.0. (#402)

Cloud Speech v0.2.0

• ❗ BREAKING CHANGE Google\Cloud\ServiceBuilder::speech() and Google\Cloud\Speech\SpeechClient::__construct() now require a configuration option languageCode be set to a supported language code. (#420)
• ❗ BREAKING CHANGE recognize() and beginRecognizeOperation() in Google\Cloud\Speech\SpeechClient options have changed. $options.speechContext is now $options.speechContexts. $options.sampleRate has been removed in favor of $options.sampleRateHertz. (#420)
• Client-side detection of encoding and sample rates using getID3 is no longer supported. (#420)
• Cloud Speech now requires Google Cloud PHP Core at version 1.0. (#402)

Google Cloud Storage v1.0.0

Google Cloud PHP now supports Google Cloud Storage at v1.0.0. This means that we consider the API to be solid and reliable, and while we'll continue to work to improve it, we will not introduce breaking changes very often, and when we do, they will come with full Semantic Versioning compliance, giving you the peace of mind to develop without worrying about an unstable API!

• ❗ BREAKING CHANGE All methods returning a Generator have been updated to return an iterator. In most cases, this change will not require changes in implementing code. Iterators function the same as the previous Generators did, but offer much more flexibility for us, and for you as a user. (#399)
• Fixed a bug where setting predefinedAcl on an object raised a conflict error. (#401)
• Google Cloud Storage now supports IAM access control on Buckets. (#395)
• Cloud Storage now requires Google Cloud PHP Core at version 1.0. (#402)

Cloud Translation v0.2.0

Google Cloud PHP now supports Cloud Translation at a beta level. This means that we will not make many breaking changes going forward. While we may introduce changes prior to v1.0.0, they will be relatively rare, and changes will mostly focus on improvements to your developer experience within the bounds we've already defined.

• Cloud Translation now requires Google Cloud PHP Core at version 1.0. (#402)

Cloud Vision v0.2.0

• Cloud Vision now requires Google Cloud PHP Core at version 1.0. (#402)

Google Cloud PHP v0.24.0

Google Cloud PHP v0.24.0

This is a big one. We're preparing to publish each part of Google Cloud PHP as
individual packages, so this release includes many changes to prepare for that.

Google Cloud Core

• ❗ BREAKING CHANGE We've moved everything in src/
  except for ServiceBuilder into a new Google\Cloud\Core namespace. Most of
  these classes are used internally and shouldn't have a big impact on you, but
  one to take note of: Google\Cloud\Int64 has moved to
  Google\Cloud\Core\Int64. (#360)
• ❗ BREAKING CHANGE Google\Cloud\Iam has moved to
  Google\Cloud\Core\Iam. (#360)
• ❗ BREAKING CHANGE Google\Cloud\Compute has moved
  to Google\Cloud\Core\Compute. (#360)
• ❗ BREAKING CHANGE Google\Cloud\Exception has
  moved to Google\Cloud\Core\Exception. (#360)
• ❗ BREAKING CHANGE Google\Cloud\Logger has moved
  to Google\Cloud\Core\Logger. (#360)
• ❗ BREAKING CHANGE Google\Cloud\Upload has moved
  to Google\Cloud\Core\Upload. (#360)

BigQuery

• Google\Cloud\BigQuery\Table::export() now accepts either an instance of
  Google\Cloud\Storage\StorageObject or a gcsUri string as its first argument.
  (#360)

Cloud Natural Language

• Several methods on Google\Cloud\NaturalLanguage\NaturalLanguageClient have
  been updated:

  • analyzeEntities() The first argument may be an instance of
    Google\Cloud\Storage\StorageObject, or a string. The string may be a
    gcsUri. (#360)
  • analyzeSentiment() The first argument may be an instance of
    Google\Cloud\Storage\StorageObject, or a string. The string may be a
    gcsUri. (#360)
  • analyzeSyntax() The first argument may be an instance of
    Google\Cloud\Storage\StorageObject, or a string. The string may be a
    gcsUri. (#360)

Cloud Speech

• Google\Cloud\Speech\SpeechClient::recognize() has been updated. The first
  argument may be a string of bytes, a gcsUri string, or an instance of
  Google\Cloud\Storage\StorageObject. (#360)

Google Cloud Storage

• Google\Cloud\Storage\StorageObject now exposes a new method called
  gcsUri(), which will return a Cloud Storage URI to your object. (#360)