Resource Naming Strategy for Doctrine ORM
This naming strategy following the natural way of thinking about entities and resources. Imagine that you have one Flower. It's single entity. You want to store some data about flowers e.g. in your database. It's resource.
Simple? I know resource named flower sounds easier but sometimes it's more confusing. In the end, you have a lot of flowers, not one.
This strategy is similar to the Laravel naming convention (See mapping section).
This package uses icanboogie/inflector
and it requires a mbstring php extension.
Add dependecy to your composer.json
file and run composer update
.
"require": {
"szykra/resource-naming-strategy": "~0.1"
}
$namingStrategy = new \Szykra\NamingStrategy\ResourceNamingStrategy();
$configuration()->setNamingStrategy($namingStrategy);
You have a two ways to use this naming strategy
Just open your AppKernel.php
file and register new symfony bundle which contains a service definition.
$bundles = array(
...
new Szykra\NamingStrategy\ResourceNamingBundle\ResourceNamingBundle()
);
Now you can configure Doctrine in config.yml
to use new naming strategy.
doctrine:
orm:
naming_strategy: szykra.naming_strategy.resource_naming_strategy
If you don't want to register additional bundles you can create own service definiton in services.yml
:
services:
app.naming_strategy.resource:
class: Szykra\NamingStrategy\ResourceNamingStrategy
And don't forget to configure Doctrine to use this service.
Lowercase and plural
Entity | Table |
---|---|
User | users |
Category | categories |
TaskActivity | task_activities |
Lowercase letters and words separated by the underscore
Property | Column |
---|---|
firstName | first_name |
LastName | last_name |
secondRememberToken | second_remember_token |
Lowercase letters and words separated by the underscore
Property from embedded Address |
Column |
---|---|
street | address_street |
postcode | address_postcode |
addressLineOne | address_address_line_one |
Lowercase letters and words separated by the underscore with _id suffix
Property | Column |
---|---|
reporter | reporter_id |
task_activity | task_activity_id |
Two singular lowercase entity names in ascending order with words separated by the underscore
Entity 1 | Entity 2 | Table |
---|---|---|
User | Task | task_user |
Comment | Post | comment_post |
Work | TimeLog | time_log_work |
The MIT License. Copyright © 2015 - 2020 Szymon Krajewski.