propelorm/Propel — Issue #237: [Propel 1.6.2-dev] Documentation is insufficient about findPK.
Author: inkworks
Created: 2011-12-17 02:56:30+00:00
State: open

I love working with Propel, but sometimes the documentation keeps me bugging on something that should be referred to easily.
For example: findPK accepts one argument, but what if you have multiple primary keys in your table structure?
Propel's basic CRUD docs mention the following:

"When the primary key consists of more than one column, `findPK()` accepts multiple parameters, one for each primary key column."

But that's not true! It accepts an array where each element is a primary key column. When entering multiple arguments, Propel throws a catchable fatal error which states it expects argument to to be of type PropelPDO. You'd think: a smart guy would figure out: try an array! But being one not prone to hacking around, I have to know things for sure, so I searched the source code to find a comment section above the findPk function where it is explained.

If there's a proper documentation about Propel out there somewhere, please tell me. I've done numerous Google searches, but no lock whatsoever.