Google Cloud PHP v0.12.0

Google Cloud PHP v0.12.0

What's New?

• Introducing gRPC Support for Google Cloud Pub/Sub and Google Cloud Logging!
  If your server has the gRPC PHP extension installed, your
  Pub/Sub and Logging messages will be sent over gRPC rather than HTTP/REST.
  gRPC is great for high-performance, low-latency applications, and is highly
  recommended in cases where performance and latency are concerns. (#210 and
  #217)
• Google BigQuery now supports updating tables. Use
  Google\Cloud\BigQuery\Table::update() to modify existing tables. (#216)
• Google Cloud PHP now offers a Datastore Session Handler. (#213)

What's Updated?

• Google Cloud Datastore now allows setting of the namespace ID when creating
  keys and when executing queries. It is still advised that you set your
  namespace ID when creating a client unless your use case requires more
  finely grained control. (#214)
• Google Cloud Datastore has been updated to improve the way service operations
  are executed. The previous iteration could result in situations where
  mutations intended for a transaction were committed outside the transaction.
  (#225)

What's Fixed?

• Cloud Datastore's optional entity sorting on lookupBatch has been improved
  and optimized. (#209)
• A bug preventing proper deserialization of empty arrayValue entity
  properties in Google Cloud Datastore has been fixed. (#222)
• A miscapitalized namespace in BigQuery has been fixed. (#233)

Thank You's

• Thanks to @Ged15 for providing a fix to a Datastore bug. (#222)

Google Cloud PHP v0.11.1

Google Cloud PHP v0.11.1

NOTE: This patch fixes a regression introduced in the previous release. If
you are upgrading from a version older than v0.11.0, please take a moment to
review the v0.11.0 release notes, as there are some backward incompatabilities
you should be aware of.

What's Fixed?

• Fixed a regression in Datastore in which a namespace ID was not passed into
  new Key instances. This resulted in errors on Queries and lookups which did not return
  a record. (#204)

Google Cloud PHP v0.11.0

Google Cloud PHP v0.11.0

This release includes a number of backwards-compatibility breaks. Please read
the release notes carefully if you are using Google Cloud Datastore or Google
Cloud Pub/Sub in your application. BC breaks are denoted by the prefix
❗ BREAKING CHANGE.

What's New?

• Incoming PubSub messages are now represented as an instance of
  Google\Cloud\PubSub\Message rather than as a simple array. (#168)
• Google\Cloud\PubSub\PubSubClient::consume() has been added to facilitate the
  conversion of messages send via Push Delivery to an instance of
  Google\Cloud\PubSub\Message. (#168)
• Datastore batch lookups now support sorting entities in the found result to
  match the order in which keys were supplied. Set $options['sort'] to true
  to enable sorting. (#189)
• Datastore Queries now support Keys-Only queries by calling the keysOnly()
  method on Google\Cloud\Datastore\Query\Query. (#189)
• Datastore Queries now offer simpler support for ancestor filters. We've added
  Google\Cloud\Datastore\Query\Query::hasAncestor(Key $key) to facilitate
  filtering by ancestor key. (#189)

What's Updated?

Pub/Sub

• ❗ BREAKING CHANGE
  Google\Cloud\PubSub\Subscription::pull() now returns
  Generator<Google\Cloud\PubSub\Message>. (#168)
• ❗ BREAKING CHANGE
  Google\Cloud\PubSub\Subscription::acknowledge() and Google\Cloud\PubSub\Subscription::modifyAckDeadline()now accept an instance ofGoogle\Cloud\PubSub\Message` as their first argument. (#168)
• ❗ BREAKING CHANGE
  Google\Cloud\PubSub\Subscription::acknowledgeBatch() and
  Google\Cloud\PubSub\Subscription::modifyAckDeadlineBatch() now accept
  Google\Cloud\PubSub\Message[] as their first argument. (#168)
• ❗ BREAKING CHANGE Incoming message data is now
  decoded internally. There is no need to call base64_decode() to read the
  message data. (#168)
• ❗ BREAKING CHANGE The constructor signatures for
  Google\Cloud\PubSub\Subscription and Google\Cloud\PubSub\Topic have
  changed. If you are directly instantiating these classes, please update your
  code to use Google\Cloud\PubSub\PubSubClient::topic(),
  Google\Cloud\PubSub\PubSubClient::subscription() or
  Google\Cloud\PubSub\Topic::subscription() as required. (#168)

Datastore

• ❗ BREAKING CHANGE
  The signatures of Google\Cloud\Datastore\Key::ancestor() and
  Google\Cloud\Datastore\Key::pathElement() have changed. If you
  need to specify an identifierType, it must not be done as a member of
  $options. (#189)
• ❗ BREAKING CHANGE The signature of
  Google\Cloud\Datastore\DatastoreClient::query() has changed. Query objects
  are now provided as the first argument, rather than as a member of $options,
  which has been removed. (#189)

What's Fixed?

• A bug preventing Google\Cloud\Storage\Bucket::object() from working properly
  with customer supplied encryption keys has been fixed. (#202)

Google Cloud PHP v0.10.2

Google Cloud PHP v0.10.2

What's New?

• Added Google\Cloud\Storage\StorageObject::downloadAsStream() to download a
  file from Google Cloud Storage and return it as a stream. (#199)

What's Fixed?

• Datastore Queries now respect limits and cursors, and will only auto-page
  when encountering a NOT_FINISHED query response. (#200)
• Datastore now respects existing meaning values on entity properties, and
  will properly persist and represent them on update and lookup/query
  operations. (#194)
• Improved Datastore property value type mapping. If an unknown type is
  encountered, the library will throw a RuntimeException. This should only
  happen if new types are added to Google Cloud Datastore, and will indicate to
  the user that an update to Google Cloud PHP may be required. (#194)

Thank You's

• Hat tip to @Ged15 for the additions to our implementation of Google Cloud
  Storage.

Google Cloud PHP v0.10.1

Google Cloud PHP v0.10.1

What's Fixed?

• Incorrect projection path in Datastore Query Builder has been fixed. (#188)
• Mistake in Query order constants has been fixed. (#191)
• Bug preventing source code links in official documentation has been fixed. (#197)

Google Cloud PHP v0.10.0

Google Cloud PHP v0.10.0

What's New?

• Google Cloud Storage now includes several new methods: Bucket::compose(),
  StorageObject::rewrite() and StorageObject::rename() which enable you to
  better manage your storage objects. (#169)
• Google Cloud Storage now offers the ability to use user-supplied encryption
  keys. (#169)
• Google Cloud Datastore now supports the
  Datastore Emulator,
  which can be enabled by setting the environment variable
  DATASTORE_EMULATOR_HOST. (#181)

What's Fixed?

• Datastore no longer sets readConsistency to EVENTUAL on lookups and queries.
  Instead, Datastore allows the API to determine the best option. Users may still
  choose one or the other as before. (#174 and #184)
• The documentation in Datastore has been updated to be more in line with other
  google-cloud libraries in reference to Keys. Where we formerly referred to keys
  with a complete path as "complete keys", we now use the term "named keys". (#182)

Google Cloud PHP v0.9.0

Google Cloud PHP v0.9.0

What's New?

• Google Cloud Datastore's Transaction class now includes a rollback() method.
• Google Stackdriver Logging's Logger class now includes an entries() method.

What's Fixed?

• Datastore Entities without properties were raising an error. This has been fixed.
• API Exceptions (exceptions extending Google\Cloud\Exception\ServiceException)
  will now return the full message instead of the truncated response given by Guzzle.

Shout Outs

• Thanks to @adhiravishankar for fixing a bug in Datastore.
• Thanks to @layoaster for bringing the lack of rollback() in transactions to
  our attention.

Google Cloud PHP v0.8.0

Google Cloud PHP v0.8.0

What's New?

• Added support for Google Cloud Speech. Cloud Speech allows you to take advantage of Google's advanced machine learning to convert spoken word to text.
• Google\Cloud\Storage\Object now has a copy() method allowing you to create a copy of an object in Google Cloud Storage.

What's Updated?

• ❗ BREAKING CHANGE Google\Cloud\Storage\Object has been renamed Google\Cloud\Storage\StorageObject.
• ❗ BREAKING CHANGE Google\Cloud\Vision\VisionClient::annotateBatch() now returns Google\Cloud\Vision\Annotation[] rather than a Generator.

Shout-Outs

• Thanks to @adhiravishankar for reminding us that Object has been "reserved" in PHP 7.

Google Cloud PHP v0.7.1

Google Cloud PHP v0.7.1

What's Updated?

• Cloud Datastore now offers better support for blobValues. We've added a class called Blob that you can use with a string, resource, or StreamInterface to better support blobs. You can still insert blobs into Datastore using a resource, but when executing lookups or queries, blobs will be returned as an instance of Blob.
• DatastoreClient now includes two new factory methods: geoPoint($latitude, $longitude) : GeoPoint and blob() : Blob.

What's Fixed?

• Bug in EntityMapper which prevented excluded indexes from mapping correctly has been fixed. (h/t @adhiravishankar)

Google Cloud PHP v0.7.0

Google Cloud PHP v0.7.0

What's New?

• Google Cloud PHP now supports Google Cloud Datastore. Cloud Datastore is a highly-scalable NoSQL database for your application.
• Introducing support for Google Translate API. Translate allows you to dynamically translate between thousands of available language pairs. Language detection is also available In cases where the source language is unknown.

What's Updated?

• Google Cloud PHP now supports the Pub/Sub Emulator. Just start the emulator, set the environment variable PUBSUB_EMULATOR_HOST, and we'll take care of the rest.

Thank You's

• Thanks to @kop for helping get the Pub/Sub Emulator support added to the library.
• Thanks to @cedricziel for feedback and contributions to Datastore, several documentation fixes, and bugfixes.
• Thanks to @adriankirchner for fixing a mistake in our documentation.