Download the PHP package harmbandstra/swagger-ui-bundle without Composer
On this page you can find all versions of the php package harmbandstra/swagger-ui-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download harmbandstra/swagger-ui-bundle
More information about harmbandstra/swagger-ui-bundle
Files in harmbandstra/swagger-ui-bundle
Package swagger-ui-bundle
Short Description Exposes swagger UI inside your Symfony project through a route (eg. /docs)
License GPL-3.0-or-later
Homepage https://github.com/harmbandstra/swagger-ui-bundle
Informations about the package swagger-ui-bundle
Swagger UI Bundle
Expose swagger-ui inside your symfony project through a route (eg. /docs), just like nelmio api docs, without the need for node.
Just add a reference to your OpenAPI Yaml or JSON specification, and enjoy swagger-ui in all it's glory.
After installation and configuration, just start your local webserver, and navigate to /docs or /docs/my_swagger_spec.yml.
Compatibility
- If you need symfony 2.3 - 2.6 support, use version 1.x.
- If you need symfony 2.7 - 3.x support, or php 5.x use version 2.x.
- For symfony 3.3 and later with PHP > 7.0 use version 3.x.
- For symfony 4.0 and later with PHP => 7.1.3 use version 4.x.
- For PHP > 8.0 user version > 4.4
NOTE Since version 3.1, support for symfony 4 on the 3.x branch has been dropped. Use the 4.x branch instead.
Installation
Install with composer in dev environment:
$ composer require harmbandstra/swagger-ui-bundle --dev
Make sure swagger-ui assets are copied to web/bundles
by adding the Sensio\Bundle\DistributionBundle\Composer\ScriptHandler::installAssets
hook in your composer.json
.
If the scripts
section in composer.json looks like this (symfony 4):
Add the composer hook like this:
Enable bundle in app/AppKernel.php
(Symfony 3):
Enable bundle in config/bundles.php
(Symfony 4):
Add the route where swagger-ui will be available in routing_dev.yml
:
Configuration (Symfony 3)
In your config.yml
, link to the swagger spec.
Specify the directory
where your swagger files reside. You can access multiple files through the endpoint like /docs/my_swagger_spec.json
.
Under files
you specify which files should be exposed.
The first file in the array is the default one and it will be the file the /docs
endpoint will redirect to. For this file you have the option to specify an absolute path to the .json spec file ("/_swagger/swagger.json") or a URL ("https://example.com/swagger.json").
Optional: If you want to have a default configuration in place for Swagger UI, place a config.json
in the same directory as the swagger files, and add it to the configuration. It will be loaded automatically by appending it as the query parameter configUrl
.
Optional: If you serve your project from a different directory than the vhost root, you can overwrite the asset URL path with the assetUrlPath
configuration. Be sure to add a leading and trailing slash.
Configuration (Symfony 4, 5 and 6)
Create a file hb_swagger_ui.yaml
in config/packages
. Follow the rest of the steps for configuration in Symfony 3.
All versions of swagger-ui-bundle with dependencies
ext-json Version *
symfony/config Version ^4.4|^5.0|^6.0
symfony/dependency-injection Version ^4.4|^5.0|^6.0
symfony/framework-bundle Version ^4.4|^5.0|^6.0
symfony/http-kernel Version ^4.4|^5.0|^6.0
symfony/routing Version ^4.4|^5.0|^6.0
symfony/yaml Version ^4.4|^5.0|^6.0
swagger-api/swagger-ui Version 4.1.2