Gijs Blanken 65df3c22b9
Rewrite the PHP Laravel generator (#20526)
* remove legacy laravel generator

* initial setup of my vision for the laravel generator

* update the php laravel samples

* update php laravel docs

* moved api validation into controller and handle edge cases presented by sample generation

* updated samples

* added php-laravel to github workflow php8 and removed php7 workflow as it only contained old laravel

* preemptive work to support union types as soon as php serde supports them

* updated samples

* update templates in accordance to samples output

* fix pipelines and update samples

* correct serde version

* fixed phpunit execution and updated samples

* added named routes

* remove

* readd samples

---------

Co-authored-by: gijs.blanken@futureof.finance <gijs.blanken@finly.nl>
Co-authored-by: William Cheng <wing328hk@gmail.com>
2025-02-17 21:50:13 +08:00

178 lines
4.5 KiB
PHP

<?php declare(strict_types=1);
/**
* OpenAPI Petstore
* This spec is mainly for testing Petstore server and contains fake endpoints, models. Please do not use this for any other purpose. Special characters: \" \\
* PHP version 8.1
*
* The version of the OpenAPI document: 1.0.0
*
*
* NOTE: This class is auto generated by OpenAPI-Generator
* https://openapi-generator.tech
* Do not edit the class manually.
*
* Source files are located at:
*
* > https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/main/resources/php-laravel/
*/
namespace OpenAPI\Server\Api;
interface PetApiInterface {
/**
* Operation addPet
*
* Add a new pet to the store
* @param \OpenAPI\Server\Model\Pet $pet
* @return \OpenAPI\Server\Model\NoContent200 | \OpenAPI\Server\Model\NoContent405
*/
public function addPet(
\OpenAPI\Server\Model\Pet $pet,
):
\OpenAPI\Server\Model\NoContent200 |
\OpenAPI\Server\Model\NoContent405
;
/**
* Operation deletePet
*
* Deletes a pet
* @param int $petId
* @param null | string $apiKey
* @return \OpenAPI\Server\Model\NoContent200 | \OpenAPI\Server\Model\NoContent400
*/
public function deletePet(
int $petId,
?string $apiKey,
):
\OpenAPI\Server\Model\NoContent200 |
\OpenAPI\Server\Model\NoContent400
;
/**
* Operation findPetsByStatus
*
* Finds Pets by status
* @param \OpenAPI\Server\Model\FindPetsByStatusStatusParameterInner[] $status
* @return \OpenAPI\Server\Model\Pet[] | \OpenAPI\Server\Model\NoContent400
*/
public function findPetsByStatus(
array $status,
):
array |
\OpenAPI\Server\Model\NoContent400
;
/**
* Operation findPetsByTags
*
* Finds Pets by tags
* @param string[] $tags
* @return \OpenAPI\Server\Model\Pet[] | \OpenAPI\Server\Model\NoContent400
* @deprecated
*/
public function findPetsByTags(
array $tags,
):
array |
\OpenAPI\Server\Model\NoContent400
;
/**
* Operation getPetById
*
* Find pet by ID
* @param int $petId
* @return \OpenAPI\Server\Model\Pet | \OpenAPI\Server\Model\NoContent400 | \OpenAPI\Server\Model\NoContent404
*/
public function getPetById(
int $petId,
):
\OpenAPI\Server\Model\Pet |
\OpenAPI\Server\Model\NoContent400 |
\OpenAPI\Server\Model\NoContent404
;
/**
* Operation updatePet
*
* Update an existing pet
* @param \OpenAPI\Server\Model\Pet $pet
* @return \OpenAPI\Server\Model\NoContent200 | \OpenAPI\Server\Model\NoContent400 | \OpenAPI\Server\Model\NoContent404 | \OpenAPI\Server\Model\NoContent405
*/
public function updatePet(
\OpenAPI\Server\Model\Pet $pet,
):
\OpenAPI\Server\Model\NoContent200 |
\OpenAPI\Server\Model\NoContent400 |
\OpenAPI\Server\Model\NoContent404 |
\OpenAPI\Server\Model\NoContent405
;
/**
* Operation updatePetWithForm
*
* Updates a pet in the store with form data
* @param int $petId
* @param null | string $name
* @param null | string $status
* @return \OpenAPI\Server\Model\NoContent200 | \OpenAPI\Server\Model\NoContent405
*/
public function updatePetWithForm(
int $petId,
?string $name,
?string $status,
):
\OpenAPI\Server\Model\NoContent200 |
\OpenAPI\Server\Model\NoContent405
;
/**
* Operation uploadFile
*
* uploads an image
* @param int $petId
* @param null | string $additionalMetadata
* @param null | \Illuminate\Http\UploadedFile $file
* @return \OpenAPI\Server\Model\ApiResponse
*/
public function uploadFile(
int $petId,
?string $additionalMetadata,
?\Illuminate\Http\UploadedFile $file,
):
\OpenAPI\Server\Model\ApiResponse
;
/**
* Operation uploadFileWithRequiredFile
*
* uploads an image (required)
* @param int $petId
* @param \Illuminate\Http\UploadedFile $requiredFile
* @param null | string $additionalMetadata
* @return \OpenAPI\Server\Model\ApiResponse
*/
public function uploadFileWithRequiredFile(
int $petId,
\Illuminate\Http\UploadedFile $requiredFile,
?string $additionalMetadata,
):
\OpenAPI\Server\Model\ApiResponse
;
}