chubbyphp / chubbyphp-negotiation

A simple negotiation library.

petstore

Description

A simple skeleton to build api's based on the chubbyphp-framework.

Requirements

• php: ^8.1
• chubbyphp/chubbyphp-clean-directories: ^1.3.1
• chubbyphp/chubbyphp-cors: ^1.5
• chubbyphp/chubbyphp-decode-encode: ^1.1
• chubbyphp/chubbyphp-framework: ^5.1.1
• chubbyphp/chubbyphp-framework-router-fastroute: ^2.1
• chubbyphp/chubbyphp-http-exception: ^1.1
• chubbyphp/chubbyphp-laminas-config: ^1.4
• chubbyphp/chubbyphp-laminas-config-doctrine: ^2.2
• chubbyphp/chubbyphp-laminas-config-factory: ^1.3
• chubbyphp/chubbyphp-negotiation: ^2.0
• chubbyphp/chubbyphp-parsing: ^1.1.1
• doctrine/orm: ^2.17.2
• monolog/monolog: ^3.5
• ramsey/uuid: ^4.7.5
• slim/psr7: ^1.6.1
• symfony/console: ^6.4.2

Environment

Add the following environment variable to your system, for example within ~/.bash_aliases:

export USER_ID=$(id -u)
export GROUP_ID=$(id -g)

Docker

docker-compose up -d
docker-compose exec php bash

Urls

• GET https://localhost/ping
• GET https://localhost/swagger (https://localhost/openapi)

Pet

• GET https://localhost/api/pets?sort[name]=asc
• POST https://localhost/api/pets
• GET https://localhost/api/pets/8ba9661b-ba7f-436b-bd25-c0606f911f7d
• PUT https://localhost/api/pets/8ba9661b-ba7f-436b-bd25-c0606f911f7d
• DELETE https://localhost/api/pets/8ba9661b-ba7f-436b-bd25-c0606f911f7d

DBs

• jdbc:postgresql://localhost:5432/petstore?user=root&password=root

Installation

Through Composer as chubbyphp/petstore.

composer create-project chubbyphp/petstore myproject "dev-chubbyphp"

Setup

composer setup:dev

Structure

Collection

Collections are sortable, filterable paginated lists of models.

• App\Collection

Dto

A DTO, or Data Transfer Object, is a simple object used to transport data between software application components.

• App\Dto

Middleware

Middleware functions can execute code, make changes to the request and response objects. Middleware can generally be added globally or on a per-route basis.

• App\Middleware

Model

Models, entities, documents what ever fits your purpose the best.

• App\Model

ORM

ORM Mapping definitions.

• App\ORM

Parsing

Parses and validates data against predefined schemas, ensuring that incoming data conforms to expected structures and criteria.

• App\Parsing

Repository

Repositories get data from storages like databases, elasticsearch, redis or whereever your models are stored or cached.

• App\Repository

RequestHandler

RequestHandler alias Controller, or Controller actions to be more precise. There is a directory with generic crud controllers. If you like the idea adapt them for your generic use case, if not drop them. I highly recommend to not extend them.

• App\RequestHandler

ServiceFactory

Service factories are the glue code of the dependeny injection container.

• App\ServiceFactory

Copyright

2024 Dominik Zogg

chubbyphp-negotiation's Issues

AcceptLanguageNegotiator can result in a PHP NOTICE because of undefined offset

When we have a Accept-Language like "de" Chubbyphp\Negotiation\AcceptLanguageNegotator will throw a PHP NOTICE on line 61

• Undefined offset: 1

[$attributeKey, $attributeValue] = explode('=', $attribute);

Reason is that it is possible, that there is no equal sign "=" in the header value.

See https://github.com/chubbyphp/chubbyphp-negotiation/blob/master/src/AcceptLanguageNegotiator.php#L61

Thanks in Advance.

BC in the NegotiatorInterface

In the version 1.8.1 BC was introduced with changing the return type of the method negotiate

-    public function negotiate(Request $request);
+    public function negotiate(Request $request): ?NegotiatedValueInterface;

AcceptNegotiator.php string handling

chubbyphp-negotiation/src/AcceptNegotiator.php:98 has an unsafe explode which can throw notices if the accept header string does not contain any slash