Update and refactor for >= PHP 8.0

.github/workflows/build.yml

@@ -0,0 +1,35 @@
+name: Test
+on:
+  push:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-20.04
+    name: PHP ${{ matrix.php }}
+    strategy:
+      matrix:
+        php: ["8.0", "8.1", "8.2"]
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache dependencies
+        uses: actions/cache@v3
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --prefer-dist
+
+      - name: Run tests
+        run: vendor/bin/phpunit

.gitignore

@@ -4,3 +4,4 @@ vendor
 downloads
 .idea/*
 tests/.phpunit.result.cache
+.phpunit.result.cache

CHANGELOG.md

@@ -0,0 +1,169 @@
+# CHANGELOG
+
+## 0.4.0 (2023-02-10)
+
+- Set minimum PHP version to 8.0
+- Typed everything
+- Removed 'build' script
+- Updated phpunit to version 10 and updated tests
+- Docker setup for local development
+- Setup GitHub actions
+- Moved Changelog from README.md to CHANGELOG.md
+
+## 0.3.2
+
+- REFACTOR [PR #276](https://github.com/nategood/httpful/pull/276) Add properly subclassed, more descriptive Exceptions for JSON parse errors
+
+## 0.3.1
+
+- FIX [PR #286](https://github.com/nategood/httpful/pull/286) Fixed header case sensitivity
+
+## 0.3.0
+
+- REFACTOR Dropped support for dead versions of PHP. Updated the PHPUnit tests.
+
+## 0.2.20
+
+- MINOR Move Response building logic into separate function [PR #193](https://github.com/nategood/httpful/pull/193)
+
+## 0.2.19
+
+- FEATURE Before send hook [PR #164](https://github.com/nategood/httpful/pull/164)
+- MINOR More descriptive connection exceptions [PR #166](https://github.com/nategood/httpful/pull/166)
+
+## 0.2.18
+
+- FIX [PR #149](https://github.com/nategood/httpful/pull/149)
+- FIX [PR #150](https://github.com/nategood/httpful/pull/150)
+- FIX [PR #156](https://github.com/nategood/httpful/pull/156)
+
+## 0.2.17
+
+- FEATURE [PR #144](https://github.com/nategood/httpful/pull/144) Adds additional parameter to the Response class to specify additional meta data about the request/response (e.g. number of redirect).
+
+## 0.2.16
+
+- FEATURE Added support for whenError to define a custom callback to be fired upon error. Useful for logging or overriding the default error_log behavior.
+
+## 0.2.15
+
+- FEATURE [I #131](https://github.com/nategood/httpful/pull/131) Support for SOCKS proxy
+
+## 0.2.14
+
+- FEATURE [I #138](https://github.com/nategood/httpful/pull/138) Added alternative option for XML request construction. In the next major release this will likely supplant the older version.
+
+## 0.2.13
+
+- REFACTOR [I #121](https://github.com/nategood/httpful/pull/121) Throw more descriptive exception on curl errors
+- REFACTOR [I #122](https://github.com/nategood/httpful/issues/122) Better proxy scrubbing in Request
+- REFACTOR [I #119](https://github.com/nategood/httpful/issues/119) Better document the mimeType param on Request::body
+- Misc code and test cleanup
+
+## 0.2.12
+
+- REFACTOR [I #123](https://github.com/nategood/httpful/pull/123) Support new curl file upload method
+- FEATURE [I #118](https://github.com/nategood/httpful/pull/118) 5.4 HTTP Test Server
+- FIX [I #109](https://github.com/nategood/httpful/pull/109) Typo
+- FIX [I #103](https://github.com/nategood/httpful/pull/103)  Handle also CURLOPT_SSL_VERIFYHOST for strictSsl mode
+
+## 0.2.11
+
+- FIX [I #99](https://github.com/nategood/httpful/pull/99) Prevent hanging on HEAD requests
+
+## 0.2.10
+
+- FIX [I #93](https://github.com/nategood/httpful/pull/86) Fixes edge case where content-length would be set incorrectly
+
+## 0.2.9
+
+- FEATURE [I #89](https://github.com/nategood/httpful/pull/89) multipart/form-data support (a.k.a. file uploads)! Thanks @dtelaroli!
+
+## 0.2.8
+
+- FIX Notice fix for Pull Request 86
+
+## 0.2.7
+
+- FIX [I #86](https://github.com/nategood/httpful/pull/86) Remove Connection Established header when using a proxy
+
+## 0.2.6
+
+- FIX [I #85](https://github.com/nategood/httpful/issues/85) Empty Content Length issue resolved
+
+## 0.2.5
+
+- FEATURE [I #80](https://github.com/nategood/httpful/issues/80) [I #81](https://github.com/nategood/httpful/issues/81) Proxy support added with `useProxy` method.
+
+## 0.2.4
+
+- FEATURE [I #77](https://github.com/nategood/httpful/issues/77) Convenience method for setting a timeout (seconds) `$req->timeoutIn(10);`
+- FIX [I #75](https://github.com/nategood/httpful/issues/75) [I #78](https://github.com/nategood/httpful/issues/78) Bug with checking if digest auth is being used.
+
+## 0.2.3
+
+- FIX Overriding default Mime Handlers
+- FIX [PR #73](https://github.com/nategood/httpful/pull/73) Parsing http status codes
+
+## 0.2.2
+
+- FEATURE Add support for parsing JSON responses as associative arrays instead of objects
+- FEATURE Better support for setting constructor arguments on Mime Handlers
+
+## 0.2.1
+
+- FEATURE [PR #72](https://github.com/nategood/httpful/pull/72) Allow support for custom Accept header
+
+## 0.2.0
+
+- REFACTOR [PR #49](https://github.com/nategood/httpful/pull/49) Broke headers out into their own class
+- REFACTOR [PR #54](https://github.com/nategood/httpful/pull/54) Added more specific Exceptions
+- FIX [PR #58](https://github.com/nategood/httpful/pull/58) Fixes throwing an error on an empty xml response
+- FEATURE [PR #57](https://github.com/nategood/httpful/pull/57) Adds support for digest authentication
+
+## 0.1.6
+
+- Ability to set the number of max redirects via overloading `followRedirects(int max_redirects)`
+- Standards Compliant fix to `Accepts` header
+- Bug fix for bootstrap process when installed via Composer
+
+## 0.1.5
+
+- Use `DIRECTORY_SEPARATOR` constant [PR #33](https://github.com/nategood/httpful/pull/32)
+- [PR #35](https://github.com/nategood/httpful/pull/35)
+- Added the raw\_headers property reference to response.
+- Compose request header and added raw\_header to Request object.
+- Fixed response has errors and added more comments for clarity.
+- Fixed header parsing to allow the minimum (status line only) and also cater for the actual CRLF ended headers as per RFC2616.
+- Added the perfect test Accept: header for all Acceptable scenarios see  @b78e9e82cd9614fbe137c01bde9439c4e16ca323 for details.
+- Added default User-Agent header
+- `User-Agent: Httpful/0.1.5` + curl version + server software + PHP version
+- To bypass this "default" operation simply add a User-Agent to the request headers even a blank User-Agent is sufficient and more than simple enough to produce me thinks.
+- Completed test units for additions.
+- Added phpunit coverage reporting and helped phpunit auto locate the tests a bit easier.
+
+## 0.1.4
+
+- Add support for CSV Handling [PR #32](https://github.com/nategood/httpful/pull/32)
+
+## 0.1.3
+
+- Handle empty responses in JsonParser and XmlParser
+
+## 0.1.2
+
+- Added support for setting XMLHandler configuration options
+- Added examples for overriding XmlHandler and registering a custom parser
+- Removed the httpful.php download (deprecated in favor of httpful.phar)
+
+## 0.1.1
+
+- Bug fix serialization default case and phpunit tests
+
+## 0.1.0
+
+- Added Support for Registering Mime Handlers
+- Created AbstractMimeHandler type that all Mime Handlers must extend
+- Pulled out the parsing/serializing logic from the Request/Response classes into their own MimeHandler classes
+- Added ability to register new mime handlers for mime types
+

Dockerfile

@@ -0,0 +1,26 @@
+FROM ubuntu:22.04
+
+ENV TZ=UTC
+RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
+
+USER root
+WORKDIR /src
+
+RUN apt-get update \
+    && apt-get install -y gnupg curl zip unzip git sqlite3 vim ca-certificates \
+    && curl -sS 'https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x14aa40ec0831756756d7f66c4f4ea0aae5267a6c' | gpg --dearmor | tee /usr/share/keyrings/ppa_ondrej_php.gpg > /dev/null \
+    && echo "deb [signed-by=/usr/share/keyrings/ppa_ondrej_php.gpg] https://ppa.launchpadcontent.net/ondrej/php/ubuntu jammy main" > /etc/apt/sources.list.d/ppa_ondrej_php.list \
+    && apt-get update \
+    && apt-get install -y php8.2-cli php8.2-dev \
+       php8.2-sqlite3 php8.2-gd \
+       php8.2-curl \
+       php8.2-imap php8.2-mysql php8.2-mbstring \
+       php8.2-xml php8.2-zip php8.2-bcmath php8.2-soap \
+       php8.2-intl php8.2-readline \
+       php8.2-ldap \
+       php8.2-msgpack php8.2-igbinary php8.2-redis php8.2-swoole \
+       php8.2-memcached php8.2-pcov php8.2-xdebug \
+    && php -r "readfile('https://getcomposer.org/installer');" | php -- --install-dir=/usr/bin/ --filename=composer \
+    && apt-get -y autoremove \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*