Download the PHP
package mako/open-api without Composer
On this page you can find all versions of the php package
mako/open-api. It is possible to download/install
these versions without Composer. Possible dependencies are resolved
automatically.
Vendor mako Package open-api Short Description Generate routes based on OpenAPI specifications and OpenAPI specifications from code License
BSD-3-Clause Homepage http://makoframework.com
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
The mako/open-api package allows you to generate a OpenApi specification using attributes or docblock annotations and to generate routes based on the specification.
Requirements
Mako 10.0 or greater.
Installation
First you'll need to install the package as a dependency to your project.
Next you'll need to add the package to the cli section of the packages configuration array in the application.php config file.
And finally replace the contents of your routes.php file with the following:
Usage
You can build an OpenApi specification using a tool like Apicurito or by documenting your code using attributes or docblock annotations. To check out the syntax head over to the zircote/swagger-php documentation.
If you want to generate a specification file based on your documentation then you can do so by running the open-api:generate-spec command.
To generate a cached route file for production then you'll have to run the open-api:generate-routes command.
Note that you have to set the operationId parameter to the fully qualified method name (e.g. app\controllers\Index::welcome) of your controller action for the route generator to work.
Composer command for our command line client (download client)This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free.Standard composer command
The package mako/open-api contains the following files
Loading the files please wait ....
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.