3.0 - ORM Upgrade guide

[davidyell]

Document: http://book.cakephp.org/3.0/en/appendices/orm-migration.html#inflection-rules-updated

Section:

Note
BelongsTo and HasOne associations will use the singular form, while HasMany and BelongsToMany (HABTM) will use plural forms.

This does not seem to be true.

I have setup Questions and Users

// QuestionsTable.php
$this->belongsTo('User');

// UsersTable.php
$this->hasMany('Questions');

$questions = $this->Questions->find()
    ->contain('User')
    ->order(['Questions.created' => 'DESC']);
// Errors with 'Questions is not associated with Users'

I've had to update my relationship to be $this->belongsTo('Users'); and my contain to ->contain('Users')

[markstory]

Yes the property names for the associations are singular, but table associations are always plural.

[davidyell]

Property names as in the viewVars? $questions->user

[lorenzo]

$article->comments Plural
$article->author Singular

[davidyell]

Ahh I see. So the models are always plural as we discussed on irc, but the
plurality changes in the view depending on the table relationship.
I get it :-)
On 5 Apr 2014 10:00, "José Lorenzo Rodríguez" notifications@github.com
wrote:

$article->comments Plural
$article->author Singular

Reply to this email directly or view it on GitHubhttps://github.com//issues/1228#issuecomment-39632800
.

[markstory]

Is there something we could add to the guide to make things clearer?

[davidyell]

For me the confusion was caused by this your entities which I did not associate with the view. Now I understand that the entity is what is set to the view, I know them as viewVars in the Controller.

I would suggest a clearer definition between the model setup and how you access the set data in the view.

The yellow box I would suggest needs to be rewritten to tell users that it refers to the View and not to the Model Table.

[markstory]

@davidyell Does 00b59e6 help?

[davidyell]

I don't think so, but that's because I find 'association entities' to be a confusing name. Perhaps it's better to point people to the Table/Entity documentation?

I do understand what it means now, but I find reading it confusing. I think it's because it's about the Inflector it might be worth just referring to the change between Model and Table/Entity rather than talking about what is contained in the entity. This is because the entity data didn't exist in Cake 2.x, so it's not really a migration type change, but a new thing all together.

Hope this helps.

[davidyell]

Yes, it makes sense to me now, but I had to re-read it a few times and also using what I know now. I guess this specific section isn't here to explain the new ORM parts.