Release 33.0.0.

CHANGELOG.md

@@ -1,3 +1,29 @@
+### 33.0.0
+
+##### AdWords
+
+*   Accepted [PR #429](https://github.com/googleads/googleads-php-lib/pull/429).
+*   Removed support and examples for v201702. See deprecation schedule at:
+    https://developers.google.com/adwords/api/docs/sunset-dates
+
+##### DFP
+
+*   Accepted [PR #438](https://github.com/googleads/googleads-php-lib/pull/438).
+*   Added support and examples for v201802.
+*   Removed support for v201702.
+*   Removed examples for v201705.
+
+##### Common
+
+*   Fixed [issue
+    #194](https://github.com/googleads/googleads-php-lib/issues/194).
+*   Accepted [PR #396](https://github.com/googleads/googleads-php-lib/pull/396).
+*   Accepted [PR #415](https://github.com/googleads/googleads-php-lib/pull/415).
+*   Accepted [PR #421](https://github.com/googleads/googleads-php-lib/pull/421).
+*   Accepted [PR #422](https://github.com/googleads/googleads-php-lib/pull/422).
+*   Fixed
+    [issue #426](https://github.com/googleads/googleads-php-lib/issues/426).
+
 ### 32.1.0
 
 ##### DFP

README.md

@@ -39,9 +39,9 @@ This library determines the home directory of your computer by using
 [`EnvironmentalVariables::getHome()`](https://github.com/googleads/googleads-php-lib/blob/master/src/Google/AdsApi/Common/Util/EnvironmentalVariables.php#L34).
 
 *   [AdWords
-     adsapi_php.ini](https://github.com/googleads/googleads-php-lib/blob/master/examples/AdWords/adsapi_php.ini)
+    adsapi_php.ini](https://github.com/googleads/googleads-php-lib/blob/master/examples/AdWords/adsapi_php.ini)
 *   [DFP
-     adsapi_php.ini](https://github.com/googleads/googleads-php-lib/blob/master/examples/Dfp/adsapi_php.ini)
+    adsapi_php.ini](https://github.com/googleads/googleads-php-lib/blob/master/examples/Dfp/adsapi_php.ini)
 
 ### Downloading this library
 
@@ -345,9 +345,12 @@ To remedy, see [Steps for troubleshooting CA file issues](https://github.com/goo
 
 ### Documentation
 
-> PHPDoc is not yet available for the new ads API PHP library. Follow the
-> [PHPDoc issue](https://github.com/googleads/googleads-php-lib/issues/194) for
-> updates.
+PHPDoc for this library can be found in the
+[gh-pages](https://github.com/googleads/googleads-php-lib/tree/gh-pages) branch
+of this repository and can be viewed at:
+
+* [AdWords](http://googleads.github.io/googleads-php-lib/AdWords/)
+* [DFP](http://googleads.github.io/googleads-php-lib/Dfp/)
 
 General AdWords and DFP API documentation can be found on our Google Developers
 site:
@@ -356,6 +359,22 @@ site:
 *   [DFP API
     documentation](https://developers.google.com/doubleclick-publishers)
 
+### Coding Style
+
+We use PSR-2 as a coding style standard. Assuming that you're at the root
+directory of your project, to check for coding style violations,
+run
+
+```
+vendor/bin/phpcs src --standard=phpcs_ruleset.xml -np
+```
+
+To automatically fix (fixable) coding style violations, run
+
+```
+vendor/bin/phpcbf src --standard=phpcs_ruleset.xml
+```
+
 ### Getting support
 
 For client library specific bug reports, feature requests, and patches,

UPGRADING.md

@@ -198,16 +198,15 @@ DFP examples location     | [Examples](https://github.com/googleads/googleads-ph
 
 ## PHPDoc
 
-The old library provided PHPDoc pages under
+The old library does not provide PHPDoc pages anymore. The new library provides
+PHPDoc pages under
 [gh-pages](https://github.com/googleads/googleads-php-lib/tree/gh-pages) on
-GitHub. The new library does not provide these yet. See
-[issue #194](https://github.com/googleads/googleads-php-lib/issues/194) to track
-progress on this.
-
-|              | Old library                                                                                          | New library
--------------- | ---------------------------------------------------------------------------------------------------- | -----------
-AdWords PHPDoc | [PHPDoc](http://googleads.github.io/googleads-php-lib/\(Deprecated%20-%20old%20library\)%20AdWords/) | TBD
-DFP PHPDoc     | [PHPDoc](http://googleads.github.io/googleads-php-lib/\(Deprecated%20-%20old%20library\)%20Dfp/)     | TBD
+GitHub.
+
+|              | Old library    | New library
+-------------- | -------------- | -----------
+AdWords PHPDoc | Already sunset | [PHPDoc](http://googleads.github.io/googleads-php-lib/AdWords/)
+DFP PHPDoc     | Already sunset | [PHPDoc](http://googleads.github.io/googleads-php-lib/Dfp/)
 
 ## Questions?
 

check_conditions.php

@@ -0,0 +1,9 @@
+<?php
+if (PHP_INT_SIZE === 4) {
+  print "\033[1;97;41mYou are using the 32-bit PHP. Please beware that when you"
+      . " pass numeric values that exceed the 32-bit PHP_INT_MAX to intval(),"
+      . " you'll not get a correct value.\nIf you plan to try our code examples"
+      . ", please change all instances of intval() to floatval() first.\n"
+      . " In addition, when writing your own code, do not apply intval() on any"
+      . " attributes that are explicitly an integer.\n\033[0m";
+}

composer.json

@@ -14,7 +14,8 @@
   },
   "require-dev": {
     "php": ">=5.5.17",
-    "phpunit/phpunit": "^4.8.35 || ^5.7"
+    "phpunit/phpunit": "^4.8.35 || ^5.7",
+    "squizlabs/php_codesniffer": "^2.9 || ^3.2"
   },
   "suggest": {
     "php-64bit": ">=5.5.9"
@@ -29,5 +30,9 @@
       "name": "Google",
       "homepage": "https://github.com/googleads/googleads-php-lib/contributors"
     }
-  ]
+  ],
+  "scripts": {
+    "pre-update-cmd": "@php check_conditions.php",
+    "pre-install-cmd": "@php check_conditions.php"
+  }
 }