Declare strict_types directive in PHP

Introduction

The declare(strict_types=1); directive makes PHP check the exact types of values passed to functions. This helps catch mistakes early and keeps your code safer.

When you want to make sure functions only get the exact type of data they expect.

When working on a team project to avoid confusion about what types are allowed.

When you want to find bugs caused by wrong data types quickly.

When writing code that needs to be very reliable and predictable.

When learning PHP and wanting to understand how types work clearly.

Syntax

PHP

<?php
declare(strict_types=1);

// Your PHP code here

This directive must be the very first statement in the PHP file, before any other code or whitespace.

It only affects type checking for function calls in the same file.

Examples

This example uses strict types so add only accepts integers exactly.

PHP

<?php
declare(strict_types=1);

function add(int $a, int $b): int {
    return $a + $b;
}

echo add(5, 10);

Without declare(strict_types=1);, PHP converts "10" to 10 automatically.

PHP

<?php

function add(int $a, int $b): int {
    return $a + $b;
}

// Without strict_types, this works:
echo add(5, "10");

Sample Program

This program multiplies two numbers. Because of strict types, both must be floats exactly. The commented line shows what happens if types are wrong.

PHP

<?php
declare(strict_types=1);

function multiply(float $x, float $y): float {
    return $x * $y;
}

// Correct types
echo multiply(2.5, 4.0) . "\n";

// Incorrect type - this will cause a TypeError
// echo multiply(2, "3");

Important Notes

If you forget to put declare(strict_types=1); at the top, PHP will not check types strictly.

Strict types only affect scalar types like int, float, string, and bool.

Type errors caused by strict types help you find bugs early.

Summary

declare(strict_types=1); makes PHP check exact types for function calls.

Put it at the very top of your PHP file before any code.

It helps catch bugs and makes your code safer and clearer.

Practice

1. What does the declare(strict_types=1); directive do in a PHP file?

easy

A. It enables automatic type conversion for function arguments.

B. It disables all error reporting in the PHP script.

C. It sets the default timezone for the script.

D. It forces PHP to check that function arguments match their declared types exactly.

Solution

1. Step 1: Understand the purpose of strict_types

   The directive declare(strict_types=1); tells PHP to enforce exact type matching for function arguments and return values.

2. Step 2: Compare with other options

   Options B, C, and D describe unrelated PHP features: error reporting, timezone setting, and type conversion, which are not controlled by this directive.

3. Final Answer:

   It forces PHP to check that function arguments match their declared types exactly. -> Option D

4. Quick Check:

   strict_types enforces exact type checks = A [OK]

Hint: Strict types means exact argument types only [OK]

Common Mistakes:

• Thinking it disables errors
• Confusing with timezone settings
• Assuming it enables type coercion

2. Which of the following is the correct way to enable strict types in a PHP file?

easy

A.

B.

C.

D.

Solution

1. Step 1: Check correct syntax for declare directive

   The correct syntax is declare(strict_types=1); placed at the top of the PHP file.

2. Step 2: Analyze each option

   <?php declare(strict_types=1); ?> uses the exact correct syntax. Options A and B use invalid PHP syntax. <?php declare(strict_types = true); ?> uses true instead of 1, which is invalid for this directive.

3. Final Answer:

   <?php declare(strict_types=1); ?> -> Option C

4. Quick Check:

   declare(strict_types=1) is correct syntax = C [OK]

Hint: Use declare(strict_types=1); at file top [OK]

Common Mistakes:

• Using true instead of 1
• Trying to assign strict_types as a variable
• Calling a non-existent function

3. Given this PHP code with strict types enabled:

<?php
declare(strict_types=1);
function add(int $a, int $b): int {
    return $a + $b;
}
echo add(5, '3');
?>

What will be the output?

medium

A. TypeError: Argument 2 passed must be of the type int, string given

B. 8

C. 53

D. Warning: Implicit conversion from string to int

Solution

1. Step 1: Understand strict_types effect on function calls

   With declare(strict_types=1);, PHP requires exact types. Passing a string '3' to a parameter typed as int causes an error.

2. Step 2: Predict the runtime behavior

   PHP throws a TypeError because the second argument is a string, not an int, and no automatic conversion happens.

3. Final Answer:

   TypeError: Argument 2 passed must be of the type int, string given -> Option A

4. Quick Check:

   strict_types=1 + wrong argument type = TypeError [OK]

Hint: Strict types cause TypeError on wrong argument types [OK]

Common Mistakes:

• Assuming PHP converts string '3' to int automatically
• Expecting output 8 or 53
• Confusing warning with error

4. Identify the error in this PHP code snippet:

<?php
function multiply(int $x, int $y): int {
    return $x * $y;
}

declare(strict_types=1);
echo multiply(4, 5);
?>

medium

A. The declare(strict_types=1); must be at the top before any code.

B. The function multiply must return a string, not int.

C. The function parameters should not have types declared.

D. There is no error; the code runs fine.

Solution

1. Step 1: Check position of declare(strict_types=1);

   The strict_types directive must be declared at the very top of the PHP file, before any code or whitespace.

2. Step 2: Analyze the code order

   Here, the function is declared before the strict_types directive, which is invalid and causes the directive to be ignored or cause an error.

3. Final Answer:

   The declare(strict_types=1); must be at the top before any code. -> Option A

4. Quick Check:

   declare(strict_types=1) must be first line = B [OK]

Hint: Put declare(strict_types=1); at file very top [OK]

Common Mistakes:

• Placing declare after code or functions
• Thinking return type must be string
• Removing type declarations from parameters

5. You want to write a PHP function that accepts only integers and returns their sum. You also want to ensure no accidental type coercion happens anywhere in the file. How should you set up your PHP file?

hard

A. Use no type declarations and rely on PHP's automatic type conversion.

B. Place declare(strict_types=1); at the top, then define the function with int types.

C. Use declare(strict_types=0); and define the function with int types.

D. Define the function with int types but do not use declare(strict_types=1);

Solution

1. Step 1: Enable strict types at the file start

   To prevent type coercion, add declare(strict_types=1); at the very top of the PHP file.

2. Step 2: Define the function with int type hints

   Declare the function parameters and return type as int to enforce integer-only usage.

3. Final Answer:

   Place declare(strict_types=1); at the top, then define the function with int types. -> Option B

4. Quick Check:

   strict_types=1 + int types = strict integer enforcement [OK]

Hint: Use declare(strict_types=1); plus int type hints [OK]

Common Mistakes:

• Skipping declare(strict_types=1);
• Using declare(strict_types=0); which allows coercion
• Not adding type hints in function