How to Properly Use the round() Function in PHP? A Complete Guide to the Basics

gitbox 2025-08-23

In PHP, the round() function is commonly used to round floating-point numbers to a specified precision. It’s not only useful for rounding values but also allows flexibility in controlling the number of decimal places retained. This article provides a detailed explanation of the basic usage of the round() function, common techniques, and important considerations to help you use the function more effectively.

1. Basic Syntax of round()

The basic syntax of the round() function is as follows:

<span><span><span class="hljs-title function_ invoke__">round</span></span><span>(</span><span><span class="hljs-keyword">float</span></span><span> </span><span><span class="hljs-variable">$value</span></span>, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$precision</span></span><span> = </span><span><span class="hljs-number">0</span></span>, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$mode</span></span> = PHP_ROUND_HALF_UP): </span><span><span class="hljs-keyword">float</span></span><span>
</span></span>

$value: Required, the floating-point number to process.
$precision: Optional, specifies the number of decimal places to keep after rounding. Default is 0, which returns an integer.
$mode: Optional, specifies the rounding mode. PHP provides several options.

2. Basic Examples

Example 1: Simple Rounding

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">round</span></span>(</span><span><span class="hljs-number">3.14159</span></span>);  </span><span><span class="hljs-comment">// Output 3</span></span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">round</span></span>(</span><span><span class="hljs-number">3.5</span></span>);      </span><span><span class="hljs-comment">// Output 4</span></span>
</span><span><span class="hljs-meta">?&gt;</span></span>
</span></span>

In this example, we didn’t specify $precision or $mode. By default, PHP rounds the floating-point number to the nearest integer.

Example 2: Specifying Decimal Places

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">round</span></span>(</span><span><span class="hljs-number">3.14159</span></span>, </span><span><span class="hljs-number">2</span></span>);  </span><span><span class="hljs-comment">// Output 3.14</span></span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">round</span></span>(</span><span><span class="hljs-number">3.14159</span></span>, </span><span><span class="hljs-number">3</span></span>);  </span><span><span class="hljs-comment">// Output 3.142</span></span>
</span><span><span class="hljs-meta">?&gt;</span></span>
</span></span>

By setting the $precision parameter, you can define how many decimal places to keep. In the examples above, the first result keeps two decimals, while the second keeps three.

3. Rounding Modes

The round() function in PHP provides four rounding modes:

PHP_ROUND_HALF_UP: Round halves up (default).
PHP_ROUND_HALF_DOWN: Round halves down.
PHP_ROUND_HALF_EVEN: Banker’s rounding (round half to even).
PHP_ROUND_HALF_ODD: Round half to odd.

Example 3: Using Different Modes

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span> <span><span class="hljs-title function_ invoke__">round</span></span>(3.5, 0, PHP_ROUND_HALF_UP);   </span><span><span class="hljs-comment">// Output 4</span></span>
</span><span><span class="hljs-keyword">echo</span></span> <span><span class="hljs-title function_ invoke__">round</span></span>(3.5, 0, PHP_ROUND_HALF_DOWN); </span><span><span class="hljs-comment">// Output 3</span></span>
</span><span><span class="hljs-keyword">echo</span></span> <span><span class="hljs-title function_ invoke__">round</span></span>(2.5, 0, PHP_ROUND_HALF_EVEN); </span><span><span class="hljs-comment">// Output 2</span></span>
</span><span><span class="hljs-keyword">echo</span></span> <span><span class="hljs-title function_ invoke__">round</span></span>(3.5, 0, PHP_ROUND_HALF_ODD);  </span><span><span class="hljs-comment">// Output 3</span></span>
</span><span><span class="hljs-meta">?&gt;</span></span>
</span></span>

This example demonstrates how different modes control rounding behavior. Each mode serves different needs, especially in financial and accounting scenarios.

4. Avoiding Unnecessary Floating-Point Errors

When working with floating-point numbers, precision errors often occur. The round() function helps reduce such issues. For instance, floating-point calculations may show unexpected results due to inaccuracies.

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span> <span><span class="hljs-title function_ invoke__">round</span></span>(0.1 + 0.2, 1);  </span><span><span class="hljs-comment">// Output 0.3</span></span>
</span><span><span class="hljs-meta">?&gt;</span></span>
</span></span>

Although adding 0.1 and 0.2 in computing may introduce a slight error, using round() ensures the result is accurate.

5. Use Cases

The round() function is widely applied in many scenarios, especially when precision is required. Common use cases include:

Financial calculations: For example, rounding monetary values, usually to two decimal places.
Scientific calculations: Precision is often critical to avoid cumulative errors.
Data presentation: Rounded results help display statistical data clearly and understandably.

6. Notes

Rounding negative numbers: The round() function applies the same rules when working with negative values.

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span> <span><span class="hljs-title function_ invoke__">round</span></span>(-3.14159, 2);  </span><span><span class="hljs-comment">// Output -3.14</span></span>
</span><span><span class="hljs-keyword">echo</span></span> <span><span class="hljs-title function_ invoke__">round</span></span>(-3.5);         </span><span><span class="hljs-comment">// Output -4</span></span>
</span><span><span class="hljs-meta">?&gt;</span></span>
</span></span>

Boundary values: When a number is exactly at the midpoint (e.g., 0.5), the result depends on the selected rounding mode.

Conclusion

The round() function in PHP is a powerful tool for precisely handling floating-point numbers. By setting precision and choosing appropriate rounding modes, you can ensure accurate results in calculations and presentations. Mastering the use of round() can greatly improve code quality and help avoid common floating-point issues.

round