Description:
------------
---
From manual page: https://php.net/function.assert-options
---

The documentation says that the signature of callback should be

assert_callback(string $file, int $line, string $assertion, string $description)

However, the $assertion will be passed an empty string unless the deprecated syntax is used for the actual assert(). The actual assertion should be always passed as the 3rd parameter.

Note that if first parameter to assert() is a string, the string will be passed as 3rd parameter to the handler. If first parameter is not a string and second parameter is not set, the assert code will be passed as 4th parameter to the handler. If first parameter passed to assert() is not a string and second parameter is a string, the actual assert code will be lost and the string given as the second parameter will be passed as the 4th parameter to the handler.

The behavior seems to have been the same since version 5.4.8. Version 5.4.7 or any older didn't support the second parameter to assert().

The only way to get the expected output with current PHP version is to use deprecated syntax assert(string, string) where both 3rd and 4th parameter passed to assert handler will be correctly set.

I think the behavior of PHP should be changed instead of simply changing the documentation. It really makes zero sense to always pass empty string as the 3rd argument if non-deprecated features are used. (And yeah, I see that sniper@php.net considered this feature-not-a-bug in 2002 - perhaps it's time to reconsider now that the string as the first argument to assert() has been deprecated: https://bugs.php.net/bug.php?id=20075)

Example test also at https://3v4l.org/1G2Zo


Test script:
---------------
<?php
assert_options(ASSERT_CALLBACK, "assert_handler");

function assert_handler($file, $line, $assertion, $description="")
{
  echo "* assert_handler('$file', '$line', '$assertion', '$description') called";
  return true;
}

assert('false == true');
assert(false == true);
assert(false == true, "Expected assert() to fail for this test and emit the actual test as 3rd parameter to handler");

Expected result:
----------------
* assert_handler('/in/1G2Zo', '10', 'false == true', '') called
* assert_handler('/in/1G2Zo', '11', 'false == true', '') called
* assert_handler('/in/1G2Zo', '12', 'false == true', 'Expected assert() to fail for this test and emit the actual test as 3rd parameter to handler') called


Actual result:
--------------
* assert_handler('/in/1G2Zo', '10', 'false == true', '') called
* assert_handler('/in/1G2Zo', '11', '', 'assert(false == true)') called
* assert_handler('/in/1G2Zo', '12', '', 'Expected assert() to fail for this test and emit the actual test as 3rd parameter to handler') called