Use ignore_user_abort() when you need to gets or sets whether script execution continues after a client disconnects in a PHP application. The examples below show the actual operation and its limitations.
What Is ignore_user_abort() in PHP?
Gets or sets whether script execution continues after a client disconnects. The exact signature supported by your installation depends on its PHP version and enabled extensions.
Its syntax is:
ignore_user_abort(?bool $enable = ...): int
Parameters and return value: The parameter types, optional arguments, references, and return type are shown in the signature above. Optional parameters are marked with an ellipsis in this reference signature.
Example 1: Basic Usage
<?php
var_dump(is_int(ignore_user_abort()));
Result: Run the example in an environment that supports the function. Any values depending on operating-system state, installed extensions, process configuration, or network access must be checked on the target server.
Example 2: Different Input or Behavior
<?php
$previousSetting = ignore_user_abort(true); echo ignore_user_abort() ? "Continue" : "Stop"; ignore_user_abort($previousSetting);
Result: Run the example in an environment that supports the function. Any values depending on operating-system state, installed extensions, process configuration, or network access must be checked on the target server.
Practical Example: Applying the Function
<?php
$previousSetting = ignore_user_abort(); ignore_user_abort(true); echo "Disconnect handling enabled"; ignore_user_abort($previousSetting);
Result: Run the example in an environment that supports the function. Any values depending on operating-system state, installed extensions, process configuration, or network access must be checked on the target server.
Important Behavior and Edge Cases
This does not remove server, proxy, or worker time limits and is not a job queue.
Comparison With Related Functions
| Approach | Difference |
|---|---|
ignore_user_abort() | Gets or sets whether script execution continues after a client disconnects. |
| Related operation | set_time_limit() adjusts PHP execution time; ignore_user_abort() handles disconnections. |
Common Beginner Mistakes
| Mistake | Correct Approach |
|---|---|
| Ignoring the function-specific limitation | This does not remove server, proxy, or worker time limits and is not a job queue. |
| Confusing this function with a related operation | set_time_limit() adjusts PHP execution time; ignore_user_abort() handles disconnections. |
Key Takeaways
- Gets or sets whether script execution continues after a client disconnects.
- This does not remove server, proxy, or worker time limits and is not a job queue.
- set_time_limit() adjusts PHP execution time; ignore_user_abort() handles disconnections.
Use ignore_user_abort() for the specific operation demonstrated above. Check its prerequisites and handle failure conditions before using it with production data.