Improve message

Author: sebastianbergmann

ChangeLog-12.5.md

@@ -2,6 +2,12 @@
 
 All notable changes of the PHPUnit 12.5 release series are documented in this file using the [Keep a CHANGELOG](https://keepachangelog.com/) principles.
 
+## [12.5.3] - 2025-MM-DD
+
+### Changed
+
+* The message emitted when a test method creates a mock object but does not configure any expectations for it has been improved
+
 ## [12.5.2] - 2025-12-08
 
 ### Added
@@ -26,6 +32,7 @@ All notable changes of the PHPUnit 12.5 release series are documented in this fi
 * [#6380](https://github.com/sebastianbergmann/phpunit/pull/6380): Allow `Throwable` in `expectExceptionObject()`
 * A PHPUnit notice is now emitted for test methods that create a mock object but do not configure an expectation for it
 
+[12.5.3]: https://github.com/sebastianbergmann/phpunit/compare/12.5.2...12.5
 [12.5.2]: https://github.com/sebastianbergmann/phpunit/compare/12.5.1...12.5.2
 [12.5.1]: https://github.com/sebastianbergmann/phpunit/compare/12.5.0...12.5.1
 [12.5.0]: https://github.com/sebastianbergmann/phpunit/compare/12.4.5...12.5.0

src/Framework/TestCase.php

@@ -1408,7 +1408,8 @@ private function verifyMockObjects(): void
  $this->testValueObjectForEvents,
  sprintf(
  'No expectations were configured for the mock object for %s. ' .
- 'You should refactor your test code and use a test stub instead.',
+ 'Consider refactoring your test code to use a test stub instead. ' .
+ 'The #[AllowMockObjectsWithoutExpectations] attribute can be used to opt out of this check.',
  $mockObject['type'],
  ),
  );

tests/end-to-end/event/mock-object-created-with-MockBuilder-without-expectations.phpt

@@ -25,7 +25,7 @@ Test Suite Started (TestFixture\PHPUnit\Event\MockBuilderWithoutExpectationsTest
 Test Preparation Started (TestFixture\PHPUnit\Event\MockBuilderWithoutExpectationsTest::testOne)
 Test Prepared (TestFixture\PHPUnit\Event\MockBuilderWithoutExpectationsTest::testOne)
 Test Triggered PHPUnit Notice (TestFixture\PHPUnit\Event\MockBuilderWithoutExpectationsTest::testOne)
-No expectations were configured for the mock object for PHPUnit\TestFixture\Event\Example. You should refactor your test code and use a test stub instead.
+No expectations were configured for the mock object for PHPUnit\TestFixture\Event\Example. Consider refactoring your test code to use a test stub instead. The #[AllowMockObjectsWithoutExpectations] attribute can be used to opt out of this check.
 Test Passed (TestFixture\PHPUnit\Event\MockBuilderWithoutExpectationsTest::testOne)
 Test Finished (TestFixture\PHPUnit\Event\MockBuilderWithoutExpectationsTest::testOne)
 Test Suite Finished (TestFixture\PHPUnit\Event\MockBuilderWithoutExpectationsTest, 1 test)

tests/end-to-end/event/mock-object-created-with-createMock-without-expectations.phpt

@@ -26,7 +26,7 @@ Test Preparation Started (TestFixture\PHPUnit\Event\CreateMockWithoutExpectation
 Test Prepared (TestFixture\PHPUnit\Event\CreateMockWithoutExpectationsTest::testOne)
 Mock Object Created (PHPUnit\TestFixture\Event\Example)
 Test Triggered PHPUnit Notice (TestFixture\PHPUnit\Event\CreateMockWithoutExpectationsTest::testOne)
-No expectations were configured for the mock object for PHPUnit\TestFixture\Event\Example. You should refactor your test code and use a test stub instead.
+No expectations were configured for the mock object for PHPUnit\TestFixture\Event\Example. Consider refactoring your test code to use a test stub instead. The #[AllowMockObjectsWithoutExpectations] attribute can be used to opt out of this check.
 Test Passed (TestFixture\PHPUnit\Event\CreateMockWithoutExpectationsTest::testOne)
 Test Finished (TestFixture\PHPUnit\Event\CreateMockWithoutExpectationsTest::testOne)
 Test Suite Finished (TestFixture\PHPUnit\Event\CreateMockWithoutExpectationsTest, 1 test)

tests/end-to-end/event/mock-object-created-with-createPartialMock-without-expectations.phpt

@@ -26,7 +26,7 @@ Test Preparation Started (TestFixture\PHPUnit\Event\CreatePartialMockWithoutExpe
 Test Prepared (TestFixture\PHPUnit\Event\CreatePartialMockWithoutExpectationsTest::testOne)
 Partial Mock Object Created (PHPUnit\TestFixture\Event\Example)
 Test Triggered PHPUnit Notice (TestFixture\PHPUnit\Event\CreatePartialMockWithoutExpectationsTest::testOne)
-No expectations were configured for the mock object for PHPUnit\TestFixture\Event\Example. You should refactor your test code and use a test stub instead.
+No expectations were configured for the mock object for PHPUnit\TestFixture\Event\Example. Consider refactoring your test code to use a test stub instead. The #[AllowMockObjectsWithoutExpectations] attribute can be used to opt out of this check.
 Test Passed (TestFixture\PHPUnit\Event\CreatePartialMockWithoutExpectationsTest::testOne)
 Test Finished (TestFixture\PHPUnit\Event\CreatePartialMockWithoutExpectationsTest::testOne)
 Test Suite Finished (TestFixture\PHPUnit\Event\CreatePartialMockWithoutExpectationsTest, 1 test)