First Commit

Author: francerz

.gitignore

@@ -0,0 +1 @@
+vendor/

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2020 Francerz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice (including the next
+paragraph) shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,101 @@
+PHP HTTP Tools
+=======================================
+
+PHP HTTP Tool kit that brings common functionality in a standarized way,
+supporting PSR-7 and PSR-17 standards.
+
+Installation
+---------------------------------------
+
+Using composer.
+
+```bash
+composer install francerz/php-http-tools
+```
+
+Featured functionality
+----------------------------------------
+
+### HttpFactoryManager class
+
+Preserve per instance, reference of PSR-17 Factories (psr/http-factory).
+Uses set and get methods to manage existing factory instances.
+
+#### Individual setter methods
+
+- `setRequestFactory(RequestFactoryInterface $requestFactory)`
+- `setResponseFactory(ResponseFactoryInterface $responseFactory)`
+- `setServerRequestFactory(ServerRequestFactoryInterface $serverRequestFactory)`
+- `setStreamFactory(StreamFactoryInterface $streamFactory)`
+- `setUploadedFileFactory(UploadedFileFactoryInterface $uploadedFileFactory)`
+- `setUriFactory(UriFactoryInterface $uriFactory)`
+
+#### Getter methods
+
+Getter Methods will throw a `LogicException` if not factory has been set
+previously.
+- `getRequestFactory() : RequestFactoryInterface`
+- `getResponseFactory() : ResponseFactoryInterface`
+- `getServerRequestFactory() : ServerRequestFactoryInterface`
+- `getStreamFactory() : StreamFactoryInterface`
+- `getUploadedFileFactory() : UploadedFileFactoryInterface`
+- `getUriFactory() : UriFactoryInterface`
+
+#### Automatic setter method
+
+The method `setMatchingFactories($factoryObject)` receives an object and
+checks implementation of each Factory Interface. All matching interfaces
+will be set.
+
+This method is included on the constructor to quick factory setting.
+
+### UriHelper class
+
+Provides methods for common manipulation to `UriInterface` objects.
+
+#### Creating uri of current request
+
+- `getCurrent(UriFactoryInterface $uriFactory) : UriInterface`
+
+#### Path part manipulation
+
+- `appendPath(UriInterface $uri, string $postpath) : UriInterface`
+- `prependPath(UriInterface $uri, string $prepath) : UriInterface`
+
+#### Query part manipulation
+
+- `withQueryParams(UriInterface $uri, string $key, $value) : UriInterface`
+- `withQueryParams(UriInterface $uri, array $params, $replace = true) : UriInterface`
+- `withoutQueryParam(UriInterface $uri, string $key, &$value = null) : UriInterface`
+- `getQueryParams(UriInterface $uri) : array`
+- `getQueryParam(UriInterface $uri, string $key) : ?string`
+
+#### Fragment part manipulation
+
+- `withFragmentParam(UriInterface $uri, string $key, $value) : UriInterface`
+- `withFragmentParams(UriInterface $uri, array $params, $replace = true) : UriInterface`
+- `withoutFragmentParam(UriInterface $uri, string $key, &$value = null) : UriInterface`
+- `getFragmentParams(UriInterface $uri) : array`
+- `getFragmentParam(UriInterface $uri, string $key) : ?string`
+
+### MessageHelper class
+
+Provides methods for common manipulation to `MessageInterface` objects.
+
+#### Helper setup
+
+- `setHttpFactoryManager(HttpFactoryManager $factories)`
+- `setAuthenticationSchemes(array $authenticationSchemeClasses)`
+
+#### Creating a request object from server parameters
+
+- `getCurrentRequest() : RequestInterface`
+
+#### Handling message headers
+
+- `getAuthorizationHeader(MessageInterface $message) : ?AbstractAuthorizationHeader`
+
+#### Parsing body message content based on Content-Type header
+
+- `getContent(MessageInterface $message)`
+- `withContent(MessageInterface $message, string $mediaType, $content) : MessageInterface`

composer.json

@@ -0,0 +1,24 @@
+{
+    "name": "francerz/php-http-tools",
+    "description": "PHP HTTP Tool kit compatible with PSR-7, PSR-17 and PSR-18",
+    "type": "library",
+    "require": {
+        "psr/http-message": "^1.0",
+        "psr/http-factory": "^1.0"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^9.4"
+    },
+    "authors": [
+        {
+            "name": "Francerz",
+            "email": "francerzam@hotmail.com"
+        }
+    ],
+    "autoload": {
+        "psr-4": {
+            "Francerz\\Http\\Tools": "src/tools",
+            "Francerz\\Http\\Headers": "src/headers"
+        }
+    }
+}