| dbs@php.net 2006-05-03, 6:59 pm |
| ID: 37290
Updated by: dbs@php.net
Reported By: spam01 at pornel dot net
-Status: Open
+Status: Closed
Bug Type: Documentation problem
Operating System: *
PHP Version: Irrelevant
New Comment:
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.
Thank you for the report, and for helping us make our documentation
better.
Example 2 is now "Example 2. Execute a prepared statement with an array
of insert values (named parameters)".
To address your concern, I added another example: "Example 3. Execute a
prepared statement with an array of insert values (placeholders)".
Previous Comments:
------------------------------------------------------------------------
[2006-05-03 15:11:28] spam01 at pornel dot net
Example 2 contains only associative array vs named parameters, so it
doesn't show how indexes of '?' are handled.
The only example that uses '?' placeholders is #3, which uses bindParam
starting from 1.
I find these examples irrelevant to the case, if not confusing.
------------------------------------------------------------------------
[2006-05-03 15:05:14] dbs@php.net
"Example 2. Execute a prepared statement with an array of insert
values" demonstrates how to pass an input array.
Writing about how bindParam takes 1-based indexes for arguments, while
the input array to PDOStatement::execute() takes a 0-based index, is
just going to confuse users. Less is more, and examples rule.
------------------------------------------------------------------------
[2006-05-03 12:06:56] spam01 at pornel dot net
Description:
------------
http://php.net/manual/en/function.p...ent-execute.php
PDOStatement::execute() may accept input array with parameters, but
docs doen't specify how this array is used.
This is important, because bindParam oddly expects indexes starting
from 1 and it looks that execute() expects different indexing, starting
from 0.
Also invalid indexes seem to be ignored. Is this intended behavior?
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=37290&edit=1
|