PHPackages                             kaz29/cakephp-open-api-theme-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. kaz29/cakephp-open-api-theme-plugin

ActiveCakephp-plugin[Utility &amp; Helpers](/categories/utility)

kaz29/cakephp-open-api-theme-plugin
===================================

OpenApiTheme plugin for CakePHP

1.2.2(1y ago)439.6k↓63.6%1[1 issues](https://github.com/kaz29/cakephp-open-api-theme-plugin/issues)[1 PRs](https://github.com/kaz29/cakephp-open-api-theme-plugin/pulls)MITTwigPHP &gt;=8.3

Since Mar 2Pushed 1y ago1 watchersCompare

[ Source](https://github.com/kaz29/cakephp-open-api-theme-plugin)[ Packagist](https://packagist.org/packages/kaz29/cakephp-open-api-theme-plugin)[ RSS](/packages/kaz29-cakephp-open-api-theme-plugin/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (4)Versions (22)Used By (0)

OpenApiTheme plugin for CakePHP
===============================

[](#openapitheme-plugin-for-cakephp)

Installation
------------

[](#installation)

You can install this plugin into your CakePHP application using [composer](https://getcomposer.org).

The recommended way to install composer packages is:

```
composer require kaz29/cakephp-open-api-theme-plugin --dev

```

Dependency
----------

[](#dependency)

- [Crud plugin](https://github.com/FriendsOfCake/crud)
- [swagger-php](https://github.com/zircote/swagger-php)

Setup
-----

[](#setup)

- Copy `swagger-settings.php` to config directory.
- Describe the settings of your application in `swagger-settings.php`.
- Add `"build:swagger" : "build-swagger-json"` into your app's composer.json scripts section.

    ```
    "scripts": {
        "post-install-cmd": "App\\Console\\Installer::postInstall",
        "post-create-project-cmd": "App\\Console\\Installer::postInstall",
        "check": [
            "@test",
            "@cs-check"
        ],
        "cs-check": "phpcs --colors -p  src/ tests/",
        "cs-fix": "phpcbf --colors -p src/ tests/",
        "stan": "phpstan analyse",
        "test": "phpunit --colors=always",
                "build:openapi": "openapi -b ./vendor/autoload.php --output /srv/docs/openapi.yml ./src"  // addPlugin('Bake');
        } catch (MissingPluginException $e) {
            // Do not halt if the plugin is missing
        }

        $this->addPlugin('Migrations');

        // Load more plugins here
        $this->addPlugin('OpenApiTheme');  // Add this line
    }

```

Usage example
-------------

[](#usage-example)

### bake controller

[](#bake-controller)

```
$ bin/cake bake open_api_controller Articles --prefix Api

```

### bake model

[](#bake-model)

```
$ bin/cake bake open_api_model Articles

```

### create swagger.json

[](#create-swaggerjson)

```
$ composer build:swagger

```

Baked example
-------------

[](#baked-example)

A baked example of the [CakePHP CMS Tutorial](https://book.cakephp.org/4/en/tutorials-and-examples/cms/installation.html) can be found in the [example directory](example/).

- [Swagger UI example](https://petstore.swagger.io/?url=https://raw.githubusercontent.com/kaz29/cakephp-open-api-theme-plugin/master/example/swagger.json)

Author
------

[](#author)

Kazuhiro Watanabe - cyo \[at\] mac.com - [https://twitter.com/kaz\_29](https://twitter.com/kaz_29)

License
-------

[](#license)

OpenApiTheme plugin for CakePHP is licensed under the MIT License - see the LICENSE file for details

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance42

Moderate activity, may be stable

Popularity33

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor1

Top contributor holds 97.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~84 days

Total

19

Last Release

401d ago

PHP version history (4 changes)1.0.0PHP &gt;=7.2

1.1.0PHP &gt;=8.1

1.2.0PHP &gt;=8.4

1.2.1PHP &gt;=8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/63869?v=4)[Kaz Watanabe](/maintainers/kaz29)[@kaz29](https://github.com/kaz29)

---

Top Contributors

[![kaz29](https://avatars.githubusercontent.com/u/63869?v=4)](https://github.com/kaz29 "kaz29 (43 commits)")[![yuki-yasumura-hb](https://avatars.githubusercontent.com/u/181074113?v=4)](https://github.com/yuki-yasumura-hb "yuki-yasumura-hb (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kaz29-cakephp-open-api-theme-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/kaz29-cakephp-open-api-theme-plugin/health.svg)](https://phpackages.com/packages/kaz29-cakephp-open-api-theme-plugin)
```

###  Alternatives

[dereuromark/cakephp-ide-helper

CakePHP IdeHelper Plugin to improve auto-completion

1902.3M39](/packages/dereuromark-cakephp-ide-helper)[dereuromark/cakephp-tools

A CakePHP plugin containing lots of useful and reusable tools

336972.2k49](/packages/dereuromark-cakephp-tools)[cakedc/cakephp-phpstan

CakePHP plugin extension for PHPStan.

42776.5k46](/packages/cakedc-cakephp-phpstan)[dereuromark/cakephp-dto

A CakePHP plugin for generating immutable Data Transfer Objects with full type safety

3096.0k5](/packages/dereuromark-cakephp-dto)[dereuromark/cakephp-setup

A CakePHP plugin containing lots of useful management tools

35184.7k2](/packages/dereuromark-cakephp-setup)[dereuromark/cakephp-calendar

A CakePHP plugin to easily create calendars.

1674.7k1](/packages/dereuromark-cakephp-calendar)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
