Bundle to visualise doctrine entities graph with yuml in Symfony4
This bundle is based on Marco Pivetta's work for zend doctrine ORM Module and zend developper tools
It uses the yuml.me api to display your project's objects mapping.
Run the composer require onurb/doctrine-yuml-bundle command in your console
Adjust your parameters to personalize the render in config/packages/dev/yuml.yaml, or use annotations as describe bellow
Adjust the route (if you want to add a prefix) in config/routes/dev/yuml.yaml
symfony 3 is not supported since 1.1.6, if you didn't migrate to SF4 yet, use version 1.1.5
- Add this bundle to your project as a composer dependency:
// composer.json
{
// ...
require: {
// ...
"onurb/doctrine-yuml-bundle": "1.1.5"
}
}- Declare the bundle in your application kernel:
// app/AppKernel.php
public function registerBundles()
{
// ...
if (in_array($this->getEnvironment(), array('dev', 'test'))) {
// ...
$bundles[] = new Onurb\Bundle\YumlBundle\OnurbYumlBundle();
}
return $bundles;
}- Add this route in your global routing_dev configuration (with optional prefix)
# app/config/routing_dev.yml
# ...
doctrine_yuml:
resource: "@OnurbYumlBundle/Resources/config/routing.yml"
prefix: /my_prefix/configure access to the yuml route (if you use security of course)
Click on Doctrine icon added in the dev toolbar.
Run the yuml:mappings console command to save the image locally.
Full personalisation for mapping rendering, defining parameters or using Metadatagrapher annotations
Use the parameter file :
# app/config/parameters.yml => symfony 3
# config/packages/dev/yuml.yaml => symfony 4
parameters:
onurb_yuml.extension: svg
# ...Extensions allowed : jpg, png (default), svg, pdf, or json
Use the parameter file :
# app/config/parameters.yml => symfony 3
# config/packages/dev/yuml.yaml => symfony 4
parameters:
onurb_yuml.style: scruffy
# ...Styles allowed : plain (default), boring or scruffy
Use the parameter file :
# app/config/parameters.yml => symfony 3
# config/packages/dev/yuml.yaml => symfony 4
parameters:
onurb_yuml.direction: LR
# ...Directions allowed : LR (left to Right), RL (Right to Left), TB (Top to bottom => default).
Use the parameter file :
# app/config/parameters.yml => symfony 3
# config/packages/dev/yuml.yaml => symfony 4
parameters:
onurb_yuml.scale: huge
# ...Scales allowed : huge, big, normal (default), small or tiny.
Use the parameter file :
# app/config/parameters.yml => symfony 3
# config/packages/dev/yuml.yaml => symfony 4
parameters:
onurb_yuml.show_fields_description: false
# ...this parameter is set to true by default since v1.1
Warning : In Symfony 3, don't forget to also define parameter keys in parameters.yml.dist to avoid symfony update
to clear your parameters
to show only desired classes details if global parameter is set to false :
namespace My\Bundle\Entity
use Onurb\Doctrine\ORMMetadataGrapher\Mapping as Grapher;
/**
* @Grapher\ShowAttributesProperties()
*/
Class MyClass
{
// ...
}And, if set to true (default), you can hide properties for a specific class :
namespace My\Bundle\Entity
use Onurb\Doctrine\ORMMetadataGrapher\Mapping as Grapher;
/**
* @Grapher\HideAttributesProperties()
*/
Class MyClass
{
// ...
} # app/config/parameters.yml => Symfony 3
# config/packages/dev/yuml.yaml => Symfony 4
parameters:
onurb_yuml.colors:
App\Security: red
App\Blog: blue
# ...You can also define colors for classes this way... but it is easier using annotations as described next
Complete list of yuml colors availables here
namespace My\Bundle\Entity
use Onurb\Doctrine\ORMMetadataGrapher\Mapping as Grapher;
/**
* @Grapher\Color("blue")
*/
Class MyClass
{
}You can display specific methods in the graph, using annotations
namespace My\Bundle\Entity
use Onurb\Doctrine\ORMMetadataGrapher\Mapping as Grapher;
// ...
Class MyEntity
{
// ...
/**
* @Grapher\IsDisplayedMethod()
*/
public function myDisplayedMethod()
{
// ...
}
}If you want, you can hide Entity attributes with annotations : using annotation on the class :
/**
* @Grapher\Hidecolumns
*/
MyEntity
{
//[...]
}Or hide a specific secret column you want to hide, using annotation on the Entity column : (it could be usefull to hide you credential logic, or to avoid the display recurrent fields, like created_at, or updated_at in the graph...)
MyEntity
{
/**
* @ORM\Column(/* ... */)
* @Grapher\HiddenColumn
*/
private $secret;
}use annotations :
namespace My\Bundle\Entity
use Onurb\Doctrine\ORMMetadataGrapher\Mapping as Grapher;
/**
* @Grapher\Note("Some information about this class")
*/
Class MyClass
{
}Notes are yellow by default, but you can customize note's' color
/**
* @Grapher\Note(value="Some information about this class", color="blue")
*/
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent