Deprecate MockBuilder::setMockClassName()

[sebastianbergmann]

To reduce complexity inside PHPUnit's test double functionality, MockBuilder::setMockClassName() will be deprecated and then removed:

• soft deprecation in PHPUnit 10.3 (add @deprecated annotation to the method declaration)
• deprecation in PHPUnit 11 (using the method will trigger a deprecation)
• removal in PHPUnit 12

[sebastianbergmann]

Follows #5444.

[davidbyoung]

I have some unit tests where I am generating multiple mocks of the same interface with expectations set, and adding them to a registry that stores them in an associative array by their class names. I was using setMockClassName() because the multiple mocks all were assigned the same class name by PHPUnit, which was preventing them from all being stored within that registry.

Any advice for how I can accomplish what I'm trying to do with this deprecation? Thanks!

[sebastianbergmann]

@davidbyoung Thank you for bringing this up, I had not considered that use case.

[benhurrell]

Sorry to revive a closed issue, but given the above discussion, is setMockClassName still deprecated, and/or will it still be removed in future releases?

[sebastianbergmann]

It will not be deprecated in PHPUnit 10.4 and is currently scheduled for deprecation or removal.