Are there best practices for defining return values in PHP functions to ensure readability and consistency?

When defining return values in PHP functions, it is important to establish best practices for readability and consistency. One approach is to clearly document the expected return type and format in the function's comments. Additionally, using PHP's type declarations for return values can help enforce consistency and make the code more readable. Finally, following a consistent naming convention for return values can also improve code clarity.

/**
 * Function that calculates the sum of two numbers
 *
 * @param int $num1 The first number
 * @param int $num2 The second number
 * @return int The sum of the two numbers
 */
function calculateSum(int $num1, int $num2): int {
    return $num1 + $num2;
}