Bump supported php version to 8.2 (#546)

* Set php to 8.2.26 in new .tool-versions file

Php 8.2 is an actively maintained branch of the Php language, and will continue
receiving active bug fix and security updates until 2024-12-31 [1]

[1] https://php.watch/versions/8.2/releases

* Replace fzaninotto/faker with fakerphp/faker, a maintained fork

This is required to bump to 8.2

* Bump phpunit from 4.5.1 to 11.5.0 to support php 8.2

* Update composer lock file to reflect new dependency versions

* Use php 8.2 docker image

* Indicate that php 8.2 or higher is supported

* Update wording in unit test from 7.4 to 8.2

* Update minimum required version in composer.json from 7.4 to 8.2

* Update to more modern phpunit syntax

* Ignore phpunit output file

* Add simple composer scripts for easier testing

* Resolve static function errors

* Handle phpunit test method + annotation deprecations

* Fix: Adjust names of test objects to objects under test

This will deal with a couple of warning messages that occur during test run

* Exclude basic test (abstract class) from test suites to avoid warn

So that we don't get a phpunit warning message, let's exclude these abstract
classes from each respective test suite, as they were not being run anyway.

* Fix deprecated annotations by asserting in test

* Fix broken test by searching on email rather than name

* Bump to php 8.2.27

- PHP 8.2.27 was released yesterday [1] so let's ensure that we get the latest
  and greatest version of this branch at least in terms of our asdf config

[1] https://www.linuxcompatible.org/story/php-8227-released/

Author: token-cjg

.gitignore

@@ -1,3 +1,4 @@
 vendor
 phpunit.xml
 tmp/**
+.phpunit.result.cache

.tool-versions

@@ -0,0 +1 @@
+php 8.2.27

Dockerfile

@@ -1,4 +1,4 @@
-FROM php:7.4-cli
+FROM php:8.2-cli
 
 # OS requirements for PHP
 RUN apt-get update && apt-get install -y git unzip

README.md

@@ -16,7 +16,7 @@ This client **only** supports Zendesk's API v2.  Please see our [API documentati
 
 ## Requirements
 
-* PHP 7.4+
+* PHP 8.2+
 
 ## Installation
 

composer.json

@@ -4,22 +4,26 @@
   "license": "Apache-2.0",
   "homepage": "https://github.com/zendesk/zendesk_api_client_php",
   "require": {
-    "php": ">=7.4.0",
+    "php": ">=8.2.0",
     "guzzlehttp/guzzle": "^6.0 || ^7.0",
     "guzzlehttp/psr7": "^1.7 || ^2.0",
     "mmucklo/inflect": "0.3.*"
   },
   "require-dev": {
-    "phpunit/phpunit": "4.5.*",
+    "phpunit/phpunit": "11.5.0",
     "squizlabs/php_codesniffer": "2.*",
     "phpmd/phpmd": "@stable",
-    "fzaninotto/faker": ">=1.5.0",
+    "fakerphp/faker": "^1.24.1",
     "psy/psysh": "@stable"
   },
   "autoload": {
     "psr-0": {
       "Zendesk\\API\\": "src/",
       "Zendesk\\Console\\": "src/"
     }
+  },
+  "scripts": {
+    "test:unit": "vendor/bin/phpunit --testsuite 'Zendesk API Unit Test Suites'",
+    "test:live": "vendor/bin/phpunit --testsuite 'Zendesk API Live Test Suites'"
   }
 }