Mastering Doctrine Relationships in Symfony

In the part 1 of the Doctrine Tutorial we got a sweet setup with Doctrine: entities, queries, migrations and fixtures.

But, we left out one big piece: database relations. Once you've mastered these, you'll be unstoppable. Unfortunately, a lot of information out there make Doctrine relations look over-complicated. Actually, they're simple and beautiful. Sure, they have some pitfalls - but they'll also help you build a complex data structure in no time.

  • ManyToOne relationships (associations)
  • The OneToMany side of a relation
  • The downfall of owning versus inverse sides of a relation
  • Doing magic with the ArrayCollection
  • Querying with Joins

... and more - like some magic with the "Param Conversion".


Your Guides

Ryan Weaver Leanna Pelham

Questions? Conversation?

  • 2016-11-13 Shairyar Baig

    Many thanks Ryan, this drove me crazy for hours. I ended up changing the method name but it makes sense and i now renamed the property. As always many thanks for the explanation. I will check out the tutorial as well.

  • 2016-11-13 weaverryan

    Hey Shairyar!

    Short answer: we're covering this in *depth* right now on the new collections tutorial: https://knpuniversity.com/scre...

    Longer answer: This is a problem with pluralization. Let me give you a different example: imagine the OneToMany was on a property called products. Then, you would also have a products field on your form. With this setup, the form system will try to call addProduct() and removeProduct() when you submit your form. If you have the right setup, this all ends up being really cool (that's what we cover in the new tutorial).

    But in your case, your field is "user_address", and this property holds an array of "Address" objects. This should *really* be called "user_addresses" - since it holds *many* addresses. Since your property name is singular, the form system is confused - it thinks that the actual word is "user_addres" and that you are making it plural with "user_address" (with 2 s). So, it tries to call addUserAddres and removeUserAddres, instead of addUserAddress() and removeUserAddress().

    To fix it, do one of the following:
    1) Rename your property from user_address to user_addresses
    2) Rename your add/remover to addUserAddres and removeUserAddres (which is kinda crazy)

    Let me know if this helps! The error is telling you which methods it's trying to call.

    Cheers!

  • 2016-11-12 Shairyar Baig

    Hi Ryan,

    I cant seem to understand oneToMany add and remove function names that get generated when you create the relationship

    I have an entity `User` and `Address` and they share a oneToMany relationship


        oneToMany:
    user_address:
    targetEntity: AppBundle\Entity\Address
    mappedBy: address_user
    cascade: ["persist"]

    manyToOne:
    address_user:
    targetEntity: AppBundle\Entity\User
    inversedBy: user_address


    When I ran the command `doctrine:generate:entities` it created the add and remove function in User Entity

    I then created a FormType as following

     public function buildForm(FormBuilderInterface $builder, array $options)
    {
    $builder
    ->add('name')
    ->add('user_address', CollectionType::class, array(
    'entry_type' => AddressType::class,
    'allow_add' => true,
    'by_reference' => false,
    'error_bubbling' => false,
    ))
    ;
    }

    On submitting this form I kept on getting the following error

    `Neither the property "user_address" nor one of the methods "addUserAddres()"/"removeUserAddres()", "setUserAddress()", "userAddress()", "__set()" or "__call()" exist and have public access in class "AppBundle\Entity\User".`

    I dont understand why is it looking for a method name addUserAddres() instead of addUserAddress()

    Note: generating entity seems to be adding single word in `Addres` rather than `Address` for the add and remove method in User entity. I added another 's' in these method names and things started working fine.

    Whats going on here?

  • 2016-10-11 Victor Bocharsky

    Hey Robert,

    I think there're a lot of ways to do that, but probably cache the whole rendered template is more appropriate here. We have a chapter about it: check out the Fragments, ESI and Caching . But keep in mind, that the cached template with ESI - is another request (sub-request) to your application. It covered in that chapter.

    Cheers!

  • 2016-10-11 Robert Bitschnau

    Well now i got another question :P

    I want to cache a result or even better a part of the template. The thing is if i cache the entity i can't access the getCategory (reference to antoher entity) if i load it from the cache. I want to prevent the database queries. And idk how to use the esi in this case.

    My goal is to display 6 different entitys which changes every 15 minutes.
    The most viewed, the 'featuered' and so on

    Thanks in advance

  • 2016-10-10 weaverryan

    Sweet! Keep killing it!

  • 2016-10-09 Robert Bitschnau

    Hello Ryan,

    Thanks it worked.

    This site is still the best resource to learn symfony

  • 2016-10-08 weaverryan

    Hey Robert!

    Do you happen to have two circular relationships between the two tables in question? I mean, like a ManyToOne from Game to Category and also some other relationship (e.g. ManyToOne or OneToOne) from Category to Game? Alice actually *should* delete things in the correct order: it calculates that by looking at the relationships. But, if you have 2 tables that both relate to each other, there's no "right" order that would make things work. In that case, you need to add some onDelete="" (e.g. CASCADE, or SET NULL) behavior to the ORM\JoinColumn annotation to one of the relationships so that the records can be deleted in the database without the db throwing a constraint.

    Let me know if that describes your situation!

    Cheers!

  • 2016-10-07 Robert Bitschnau

    [PDOException]
    SQLSTATE[23000]: Integrity constraint violation: 1451 Cannot delete or update a parent row: a foreig
    n key constraint fails (`root`.`game`, CONSTRAINT `FK_232B318C12469DE2` FOREIGN KEY (`category
    _id`) REFERENCES `category` (`id`))

    How should I deal with this?
    It happens when i try to load the fixtures from alices. Alice deletes the tables in the wrong order. Is there a way to control this behaivor?

  • 2016-09-20 weaverryan

    I just started on the tutorial today :). But, that still means that it's anywhere from 3-6 weeks away from the release schedule. So, not too long now :)

  • 2016-09-20 Hermen

    Getting anxcious...

  • 2016-09-01 Hermen

    Thanks!

  • 2016-08-23 weaverryan

    Haha, you're going to make it very easy to make sure we hit all the right topics for the tutorial :). Thanks for the continued input!

  • 2016-08-23 Hermen

    I had thought it would be something along those lines. Thanks for your feedback and also the tip about the bundle. I'll definitely look into it.

  • 2016-08-22 Victor Bocharsky

    Hey Hermen,

    For nice URLs, you simple should add a new *unique* string column in your DB table, i.e. "slug" or "alias" which will contain this pretty nice part of URL. And since it is unique, you could query entity by this slug instead of ID. And of course, in your route use "/news/{slug}" where you'll pass an entity slug to generate a valid route instead of "/news/{id}". The only problem - you should use only valid characters in your slugs and avoid such as "?", "#", etc. Thanks to the bundles, there're already a couple of third-party libs which help with generating a slug for Doctrine entities. Probably, the most popular is the "StofDoctrineExtensionsBundle" which has a lot of DoctrineExtensions's features includes a Sluggable one. So check it out.

    Cheers!

  • 2016-08-20 Hermen

    And how to put all this information, from the Many, the One and the other Many, on the screen in a single page...

  • 2016-08-20 Hermen

    And, but you probably have this on the role already, when using a ManyToOne with separate joining entity (so, not a real ManyToMany, but a ManyToOne/OneToMany/ManyToOne), how to update that. You even might have ment that in your last sentence, but English is not my first language and neither is Symfony...

  • 2016-08-20 Hermen

    And while your at it, but this may be completely off (this) topic, nice URL's and getting stuff from the database. Example: When following the tutorials, a route is created, e.g. \news\watch-our-great-tutorial-about-manytomany. But, if I want to fetch that article from a database, I probably need to use something like \news\2345 where 2345 is the id of that news item. Or is there something out there that lets me fetch that article and show the nice URL?

  • 2016-08-16 weaverryan

    Yes, you bring up a valid point :). I rarely use ManyToMany because of this: I almost always use ManyToOne with an extra entity because it gives me the extra flexibility immediately. And yes, if you want fields like dateCreated, then you would need the extra entity even for these fields. That's why I don't often use ManyToMany. But, we'll still do a tutorial on it, and more about the really hard parts of OneToMany/ManyToOne - things like the owning/inverse side that you were asking about.

    Cheers!

  • 2016-08-16 Hermen

    Ah, yes. I forgot, I read that somewhere. Maybe you could go into why not always use that solution even of there are no extra fields. By the way, the extra fields, does that include the 'record meta data' like "dateCreated" and "dateModified"?

  • 2016-08-15 weaverryan

    Thanks Hermen! The topic about updating from both sides is very important - this will probably be the most important part of the tutorial :). About the "extra data", I will also mention this, because it's really important. But, the answer is simple: if your join table needs even *one* extra field, then you should no longer use a ManyToMany relationship. Instead, you should build a new entity that will join the other two. For example, suppose you have a ManyToMany between Product and Category. If you need some extra field on the join table, then you need to create a new ProductCategory entity, which will have a ManyToOne to Product and a ManyToOne to Category. A true ManyToMany only works if there are *no* extra fields.

    And thanks again for the details!

  • 2016-08-12 Hermen

    How to go about it (how to set it up) one way and both ways (like OneToMany and ManyToOne), how to update a page with both sides ('main form' and 'sub form'), how to go about a many to many with extra data in the joining table. Like: I want to catalog my DVD's with movie title, synopsis, year released and rating (like Motion picture rating system which in my country holds more ratings, see https://en.wikipedia.org/wiki/... so this is ManyToMany) and the main actors with their role in the movie (ManyToMany with extra data).

    Hope you can make anything out of this.

  • 2016-08-11 weaverryan

    Sorry about that - it obviously got pushed back beyond July. But, we'll be starting this tutorial very soon (like, next on my list). So, while I have you - is there anything specifically that's confusing? I'll be putting together the list of things to cover - want to make sure I hit everything important!

    Cheers!

  • 2016-08-11 Maciek

    Hi,

    Any news according to "ManyToMany" relationship?

  • 2016-06-15 weaverryan

    Hey Hermen!

    I've added it to the schedule for July, but as an "extra" - we will do a few other casts in July before it. So, I can't promise July, but we'll do our best!

    Cheers!

  • 2016-06-15 Hermen

    Anything on the schedule yet *wishfull thinking*?

  • 2016-06-10 Shairyar Baig

    yes thats what i ended up doing writing a custom query :)

  • 2016-06-08 weaverryan

    Hi Baig!

    Hmm, I'm not sure - I don't fully understand the data model. If there is a Request and I accept it, then I understand that this creates a ManyToMany between my User and the Request. But *before* I accept this Request, how is the Request linked to the User? I'm not sure about this part.

    But in general, when you have complex queries like this where ultimately you just need a "count" of something, I often write the query in SQL first (and test it in phpmyadmin or something similar). Then, I write that same query in DQL / the query builder.

    Cheers!

  • 2016-06-07 Shairyar Baig

    Hi Ryan,

    I have a question. Suppose I have 2 entities `User` and `Request` and they are linked with each other in `manyToMany`

    Now the scenario is that I can also accept the request and you can also accept the same request and accepting the request creates the `manyToMany`

    So now lets suppose there are total of 3 requests out of which I have accepted 2 and you have accepted 3

    How on front end can we display the user the "Total number of requests" and "Total number of request accepted" and "total number of request that are pending to be accepted".

    Suppose in controller I have this


    $em = $this->getDoctrine()->getManager();

    //get all dinners to be listed as upcoming dinners in view
    $allRequests = $em->getRepository('AppBundle:Requests')->findAll();


    return $this->render('AppBundle::requests.html.twig', array(
    'allRequests' => $allRequests,
    ));

    And inside twig i have


    Here I would like to display the counts "Total Received", "Total Accepted" and "Total Pending"
    {% for requests in allRequests %}

    {{ request.name}}

    ...
    ...
    ...

    {% endfor %}

    How can this be achieved.

    Regards,
    Baig

  • 2016-04-19 weaverryan

    It's not currently on the schedule, so it will likely *not* come out in the next 3-6 months. However, if we have more people ask for it, that might change :).

  • 2016-04-18 Maciek

    When should we expect "ManyToMany" course?

  • 2016-03-23 Hermen

    I'll be waiting for it!

  • 2016-03-20 weaverryan

    Ah, a power user - very nice find :D

  • 2016-03-20 weaverryan

    Hey Hermen! We decided to save ManyToMany for its own small tutorial - it's got some special aspects we can cover, like removing items and form collections. I want to get that all *just* right - because they can be a real joy to work with :)

  • 2016-03-20 Jonathan Keen

    You guys certainly know how to make addicts want more... ;) I can't tell you how often I come here to look for new tutorials to absorb. I'm even guilty of browsing to see when you sometimes publish the notes before the videos...which is what I was just doing.

  • 2016-03-20 Hermen

    Looking forward to these. Will you be dealing with ManyToMany also?