BLUE

Navigation

Breadcrumbs

Upload

Tip: You can also drag & drop files anywhere on this page to upload.

Edit File Size: 1.27 KB

/var/www/multi-event-cfp.bitkit.dk/httpdocs/vendor/zircote/swagger-php/docs/index.md

Text Base64

---
home: true
actionText: User Guide →
actionLink: /guide/
features:
  - title: OpenAPI conformant
    details: Generate OpenAPI documents in version 3.0 or 3.1.
  - title: Document your API inside PHP source code
    details: Using swagger-php lets you write the API documentation inside the PHP source files
      which helps keeping the documentation up-to-date.
  - title: Annotation and Attribute support
    details: Annotations can be either docblocks or PHP 8.1 attributes.
---

### 1. Install with composer:

```shell
> composer require zircote/swagger-php
```

### 2. Update your code

<<< @/snippets/minimal_api.php

### 3. Generate OpenAPI documentation

```shell
> ./bin/openapi src -o openapi.yaml
```

### 4. Explore and interact with your API

Use an OpenAPI tool like [Swagger UI ](https://swagger.io/tools/swagger-ui/) to explore and interact with your API.

## Links

- [User Guide](guide/index.md)
- [Reference](reference/index.md)
- [OpenApi Documentation](https://oai.github.io/Documentation/)
- [OpenApi Specification](https://spec.openapis.org/oas/v3.1.0.html)
- [Learn by example](https://github.com/zircote/swagger-php/tree/master/Examples)
- [Related projects](related-projects.md)
- [Swagger-php 2.x documentation](https://github.com/zircote/swagger-php/tree/2.x/docs)

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
.vitepress DIR	-	drwxrwxr-x	2022-04-17 01:42:30	Edit Download recursive recursive
guide DIR	-	drwxrwxr-x	2022-04-17 01:42:30	Edit Download recursive recursive
reference DIR	-	drwxrwxr-x	2022-04-17 01:42:30	Edit Download recursive recursive
snippets DIR	-	drwxrwxr-x	2022-04-17 01:42:30	Edit Download recursive recursive
index.md	1.27 KB	lrw-rw-r--	2022-04-17 01:42:30	Edit Download recursive recursive
package.json	360 B	lrw-rw-r--	2022-04-17 01:42:30	Edit Download recursive recursive
refgen.php	9.14 KB	lrw-rw-r--	2022-04-17 01:42:30	Edit Download recursive recursive
related-projects.md	1.95 KB	lrw-rw-r--	2022-04-17 01:42:30	Edit Download recursive recursive

Directory Contents