[Librarian] Regenerated @ 36666be96315587760af943d4fe939d892f128d7

CHANGES.md

@@ -1,6 +1,30 @@
 twilio-php Changelog
 ====================
 
+[2019-09-18] Version 5.36.0
+----------------------------
+**Library**
+- [PR #570](https://github.com/twilio/twilio-php/pull/570): Revert to using composer to install apigen for doc generation. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #569](https://github.com/twilio/twilio-php/pull/569): Re-add DeserializeTest.php. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+- [PR #568](https://github.com/twilio/twilio-php/pull/568): Update the Dockerfile for PHP 7.1 and new code structure. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #567](https://github.com/twilio/twilio-php/pull/567): Put back the parent directory directive in 'autoload'. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #563](https://github.com/twilio/twilio-php/pull/563): Support running docker tests in Jenkins. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+- [PR #562](https://github.com/twilio/twilio-php/pull/562): Allow for usage of older PHP unit versions. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+- [PR #561](https://github.com/twilio/twilio-php/pull/561): Make docker-build work with new Dockerfile format. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+- [PR #560](https://github.com/twilio/twilio-php/pull/560): Loosen hard php version restriction. Thanks to [@thinkingserious](https://github.com/thinkingserious)!
+- [PR #557](https://github.com/twilio/twilio-php/pull/557): Prevent null date-time strings from deserializing to 'now'. Thanks to [@childish-sambino](https://github.com/childish-sambino)!
+- [PR #549](https://github.com/twilio/twilio-php/pull/549): [RFC] Test SDK on PHP 7.2 and 7.3. Thanks to [@rvanlaak](https://github.com/rvanlaak)!
+
+**Numbers**
+- Add v2 of the Identites API
+
+**Preview**
+- Changed authentication method for SDK Trusted Comms endpoints: `/CPS`, `/CurrentCall`, and `/Devices`. Please use `Authorization: Bearer <xCNAM JWT>` **(breaking change)**
+
+**Voice**
+- Add Recordings endpoints
+
+
 [2019-09-04] Version 5.35.0
 ----------------------------
 **Library**

CONTRIBUTING.md

@@ -10,7 +10,6 @@ even better than it is today! Here are the guidelines we'd like you to follow:
  - [Documentation fixes](#docs)
  - [Submission Guidelines](#submit)
  - [Coding Rules](#rules)
- - [Local Testing with Docker](#testing)
 
 ## <a name="coc"></a> Code of Conduct
 
@@ -155,22 +154,6 @@ you are working:
 * All features or bug fixes **must be tested** by one or more tests.
 * All classes and methods **must be documented**.
 
-## <a name="testing"></a> Local Testing with Docker
-
-We have included a [Dockerfile](https://github.com/twilio/twilio-php/blob/master/Dockerfile-dev) that enables easy local testing, given a specified PHP version.
-
-Sample simple workflow:
-
-1. `git clone https://github.com/twilio/twilio-php.git`
-1. `cd twilio-php`
-1. `make install`
-1. `make docker-dev-build VERSION=7.4-rc`
-1. `make docker-dev-test VERSION=7.4-rc`
-1. Modify code
-1. `make docker-dev-test VERSION=7.4-rc`
-
-Tested versions: 7.1.32, 7.2.22, 7.3.9 and 7.4-rc. A complete list of supported PHP versions can be found at the [Docker docs page](https://docs.docker.com/samples/library/php).
-
 [docs-link]: https://www.twilio.com/docs/libraries/php
 [issue-link]: https://github.com/twilio/twilio-php/issues/new
 [github]: https://github.com/twilio/twilio-php

VERSIONS.md

@@ -5,11 +5,11 @@ all changes to the helper library. It is strongly encouraged that you pin at
 least the major version and potentially the minor version to avoid pulling in
 breaking changes.
 
-Semantic Versions take the form of `MAJOR`.`MINOR`.`PATCH`
+Semantic Versions take the form of `MAJOR.MINOR.PATCH`
 
-When bugs are fixed in the library in a backwards compatible way, the `PATCH`
+When bugs are fixed in the library in a backwards-compatible way, the `PATCH`
 level will be incremented by one. When new features are added to the library
-in a backwards compatible way, the `PATCH` level will be incremented by one.
+in a backwards-compatible way, the `PATCH` level will be incremented by one.
 `PATCH` changes should _not_ break your code and are generally safe for upgrade.
 
 When a new large feature set comes online or a small breaking change is
@@ -19,18 +19,17 @@ change for upgrade. These backwards-incompatible changes will generally be
 limited to a small number of function signature changes.
 
 The `MAJOR` version is used to indicate the family of technology represented by
-the helper library. Breaking changes that requires extensive reworking of code
-will case the `MAJOR` version to be incremented by one, and the `MINOR` and
+the helper library. Breaking changes that require extensive reworking of code
+will cause the `MAJOR` version to be incremented by one, and the `MINOR` and
 `PATCH` versions will be reset to zero. Twilio understands that this can be very
 disruptive, so we will only introduce this type of breaking change when
 absolutely necessary. New `MAJOR` versions will be communicated in advance with
 `Release Candidates` and a schedule.
 
 ## Supported Versions
 
-`twilio-php` follows an evergreen model of support. New features and
-functionality will only be added to the current version. The current version -
-1 will continue to be supported with bug fixes and security updates, but no new
-features.
+Only the current `MAJOR` version of `twilio-php` is supported. New
+features, functionality, bug fixes, and security updates will only be added to
+the current `MAJOR` version.
 
-[semver]: http://semver.org/
+[semver]: https://semver.org

src/Twilio/Rest/Api/V2010/Account/AvailablePhoneNumberCountry/LocalOptions.php

@@ -117,7 +117,7 @@ public function setAreaCode($areaCode) {
     }
 
     /**
-     * The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-3). If specified, this value must have at least two characters.
+     * The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
      *
      * @param string $contains The pattern on which to match phone numbers
      * @return $this Fluent Builder
@@ -161,7 +161,7 @@ public function setVoiceEnabled($voiceEnabled) {
     }
 
     /**
-     * Whether to exclude phone numbers that require an [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or `false` and the default is `false`.
+     * Whether to exclude phone numbers that require an [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
      *
      * @param bool $excludeAllAddressRequired Whether to exclude phone numbers that
      *                                        require an Address
@@ -173,7 +173,7 @@ public function setExcludeAllAddressRequired($excludeAllAddressRequired) {
     }
 
     /**
-     * Whether to exclude phone numbers that require a local [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or `false` and the default is `false`.
+     * Whether to exclude phone numbers that require a local [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
      *
      * @param bool $excludeLocalAddressRequired Whether to exclude phone numbers
      *                                          that require a local address
@@ -185,7 +185,7 @@ public function setExcludeLocalAddressRequired($excludeLocalAddressRequired) {
     }
 
     /**
-     * Whether to exclude phone numbers that require a foreign [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or `false` and the default is `false`.
+     * Whether to exclude phone numbers that require a foreign [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
      *
      * @param bool $excludeForeignAddressRequired Whether to exclude phone numbers
      *                                            that require a foreign address
@@ -282,7 +282,7 @@ public function setInRateCenter($inRateCenter) {
     }
 
     /**
-     * Limit results to a specific local access and transport area ([LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area)). Given a phone number, search within the same [LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area) as that number. Applies to only phone numbers in the US and Canada.
+     * Limit results to a specific local access and transport area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)). Given a phone number, search within the same [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that number. Applies to only phone numbers in the US and Canada.
      *
      * @param string $inLata Limit results to a specific local access and transport
      *                       area. (US/Canada only)

src/Twilio/Rest/Api/V2010/Account/AvailablePhoneNumberCountry/MachineToMachineOptions.php

@@ -117,7 +117,7 @@ public function setAreaCode($areaCode) {
     }
 
     /**
-     * The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-3). If specified, this value must have at least two characters.
+     * The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
      *
      * @param string $contains The pattern on which to match phone numbers
      * @return $this Fluent Builder
@@ -161,7 +161,7 @@ public function setVoiceEnabled($voiceEnabled) {
     }
 
     /**
-     * Whether to exclude phone numbers that require an [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or `false` and the default is `false`.
+     * Whether to exclude phone numbers that require an [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
      *
      * @param bool $excludeAllAddressRequired Whether to exclude phone numbers that
      *                                        require an Address
@@ -173,7 +173,7 @@ public function setExcludeAllAddressRequired($excludeAllAddressRequired) {
     }
 
     /**
-     * Whether to exclude phone numbers that require a local [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or `false` and the default is `false`.
+     * Whether to exclude phone numbers that require a local [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
      *
      * @param bool $excludeLocalAddressRequired Whether to exclude phone numbers
      *                                          that require a local address
@@ -185,7 +185,7 @@ public function setExcludeLocalAddressRequired($excludeLocalAddressRequired) {
     }
 
     /**
-     * Whether to exclude phone numbers that require a foreign [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or `false` and the default is `false`.
+     * Whether to exclude phone numbers that require a foreign [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
      *
      * @param bool $excludeForeignAddressRequired Whether to exclude phone numbers
      *                                            that require a foreign address
@@ -282,7 +282,7 @@ public function setInRateCenter($inRateCenter) {
     }
 
     /**
-     * Limit results to a specific local access and transport area ([LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area)). Given a phone number, search within the same [LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area) as that number. Applies to only phone numbers in the US and Canada.
+     * Limit results to a specific local access and transport area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)). Given a phone number, search within the same [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that number. Applies to only phone numbers in the US and Canada.
      *
      * @param string $inLata Limit results to a specific local access and transport
      *                       area. (US/Canada only)

src/Twilio/Rest/Api/V2010/Account/AvailablePhoneNumberCountry/MobileOptions.php

@@ -117,7 +117,7 @@ public function setAreaCode($areaCode) {
     }
 
     /**
-     * The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/api/rest/available-phone-numbers#local-get-basic-example-3). If specified, this value must have at least two characters.
+     * The pattern on which to match phone numbers. Valid characters are `*`, `0-9`, `a-z`, and `A-Z`. The `*` character matches any single digit. For examples, see [Example 2](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-2) and [Example 3](https://www.twilio.com/docs/phone-numbers/api/availablephonenumber-resource#local-get-basic-example-3). If specified, this value must have at least two characters.
      *
      * @param string $contains The pattern on which to match phone numbers
      * @return $this Fluent Builder
@@ -161,7 +161,7 @@ public function setVoiceEnabled($voiceEnabled) {
     }
 
     /**
-     * Whether to exclude phone numbers that require an [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or `false` and the default is `false`.
+     * Whether to exclude phone numbers that require an [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
      *
      * @param bool $excludeAllAddressRequired Whether to exclude phone numbers that
      *                                        require an Address
@@ -173,7 +173,7 @@ public function setExcludeAllAddressRequired($excludeAllAddressRequired) {
     }
 
     /**
-     * Whether to exclude phone numbers that require a local [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or `false` and the default is `false`.
+     * Whether to exclude phone numbers that require a local [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
      *
      * @param bool $excludeLocalAddressRequired Whether to exclude phone numbers
      *                                          that require a local address
@@ -185,7 +185,7 @@ public function setExcludeLocalAddressRequired($excludeLocalAddressRequired) {
     }
 
     /**
-     * Whether to exclude phone numbers that require a foreign [Address](https://www.twilio.com/docs/usage/api/addresses). Can be: `true` or `false` and the default is `false`.
+     * Whether to exclude phone numbers that require a foreign [Address](https://www.twilio.com/docs/usage/api/address). Can be: `true` or `false` and the default is `false`.
      *
      * @param bool $excludeForeignAddressRequired Whether to exclude phone numbers
      *                                            that require a foreign address
@@ -282,7 +282,7 @@ public function setInRateCenter($inRateCenter) {
     }
 
     /**
-     * Limit results to a specific local access and transport area ([LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area)). Given a phone number, search within the same [LATA](http://en.wikipedia.org/wiki/Local_access_and_transport_area) as that number. Applies to only phone numbers in the US and Canada.
+     * Limit results to a specific local access and transport area ([LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area)). Given a phone number, search within the same [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) as that number. Applies to only phone numbers in the US and Canada.
      *
      * @param string $inLata Limit results to a specific local access and transport
      *                       area. (US/Canada only)