php-symfony.README.mustache Maven / Gradle / Ivy
# {{bundleName}}
{{#appDescriptionWithNewLines}}
{{{.}}}
{{/appDescriptionWithNewLines}}
This [Symfony](https://symfony.com/) bundle is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
- API version: {{appVersion}}
{{#artifactVersion}}
- Package version: {{.}}
{{/artifactVersion}}
{{^hideGenerationTimestamp}}
- Build date: {{generatedDate}}
{{/hideGenerationTimestamp}}
- Generator version: {{generatorVersion}}
- Build package: {{generatorClass}}
{{#infoUrl}}
For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})
{{/infoUrl}}
## Requirements
PHP 8.0 and later
## Installation & Usage
To install the dependencies via [Composer](http://getcomposer.org/), add the following repository to `composer.json` of your Symfony project:
```json
{
"repositories": [{
"type": "path",
"url": "//Path to your generated openapi bundle"
}],
}
```
Then run:
```
composer require {{gitUserId}}/{{gitRepoId}}:dev-master
```
to add the generated openapi bundle as a dependency.
## Tests
To run the unit tests for the generated bundle, first navigate to the directory containing the code, then run the following commands:
```
composer install
./vendor/bin/phpunit
```
## Getting Started
Step 1: Please follow the [installation procedure](#installation--usage) first.
Step 2: Enable the bundle in the bundle configuration:
```php
// app/config/bundles.php
return [
// ...
{{invokerPackage}}\{{bundleClassName}}::class => ['all' => true],
];
```
Step 3: Register the routes:
```yaml
# app/config/routes.yaml
{{bundleAlias}}:
resource: "@{{bundleName}}Bundle/Resources/config/routing.yaml"
```
Step 4: Implement the API calls:
```php