Download the PHP package szykra/resource-naming-strategy without Composer
On this page you can find all versions of the php package szykra/resource-naming-strategy. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package resource-naming-strategy
Resource Naming Strategy
Resource Naming Strategy for Doctrine ORM
Why Resource?
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).
Requirements
This package uses icanboogie/inflector
and it requires a mbstring php extension.
Instalation
Install via composer
Add dependecy to your composer.json
file and run composer update
.
Usage
Usage with Doctrine
Usage with Symfony
You have a two ways to use this naming strategy
Register bundle in AppKernel.php
Just open your AppKernel.php
file and register new symfony bundle which contains a service definition.
Now you can configure Doctrine in config.yml
to use new naming strategy.
Define your own service
If you don't want to register additional bundles you can create own service definiton in services.yml
:
And don't forget to configure Doctrine to use this service.
Mapping
Entity to table name
Lowercase and plural
Entity | Table |
---|---|
User | users |
Category | categories |
TaskActivity | task_activities |
Property to column name
Lowercase letters and words separated by the underscore
Property | Column |
---|---|
firstName | first_name |
LastName | last_name |
secondRememberToken | second_remember_token |
Embedded field to column name
Lowercase letters and words separated by the underscore
Property from embedded Address |
Column |
---|---|
street | address_street |
postcode | address_postcode |
addressLineOne | address_address_line_one |
Join column name
Lowercase letters and words separated by the underscore with _id suffix
Property | Column |
---|---|
reporter | reporter_id |
task_activity | task_activity_id |
Join table name
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 |
License
The MIT License. Copyright © 2015 - 2020 Szymon Krajewski.