Union types in PHP 8 allow variables to accept or return multiple types. They are declared using the | symbol between types, such as int|string, and can be used for function parameters, return values, and class properties (as of PHP 8.2). For example, a function can return either an integer or string with function getStatusCode(): int|string. Union types improve type safety while offering flexibility over loose typing or comments. They should be used when a value logically supports multiple types, like optional null returns (User|null) or handling different input formats (string|array). Avoid using union types when unsure—use mixed instead. Inside functions, use is_*() or instanceof checks to handle logic based on the actual type, ensuring safer and clearer code execution.
Union types in PHP 8 allow a function or method parameter, return value, or class property to accept or return more than one type. This means instead of restricting a variable to a single type like int
or string
, you can specify that it can be either one type or another.
For example, if a function can return either an integer or a string depending on context, you can now explicitly declare that with union types:
function getStatusCode(): int|string { // returns either an int or a string }
This feature improves type safety while giving developers more flexibility without relying on comments or loose typing.
Declaring Union Types
You declare union types by separating the allowed types with a vertical bar (|
). This syntax works for parameters, return types, and properties:
Function parameters:
function logData(string|int $data): void { // accepts either a string or an int }
Return types:
function fetchValue(): float|bool { // returns either a float or a boolean }
Class properties (PHP 8.2 ):
class Example { public string|int $value; }
If the value doesn’t match any of the specified types at runtime, PHP will throw a TypeError
.
When to Use Union Types
Use union types when a value logically has more than one valid type. Common scenarios include:
Optional values that might be
null
function findUser(int $id): User|null { // returns a User object or null }
Functions that handle multiple input formats
function parseInput(string|array $input): array { // accepts a JSON string or an array }
Mixed data structures where strict typing isn't practical but some level of control is still needed
Avoid using them just because you're unsure of the type — that's what mixed
is for. Use union types when you know exactly which types are acceptable.
Handling Type Checks
Even though PHP enforces union types at runtime, you’ll often want to check the actual type inside your function logic. You can use is_*()
functions or instanceof
as needed:
function processValue(int|string $value): void { if (is_int($value)) { echo "Got an integer: $value"; } else { echo "Got a string: '$value'"; } }
Some tips:
- Always validate the type before performing operations specific to one type
- Consider returning early or throwing exceptions if an unexpected type slips through
- Use
match
orget_debug_type()
in more complex cases to improve readability
Type checks help avoid bugs and make your code clearer, especially when different logic applies based on the actual type.
That’s basically how union types work in PHP 8. They give you more precision without losing flexibility, and they’re pretty straightforward once you get used to the syntax.
The above is the detailed content of What are union types in PHP 8?. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

Common problems and solutions for PHP variable scope include: 1. The global variable cannot be accessed within the function, and it needs to be passed in using the global keyword or parameter; 2. The static variable is declared with static, and it is only initialized once and the value is maintained between multiple calls; 3. Hyperglobal variables such as $_GET and $_POST can be used directly in any scope, but you need to pay attention to safe filtering; 4. Anonymous functions need to introduce parent scope variables through the use keyword, and when modifying external variables, you need to pass a reference. Mastering these rules can help avoid errors and improve code stability.

To safely handle PHP file uploads, you need to verify the source and type, control the file name and path, set server restrictions, and process media files twice. 1. Verify the upload source to prevent CSRF through token and detect the real MIME type through finfo_file using whitelist control; 2. Rename the file to a random string and determine the extension to store it in a non-Web directory according to the detection type; 3. PHP configuration limits the upload size and temporary directory Nginx/Apache prohibits access to the upload directory; 4. The GD library resaves the pictures to clear potential malicious data.

There are three common methods for PHP comment code: 1. Use // or # to block one line of code, and it is recommended to use //; 2. Use /.../ to wrap code blocks with multiple lines, which cannot be nested but can be crossed; 3. Combination skills comments such as using /if(){}/ to control logic blocks, or to improve efficiency with editor shortcut keys, you should pay attention to closing symbols and avoid nesting when using them.

AgeneratorinPHPisamemory-efficientwaytoiterateoverlargedatasetsbyyieldingvaluesoneatatimeinsteadofreturningthemallatonce.1.Generatorsusetheyieldkeywordtoproducevaluesondemand,reducingmemoryusage.2.Theyareusefulforhandlingbigloops,readinglargefiles,or

The key to writing PHP comments is to clarify the purpose and specifications. Comments should explain "why" rather than "what was done", avoiding redundancy or too simplicity. 1. Use a unified format, such as docblock (/*/) for class and method descriptions to improve readability and tool compatibility; 2. Emphasize the reasons behind the logic, such as why JS jumps need to be output manually; 3. Add an overview description before complex code, describe the process in steps, and help understand the overall idea; 4. Use TODO and FIXME rationally to mark to-do items and problems to facilitate subsequent tracking and collaboration. Good annotations can reduce communication costs and improve code maintenance efficiency.

In PHP, you can use square brackets or curly braces to obtain string specific index characters, but square brackets are recommended; the index starts from 0, and the access outside the range returns a null value and cannot be assigned a value; mb_substr is required to handle multi-byte characters. For example: $str="hello";echo$str[0]; output h; and Chinese characters such as mb_substr($str,1,1) need to obtain the correct result; in actual applications, the length of the string should be checked before looping, dynamic strings need to be verified for validity, and multilingual projects recommend using multi-byte security functions uniformly.

ToinstallPHPquickly,useXAMPPonWindowsorHomebrewonmacOS.1.OnWindows,downloadandinstallXAMPP,selectcomponents,startApache,andplacefilesinhtdocs.2.Alternatively,manuallyinstallPHPfromphp.netandsetupaserverlikeApache.3.OnmacOS,installHomebrew,thenrun'bre

TolearnPHPeffectively,startbysettingupalocalserverenvironmentusingtoolslikeXAMPPandacodeeditorlikeVSCode.1)InstallXAMPPforApache,MySQL,andPHP.2)Useacodeeditorforsyntaxsupport.3)TestyoursetupwithasimplePHPfile.Next,learnPHPbasicsincludingvariables,ech
