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)

Google Cloud PHP v0.13.1

Google Cloud PHP v0.13.1

What's Updated

• Google Cloud Logging now uses resourceName instead of projectId for
  logging entries. (#235 and #253)

What's Fixed

• The version of google/auth has been updated to prevent conflicts when using
  other Google libraries which rely on auth. (#256)
• Connection options are removed after being set as URI parameters. This fixes
  a failure case in the Pub/Sub emulator. (#251)
• When using gRPC, google-cloud-php now uses the correct key name for
  application version. (#247)