This bundle provides commands to intuitively generate code inside Symfony-based projects.
- Handles all Doctrine2 column types.
- Handles all Doctrine2 association types (OneToOne, OneToMany, ManyToOne, ManyToMany).
- Handles unidirectional and bidirectional associations.
- Auto-detect association mappings when generating an Entity already targetted by other entities.
- Handles all Doctrine2 metadata drivers (annotations, yaml, xml, php).
The bundle provides a command that will start an entity generation from the mappping informations of an existing entity. It is then possible to edit or add fields and associations before the entity is regenerated from scratch.
This same command can be used to regenerate an entity in a different mapping configuration format.
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
$ composer require --dev remg/generator-bundle dev-master
This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.
Then, enable the bundle by adding
new Remg\GeneratorBundle\RemgGeneratorBundle() to the list of registered
bundles for the dev environment in the app/AppKernel.php
file of your
project:
// app/AppKernel.php
// ...
class AppKernel extends Kernel
{
public function registerBundles()
{
// ...
if (in_array($this->getEnvironment(), ['dev', 'test'])) {
$bundles[] = new Remg\GeneratorBundle\RemgGeneratorBundle();
// ...
}
}
// ...
}
The bundle comes with a default configuration, which is listed below. You can define these options in your configuration if you need to change them:
remg_generator:
entity:
# available configuration formats are: 'annotation', 'yaml', 'xml' and 'php'.
configuration_format: annotation
Since this bundle is only useful in command line interface, you can override the
bundle configuration in your development configuration in
app/config/config_dev.yml
.
You can now generate new Doctrine2 entities using the command below:
$ php bin/console remg:generate:entity
You can also regenerate Doctrine2 entities from scratch using the command below:
$ php bin/console remg:regenerate:entity
NOTE: Since this bundle can only generate code, and not manipulate existing code, this command will regenerate the entity from scratch without implementing any custom code that could live in the existing entity.
No code can be lost. Each file generation checks if the target file already exists, and creates a timestamped backup of the file before generation.
- Repository generation.
- Entity edition.
- CRUD generation (handling embed form collections).
This bundle is under the MIT license. See the complete license in the bundle.