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)

Google Cloud PHP v0.23.0

Google Cloud PHP v0.23.0

Cloud Pub/Sub

• ❗ BREAKING CHANGE The return type of
  Google\Cloud\PubSub\Subscription::pull() has changed from
  Generator<Google\Cloud\PubSub\Message> to Google\Cloud\PubSub\Message[].
  (#375)

Cloud Vision

• Cloud Vision in Google Cloud PHP is now considered beta! That means that while
  we're not quite ready to call it done, we're getting a lot closer. You should
  expect more stability and fewer breaking changes between now and our 1.0
  release. (#387)

Various and Sundry

• Fixed a bug where application identifying headers were not sent when using an
  API key rather than a service account over the REST transport. (#378)

Google Cloud PHP v0.22.0

Google Cloud PHP v0.22.0

Cloud BigQuery

• ❗ BREAKING CHANGE When reading rows, results with a
  type such as Date now return wrapped in a PHP type managed by the library,
  rather than as a string. This change makes it easier to manipulate BigQuery
  data in PHP without worrying about mangling server data. (#350, #372)
• When inserting rows, it is now possible to pass in library types such as
  Google\Cloud\BigQuery\Date. (#350)
• The Cloud BigQuery system test suite now includes more comprehensive coverage.
  (#350)

Cloud Storage

• Fixed a bug in the Cloud Storage stream wrapper which could raise PHP notices
  when an invalid URL was used internally. (#352)

Cloud Pub/Sub

• ❗ BREAKING CHANGE Classes in the Google Cloud
  Pub/Sub wrapper no longer expose methods related to parsing and formatting
  resource names. If you desire this functionality in your application, you can
  use the Google\Cloud\PubSub\ResourceNameTrait in your classes. Affected
  classes in Google Cloud PHP are Google\Cloud\PubSub\PubSubClient,
  Google\Cloud\PubSub\Subscription and Google\Cloud\PubSub\Topic. (#358)

Cloud Vision

• Introducing Cloud Vision v1.1. Adds support for new image detections, improves
  snippet test coverage and adds system test coverage. (#365)

Various and Sundry

• Improved Snippet coverage throughout the library. (#353, #357)
• Updated the application version headers send via REST and gRPC. (#366)

Google Cloud PHP v0.21.1

Google Cloud PHP v0.21.1

Cloud Storage

• Fixed a bug in which PHP was emitting E_NOTICE messages when storage object
  info was incomplete or missing. (#347)

Google Cloud PHP v0.21.0

Google Cloud PHP v0.21.0

Cloud Storage

• Added a Cloud Storage stream wrapper. This stream wrapper enables you to
  interact with cloud storage objects with PHP's built-in file functions, such
  as file_get_contents and fopen. For more information, see PHP's
  streamWrapper documentation.
  (#323)
• Added support for per-object storage classes. (#341)

Cloud Translation

• Fixed bug in which translate calls failed due to an invalid parameter. (#344)

Stackdriver Error Reporting

• Introduced support for Stackdriver Error Reporting via gRPC. (#309)

Google Cloud PHP v0.20.2

Google Cloud PHP v0.20.2

What's New?

• Added support for Stackdriver Monitoring via a generated gRPC client. See
  Google\Cloud\Monitoring\V3 for more information. (#308)
• Google Translate has been renamed Google Cloud Transation. At this time there
  are no code changes required. Changes are limited to documentation. (#291)

What's Updated?

• PubSub and Logging generated gRPC clients have been updated. (#305)
• PHP 7.1 compatibility is now tested as part of our normal continuous
  integration process. Thanks to @cedricziel for the PR! (#303)

What's Fixed?

• Fixed Storage error in which predefinedAcl was assigned a value which was
  not always a sensible default. Thanks to @amoiseiev for the PR! (#313)
• Fixed bug in which falsey values were incorrectly filtered out by
  array_filter(). (#318)
• Fixed invalid translation response when strings is not zero-indexed. Thanks to
  @povils for the PR! (#321)

Google Cloud PHP v0.20.1

Google Cloud PHP v0.20.1

What's New?

• Google Cloud API REST Service Definitions can now be overridden by implementors. This is an advanced feature which should be used carefully, but in certain cases can allow for early access of new features not yet supported by Google Cloud PHP. (#289)

What's Fixed?

• A documentation mistake which incorrectly marked a keyFile configuration parameter as a string has been fixed. (#297)

Google Cloud PHP v0.20.0

Google Cloud PHP v0.20.0

What happened to v0.14.0 through 0.19.0?

Have you heard? We're going beta with our four major APIs! (BigQuery, Datastore,
Logging and Storage.) We've skipped a few numbers to highlight the fact that
this isn't just another minor release.

What's New?

• Datastore and BigQuery can now optionally represent integer values as an
  object called Google\Cloud\Int64. This change improves support for 32-bit
  environments, including Windows on PHP versions older than 7.0.0. To enable
  integers-as-object, pass ['returnInt64AsObject' => true] in the DatastoreClient
  and BigQueryClient constructor or factory method (ServiceBuilder::datastore(),
  ServiceBuilder::bigQuery()). (#282)
• BigQuery now supports Query value parameterization! Both named and positional
  parameters are supported. (#271)

What's Updated?

• [BC Break] Stackdriver Logging now uses "global" as its default resource
  type. (#242)

  • The signature for Google\Cloud\Logging\Logger::entry() has changed. Rather
    than accepting a resource as its second argument, a resource can be provided
    as $options['resource'], or by specifying a resource when constructing
    a Logger instance.
  • The signature for Google\Cloud\Logging\LoggingClient::psrLogger() no
    longer accepts a resource as its second argument. Instead, the second
    argument accepts an $options array, which has a resource key available.

• [BC Break] Stackdriver Logging's PSR-3 Logger has been updated to better
  support log context and to implement message placeholder interpolation. (#284)

  • If you are providing any of the stackdriver logging values (httpRequest,
    resource, labels, operation), those must be provided as members of
    $context['stackdriverOptions'].

• [BC Break] Google Cloud Storage has been updated to simplify file encryption.
  Encryption keys are now supplied by a single option,
  $options['encryptionKey'], which is expected to be base64-encoded. (#272)

  The following methods have been updated:

  • Google\Cloud\Storage\Bucket::upload()
  • Google\Cloud\Storage\Bucket::object()
  • Google\Cloud\Storage\StorageObject::copy()
  • Google\Cloud\Storage\StorageObject::rewrite()
  • Google\Cloud\Storage\StorageObkect::rename()
  • Google\Cloud\Storage\StorageObject::reload()

• [BC Break] Some BigQuery values are now returned in wrapper types rather than as
  raw data. For more information on the returned types, please refer to the
  documentation (#271)

What's Fixed?

• Datastore has been updated to support microseconds in DateTime values. (#278)
• A bug in Natural Language in which analyzeSyntax calls failed due to a missing
  parameter has been fixed. As part of this change, Natural Language now uses v1
  of the Google Natural Language API. (#281)

Google Cloud PHP v0.13.2

Google Cloud PHP v0.13.2

What's Fixed?

• Fixed the google/auth version conflict with google/apiclient for real
  this time. (#262)