docs
L5-Swagger
docs | L5-Swagger | |
---|---|---|
1 | 4 | |
65 | 2,520 | |
- | - | |
0.7 | 4.8 | |
over 2 years ago | about 2 months ago | |
HTML | PHP | |
- | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
docs
-
Cloudflare Access (Zero Trust) and Bitwarden App
If you're hoping to use the Bitwarden app from external public networks it's going to be hard to use Access as there's no way for the app to do that initial authentication. You could try to exclude the paths used by the app (https://github.com/bitwarden/docs/blob/master/api/specs/public/swagger.json) but that kind of defeats the purpose of using Access. I mean, you can fudge a degree of security on by then having firewall rules apply to the API paths, say (so even though they bypass Access you could still block/allow based on country, ASN, IP, user-agent etc). You're kind of now stuck fucking about of the edges of using something not quite fit-for-purpose, mind.
L5-Swagger
-
Pragmatic development
First, swagger-php generates openapi.yaml based on code attributes, and then the spectator checks API responses to match openapi specification. The popular L5-Swagger is redundant in this case, as it is based on the same swagger-php with the addition of Swagger UI.
-
What's your go-to API documentation generator
Any particular package? I'm looking for something that will ideally inspect the api.php or controllers, and generator from there. I've found this: https://github.com/DarkaOnLine/L5-Swagger -- will give it a go.
-
Swagger/Open api integration in laravel
I have been using laravel since one and a half years, mainly for apis building. I also use dotnet where the integration of swagger/open api is very easy. With some attributes, we can customize our documentation (http codes, possible return types,..). I am looking for a way to use it in laravel but I don't find one that satisfies me. I have tried [L5-Swagger](https://github.com/DarkaOnLine/L5-Swagger/) but I don't find it practical for several reasons : - Too much comments to write
-
Validate your PHP API tests against OpenAPI definitions – a Laravel example
The second one is L5 Swagger, a popular package bringing Swagger PHP and Swagger UI to Laravel. We actually don't need Swagger PHP here, as it uses Doctrine annotations to generate OpenAPI definitions and we're going to manually write our own instead. We do need Swagger UI, however, and the package conveniently adapts it to work with Laravel (the -W option is simply here to also update related dependencies, to avoid conflicts).
What are some alternatives?
swagger-github-pages - How to host Swagger API documentation with GitHub Pages
swagger-php - A php swagger annotation and parsing library
beacon-APIs - Collection of RESTful APIs provided by Ethereum Beacon nodes
laravel-request-docs - Effortless API documentation tool for Laravel applications. Swagger alternative.
flasgger - Easy OpenAPI specs and Swagger UI for your Flask API
laravel-openapi - Generate OpenAPI specification for Laravel Applications
fastapi - FastAPI framework, high performance, easy to learn, fast to code, ready for production
openapi-psr7-validator - It validates PSR-7 messages (HTTP request/response) against OpenAPI specifications
flasgger - Easy OpenAPI specs and Swagger UI for your Flask API [Moved to: https://github.com/flasgger/flasgger]
laravel-gmail - Laravel wrapper for the Gmail API
ui - Laravel UI utilities and presets.
skeleton - A skeleton repository for League Packages