Return values in PHP - Deep Dive

Overview - Return values

What is it?

Return values are the results that a function sends back after it finishes running. When you call a function, it can do some work and then give you a value to use later. This value is called the return value. It helps you get information out of the function to use elsewhere in your program.

Why it matters

Without return values, functions would only do tasks but never give you any results to use. This would make programs less flexible and harder to build because you couldn't get answers or data from your functions. Return values let you write reusable code that produces useful outputs, making your programs smarter and more organized.

Where it fits

Before learning return values, you should understand what functions are and how to call them. After mastering return values, you can learn about more advanced topics like passing arguments by reference, error handling with exceptions, and building complex data flows between functions.

Mental Model

Core Idea

A return value is the answer a function gives back after doing its job, like handing you a finished product.

Think of it like...

Imagine you ask a friend to bake a cake. The cake your friend gives you after baking is like the return value — the result you get after their work.

┌───────────────┐
│   Function    │
│  (does work)  │
└──────┬────────┘
       │
       ▼
┌───────────────┐
│ Return Value  │
│ (the answer)  │
└───────────────┘

Build-Up - 7 Steps

1

Foundation

What is a return value?

Concept: Introduce the idea that functions can send back a result after running.

Result

8

Understanding that functions can produce outputs lets you use their results elsewhere, making your code more useful.

2

Foundation

Using return values in variables

Concept: Show how to store a function's return value in a variable for later use.

Result

Hello!

Storing return values in variables allows you to reuse the function's output multiple times or manipulate it further.

3

Intermediate

Returning different data types

🤔Before reading on: do you think functions can only return numbers, or can they return other types like text or arrays? Commit to your answer.

Concept: Functions can return any type of data, not just numbers.

1 [1] => 2 [2] => 3 ) ?>

Result

Array ( [0] => 1 [1] => 2 [2] => 3 )

Knowing that return values can be any data type expands how you design functions and what they can provide.

4

Intermediate

Multiple return statements

🤔Before reading on: if a function has multiple return statements, do you think it runs all of them or stops at the first one? Commit to your answer.

Concept: A function stops running as soon as it hits a return statement and sends back that value.

0) { return 'Positive'; } return 'Non-positive'; } echo checkNumber(5); // Outputs Positive ?>

Result

Positive

Understanding that return ends function execution helps you control the flow and output precisely.

5

Intermediate

No return means NULL

Concept: If a function does not have a return statement, it returns NULL by default.

Result

NULL

Knowing the default return value prevents confusion when functions seem to give no output.

6

Advanced

Returning by reference

🤔Before reading on: do you think returning by reference lets you change the original variable outside the function? Commit to your answer.

Concept: Functions can return a reference to a variable, allowing changes to affect the original data.

Result

10

Understanding return by reference unlocks powerful ways to manipulate data without copying it.

7

Expert

Return values and type declarations

🤔Before reading on: do you think PHP forces the return type strictly or allows flexibility? Commit to your answer.

Concept: PHP can enforce the type of return values using type declarations, improving code safety.

Result

42

Knowing how to declare return types helps catch bugs early and makes your code clearer and more reliable.

Under the Hood

When a function runs, PHP creates a new space in memory for it. The return statement tells PHP to stop running the function and send back a value to the place where the function was called. This value is copied or referenced depending on how the function is written. PHP manages this process automatically, cleaning up after the function finishes.

Why designed this way?

Return values were designed to let functions produce results that can be reused, making code modular and easier to maintain. Early programming languages needed a simple way to get answers from functions, so returning a value became a universal pattern. PHP follows this to keep code clear and predictable.

┌───────────────┐
│ Call Function │
└──────┬────────┘
       │
       ▼
┌───────────────┐
│  Run Code     │
│  inside func  │
└──────┬────────┘
       │
       ▼
┌───────────────┐
│ Return Value  │
│ sent back to  │
│ caller        │
└──────┬────────┘
       │
       ▼
┌───────────────┐
│ Use Value     │
│ in caller     │
└───────────────┘

Myth Busters - 4 Common Misconceptions

Quick: Does a function always return the last value it calculates, even without a return statement? Commit to yes or no.

Common Belief: If a function calculates a value, it automatically returns it even without a return statement.

Reality: Functions without a return statement return NULL, not the last calculated value.

Why it matters: Assuming a value is returned without a return statement can cause bugs where your program gets NULL instead of expected data.

Quick: Can a function have more than one return value at the same time? Commit to yes or no.

Common Belief: Functions can return multiple values simultaneously directly.

Reality: Functions return only one value, but that value can be a container like an array holding multiple items.

Why it matters: Expecting multiple direct return values can confuse how to handle outputs and lead to incorrect code.

Quick: Does returning by reference mean the function returns a copy of the variable? Commit to yes or no.

Common Belief: Returning by reference returns a copy of the variable's value.

Reality: Returning by reference returns a link to the original variable, so changes affect the original data.

Why it matters: Misunderstanding this can cause unexpected side effects or bugs when modifying returned values.

Quick: Does PHP always enforce the return type declared in a function? Commit to yes or no.

Common Belief: PHP strictly enforces return types and throws errors if mismatched.

Reality: PHP enforces return types depending on strict typing mode; otherwise, it may allow type coercion.

Why it matters: Not knowing this can lead to subtle bugs or unexpected behavior in type handling.

Expert Zone

1

Return by reference can improve performance by avoiding copying large data but requires careful management to avoid unintended side effects.

2

Using return type declarations helps with static analysis tools and IDEs, improving developer experience and code quality.

3

Functions without explicit return statements returning NULL can be used intentionally to signal 'no result', a pattern sometimes used in error handling.

When NOT to use

Avoid returning by reference when you want to keep data immutable or prevent side effects. Instead, return copies or use value objects. Also, do not rely on implicit NULL returns for important logic; always use explicit return statements for clarity.

Production Patterns

In real-world PHP applications, return values are used to pass data between layers, like from database queries to business logic. Functions often return arrays or objects for complex data. Type declarations and strict typing are increasingly used to catch bugs early. Returning by reference is rare but used in performance-critical code or when managing shared resources.

Connections

Functions

Return values are the output part of functions, completing the input-process-output cycle.

Understanding return values deepens your grasp of how functions transform inputs into usable results.

Variables

Return values are often stored in variables to hold and reuse the function's output.

Knowing how return values and variables work together helps you manage data flow in programs.

Mathematics - Functions

Programming return values mirror mathematical functions that map inputs to outputs.

Seeing return values as outputs of mathematical functions clarifies their role in predictable, repeatable computations.

Common Pitfalls

#1 Expecting a function to return a value without a return statement.

Wrong approach:

Correct approach:

Root cause:

Misunderstanding that PHP functions return NULL by default if no return statement is present.

#2 Trying to return multiple values directly without using an array or object.

Wrong approach:

Correct approach:

Root cause:

Not knowing that PHP functions can only return one value, which can be a container holding multiple items.

#3 Modifying a returned value expecting the original variable to change without returning by reference.

Wrong approach:

Correct approach:

Root cause:

Confusing returning by value with returning by reference and how variable assignment works.

Key Takeaways

Return values let functions send back results that you can use elsewhere in your program.

A function stops running as soon as it hits a return statement and sends that value back.

If a function has no return statement, it returns NULL by default.

Functions can return any type of data, including numbers, text, arrays, or objects.

Returning by reference allows you to modify the original variable outside the function, but use it carefully.