dawen / api-doc-property-bundle
A extension for nelmio api doc bundle to expose properties
Installs: 6 830
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 0
Forks: 1
Open Issues: 0
Type:symfony-bundle
Requires
- php: >=5.5.0
- nelmio/api-doc-bundle: ~2.11
- symfony/framework-bundle: ~2.3|~3.0
Requires (Dev)
- phpunit/phpunit: ~4.8
This package is not auto-updated.
Last update: 2024-11-09 19:19:37 UTC
README
This bundle allows you to expose properties for api documentation that are not handled by json, jms or validator parsers
Installation
Require the dawen/api-doc-property-bundle package in your composer.json and update your dependencies.
$ composer require dawen/api-doc-property-bundle
// app/AppKernel.php public function registerBundles() { return array( // ... new Dawen\Bundle\ApiDocPropertyBundle\ApiDocPropertyBundle(), ); }
Register the bundle in app/AppKernel.php:
Usage And Examples
For defining a property you can add a new annotation to your property
@ApiDocProperty(type="string")
Available properties for setting your informations:
name
Type: string
Description: Name of the property. If this is not set, then the name of the class property will be taken
description
Type: string
Description: This will be set as description for the property
type
Types: all php types, full qualified class name, array<full qualified class name>
Description: The type property has no strict limitation. you can write whatever you want. But keep in mind,
that it appears in the api documentation. There is only some magic for classes and array of objects. This will be parsed recursively
Example for a simple class:
namespace Dawen\Bundle\ApiDocPropertyBundle; use Dawen\Bundle\ApiDocPropertyBundle\Component\Annotation\ApiDocProperty; class Dummy { /** * @ApiDocProperty(type="string") * @var string */ private $firstName; /** * @ApiDocProperty(type="string") * @var string */ private $lastName; /** * @ApiDocProperty(type="int") * @var int */ private $age = 0; /** * @ApiDocProperty(type="Dawen\Bundle\ApiDocPropertyBundle\Address") * @var Dawen\Bundle\ApiDocPropertyBundle\Address */ private $address; /** * @ApiDocProperty(type="array<Dawen\Bundle\ApiDocPropertyBundle\Key>") * @var array */ private $keys = []; /** * @return string */ public function getFirstName() { return $this->firstName; } /** * @param string $firstName */ public function setFirstName($firstName) { $this->firstName = $firstName; } /** * @return string */ public function getLastName() { return $this->lastName; } /** * @param string $lastName */ public function setLastName($lastName) { $this->lastName = $lastName; } /** * @return int */ public function getAge() { return $this->age; } /** * @param int $age */ public function setAge($age) { $this->age = $age; } /** * @return Dawen\Bundle\ApiDocPropertyBundle\Address */ public function getAddress() { return $this->address; } /** * @param Dawen\Bundle\ApiDocPropertyBundle\Address $address */ public function setAddress($address) { $this->address = $address; } /** * @return array */ public function getKeys() { return $this->keys; } /** * @param array $keys */ public function setKeys($keys) { $this->keys = $keys; } }