What are the best practices for declaring functions in PHP?

When declaring functions in PHP, it is best practice to follow a consistent naming convention, use descriptive names that reflect the function's purpose, and include proper documentation in the form of comments. Additionally, it is recommended to define the function before calling it to avoid any errors.

// Example of declaring a function with proper naming convention and documentation
/**
 * This function 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($num1, $num2) {
    return $num1 + $num2;
}

// Calling the function
$result = calculateSum(5, 3);
echo $result; // Output: 8