hamichen / doctrine2-exporter
MySQL Workbench Schema Exporter for Doctrine 2
Installs: 1 029
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 1
Open Issues: 2
Requires
- php: >=5.4.0
- hamichen/mysql-workbench-schema-exporter: 3.0.8
This package is not auto-updated.
Last update: 2024-10-30 10:42:39 UTC
README
This is an exporter to convert MySQL Workbench Models (*.mwb) to a Doctrine 2 Schema.
Prerequisites
- PHP 5.4+
- Composer to install the dependencies
Installation
php composer.phar require --dev mysql-workbench-schema-exporter/doctrine2-exporter
This will install the exporter and also require mysql-workbench-schema-exporter.
You then can invoke the CLI script using vendor/bin/mysql-workbench-schema-export
.
Formatter Setup Options
Additionally to the common options of mysql-workbench-schema-exporter these options are supported:
Common Setup Options for Doctrine 2.0:
-
useAutomaticRepository
Automatically generate entity repository class name.
-
bundleNamespace
The global namespace prefix for entity class name.
-
entityNamespace
The entity namespace.
Default is
Entity
. -
repositoryNamespace
The namespace prefix for entity repository class name. For this configuration to apply,
useAutomaticRepository
must be set totrue
. -
skipColumnWithRelation
Don't generate columns definition (for YAML) or columns variable and columns getter and setter (for Annotation) which has relation to other table.
Default is
false
. -
relatedVarNameFormat
The format for generated related column name.
Default is
%name%%related%
. -
nullableAttribute
How nullable attribute of columns and joins is generated. Set to
auto
if you want to automatically include nullable attribute based on its value. Set toalways
to always include nullable attribute.Default is
auto
. -
generatedValueStrategy
The stragety for auto-generated values.
Default is
auto
. -
defaultCascade
The default cascade option to define.
Default is
false
.
Doctrine 2.0 YAML Schema
Setup Options
-
extendTableNameWithSchemaName
Include schema name beside the table name.
Default is
false
.
Doctrine 2.0 Annotation
Setup Options
-
useAnnotationPrefix
Doctrine annotation prefix.
Default is
ORM\
. -
skipGetterAndSetter
Don't generate columns getter and setter.
Default is
false
. -
generateEntitySerialization
Generate method
__sleep()
to include only real columns when entity is serialized.Default is
true
. -
generateExtendableEntity
Generate two class for each tables in schema, one for base and one other for extend class. The extend class would not be generated if it already exist. So it is safe to place custom code inside the extend class.
This option will generate entity using Single Table Inheritance.
Default is
false
. -
quoteIdentifierStrategy
This option determine wheter identifier quoting is applied or not, depend on the strategy value.
auto
, indentifier quoting enabled if identifier is a reserved word.always
, always quote identifier.none
, never quote identifier.
Default is
auto
. -
extendsClass
This option allows you to define a base class from which all generated entities extend.
Default is
''
. -
propertyTypehint
This option allows you to specify whether type-hinting should be enabled for all non-scalar properties whose type is a class. E.g.
\DateTime
would be type-hinted but notobject
orstring
.Default is
false
.
Model Comment Behavior
-
{d:bundleNamespace}AcmeBundle{/d:bundleNamespace}
(applied to Table)Override
bundleNamespace
option. -
{d:m2m}false{/d:m2m}
(applied to Table)MySQL Workbench Schema Exporter tries to automatically guess which tables are many-to-many mapping tables and will not generate entity classes for these tables.
A table is considered a mapping table, if it contains exactly two foreign keys to different tables and those tables are not many-to-many mapping tables.
Sometimes this guessing is incorrect for you. But you can add a hint in the comment of the table, to show that it is no mapping table. Just use
{d:m2m}false{/d:m2m}
anywhere in the comment of the table. -
{d:unidirectional}true{/d:unidirectional}
(applied to ForeignKey)All foreign keys will result in a bidirectional relation by default. If you only want a unidirectional relation, add a flag to the comment of the foreign key.
-
{d:owningSide}true{/d:owningSide}
(applied to ForeignKey)In a bi-directional many-to-many mapping table the owning side of the relation is randomly selected. If you add this hint to one foreign key of the m2m-table, you can define the owning side for Doctrine.
-
{d:cascade}persist, merge, remove, detach, all{/d:cascade}
(applied to ForeignKey)You can specify Doctrine cascade options as a comment on a foreign key. They will be generated into the Annotation. (Reference)
-
{d:fetch}EAGER{/d:fetch}
(applied to ForeignKey)You can specify the fetch type for relations in the comment of a foreign key. (EAGER or LAZY, doctrine default is LAZY)
-
{d:orphanRemoval}true{/d:orphanRemoval}
(applied to ForeignKey)Another option you can set in the comments of foreign key. (Reference)
-
{d:order}column{/d:order}
(applied to ForeignKey)Apply OrderBy annotation to One To Many and Many To Many relation. OrderBy annotation can be written in the following format:
column[,(asc|desc)]
Multiple columns are supported, separated by line break. Example usage:
{d:order} column1 column1,desc {/d:order}
Doctrine 2.0 Annotation with ZF2 Input Filter Classes
Doctrine 2.0 Annotation with ZF2 Input Filter Classes formatter directly extend Doctrine 2.0 Annotation. The setup options and model comment behavior exactly the same as Doctrine 2.0 Annotation with the following addons.
Setup Options
-
generateEntityPopulate
Generate
populate()
method for entity class.Default is
true
. -
generateEntityGetArrayCopy
Generate
getArrayCopy()
method for entity class.Default is
true
.
Command Line Interface (CLI)
See documentation for mysql-workbench-schema-exporter