Defining Custom Functions: Modular Programming in PHP

Previously in this course, we covered mastering foreach loops to handle collections of data. Now that you can iterate over complex structures, it’s time to stop writing "script-style" code where everything happens in one long file.

In this lesson, we will focus on modular programming by encapsulating logic into reusable functions. This is the cornerstone of writing professional, maintainable backend services.

Why Use Functions?

If you find yourself copy-pasting the same snippet of code—like formatting a date or calculating a tax percentage—three or more times, you have a design problem. Functions solve this by giving a name to a block of code, allowing you to "call" it whenever you need that specific logic performed.

Beyond just saving keystrokes, functions allow you to test logic in isolation and keep your main execution flow clean.

Defining Your First Function

A function in PHP starts with the function keyword, followed by a name, parentheses for parameters, and curly braces for the code body.

PHP
function greetUser(string $name): string {
    return "Hello, " . $name . "!";
}

echo greetUser("Alice"); #6A9955">// Outputs: Hello, Alice!

Parameters and Return Values

Functions are most useful when they can accept input and provide output.

• Parameters: Variables defined in the parentheses that act as placeholders for data you pass in.
• Return Values: The return keyword sends a value back to the caller. Note that once a return statement executes, the function stops immediately—any code after it will not run.

Understanding Function Scope

One of the most common "gotchas" for beginners is scope. Variables defined inside a function are "local" to that function. They don't exist outside of it, and they cannot see variables defined in your main script (the "global" scope).

PHP
$prefix = "Mr.";

function sayHello($name) {
    #6A9955">// This will error or fail because $prefix is not accessible here
    return "Hello, " . $prefix . " " . $name;
}

If you need to use data from outside the function, you must pass it in as an argument. This makes your functions "pure" and predictable, as they don't rely on hidden external state.

Worked Example: A Formatting Utility

In our running MVC project, you’ll frequently need to format currency or prices. Let’s create a reusable function for this.

PHP
#6A9955">/**
 * Formats a price with a standard prefix.
 */
function formatPrice(float $amount, string $currencySymbol = '$'): string {
    return $currencySymbol . number_format($amount, 2);
}

#6A9955">// Usage in your "view" logic:
$productPrice = 1250.5;
echo "The total is: " . formatPrice($productPrice);

By defining this function, if your business requirement changes (e.g., you need to change the decimal precision), you only change the code in one place.

Hands-on Exercise

Create a new file named calculator.php. Write a function called calculateTax that takes two parameters: a float $subtotal and a float $taxRate (defaulting to 0.05). The function should return the total amount including tax. Call this function with different values and echo the results.

Common Pitfalls

1. Defining functions inside loops: While PHP allows this, it is bad practice. Define your functions at the top of your file or in a separate file that you include.
2. Naming collisions: Function names cannot be redefined. If you are building a large app, consider using namespaces, which we will cover in a later lesson.
3. Forgetting the return: If you omit return but try to assign the function call to a variable, that variable will be null.
4. Mixing logic and output: Avoid echo inside functions if you want to reuse them. Instead, return the value and let the caller decide whether to echo it, log it, or save it to a database.

FAQ

Q: Can I return multiple values? A: PHP functions can only return one value. However, you can return an associative array if you need to pass back multiple related pieces of data.

Q: What happens if I don't provide a value for a parameter? A: If you set a default value in the function signature (like $currencySymbol = '$'), the function will use that default if the caller provides nothing.

Q: Are functions case-sensitive? A: Function names are case-insensitive in PHP, but it is standard practice to use camelCase and always call them using the exact name you defined.

Recap

You have now moved beyond simple scripting into modular programming. By using functions, you've learned to:

• Encapsulate logic to prevent code duplication.
• Pass data into functions via parameters.
• Capture results using the return statement.
• Respect variable scope to avoid bugs.

These tools are essential for the next step in our project: organizing our files so they don't become a tangled mess.

Up next: Project Structure Strategy