PHP hexdec 函數的基本用法詳解

gitbox 2025-05-29

在PHP 中， hexdec()是一個非常實用的函數，它的主要作用是將十六進製字符串轉換為十進制整數。這個函數常用於處理顏色代碼、網絡數據、加密哈希值等涉及十六進製表示的場景。

本文將詳細介紹hexdec()函數的語法、參數、返回值，並通過多個實例進行解析，幫助你更好地掌握這個函數的使用。

一、hexdec() 函數語法

hexdec(string $hex_string): int|float

參數說明：

$hex_string ：要被轉換的十六進製字符串。該字符串可以帶有前綴0x ，也可以不帶，大小寫字母均可接受。

返回值：

返迴轉換後的十進制整數（若值超過PHP int 類型最大範圍，返回float 類型）。

二、基本使用示例

示例1：簡單的十六進制轉十進制

<?php
echo hexdec("1A"); // 輸出 26
?>

這個例子中， "1A"是一個十六進制數，轉換成十進制就是26。

示例2：帶有前綴的十六進制

<?php
echo hexdec("0xFF"); // 輸出 255
?>

hexdec()可以自動識別帶有0x前綴的格式，因此輸出為255。

示例3：轉換包含字母的十六進製字符串

<?php
echo hexdec("C0FFEE"); // 輸出 12648430
?>

該例中C0FFEE是一個典型的"彩蛋" 十六進製字符串，轉換為十進制為12648430。

三、配合其他函數使用

在實際開發中， hexdec()往往與其他函數配合使用，例如將RGB 顏色代碼轉換為十進制數。

示例4：將網頁顏色代碼拆分為RGB 分量

<?php
$hexColor = "#33CC99";
$r = hexdec(substr($hexColor, 1, 2));
$g = hexdec(substr($hexColor, 3, 2));
$b = hexdec(substr($hexColor, 5, 2));

echo "R: $r, G: $g, B: $b"; // 輸出 R: 51, G: 204, B: 153
?>

在這個示例中，我們將一個十六進制顏色值#33CC99拆分為三個部分，並分別轉換為十進制RGB 值。

四、處理大數字的注意事項

當你使用hexdec()轉換非常大的十六進制數字時，返回結果可能是float類型。請注意在需要精確整數值的場景中進行類型判斷或使用GMP 等擴展庫。

示例5：大數值轉換

<?php
$bigHex = "FFFFFFFF";
echo hexdec($bigHex); // 輸出 4294967295
?>

五、實際應用場景舉例

示例6：將MAC 地址中的十六進制段轉為十進制

<?php
$mac = "00:1A:2B:3C:4D:5E";
$segments = explode(":", $mac);
$decSegments = array_map('hexdec', $segments);
print_r($decSegments);
// 輸出 Array ( [0] => 0 [1] => 26 [2] => 43 [3] => 60 [4] => 77 [5] => 94 )
?>

這種轉換常見於網絡設備管理和數據分析中。

六、與URL 處理結合使用的例子

假設你在網站gitbox.net上處理十六進制形式的查詢參數，比如：

 https://gitbox.net/color.php?hex=FF9900

你可以用如下方式解析參數並輸出RGB 值：

 <?php
$hex = $_GET['hex'] ?? '000000';
$r = hexdec(substr($hex, 0, 2));
$g = hexdec(substr($hex, 2, 2));
$b = hexdec(substr($hex, 4, 2));

echo "RGB: ($r, $g, $b)";
?>

當用戶訪問https://gitbox.net/color.php?hex=FF9900時，輸出將為：

 RGB: (255, 153, 0)

結語

hexdec()是一個簡潔卻強大的工具，在處理顏色、網絡地址、加密數據等場景時都非常有用。掌握它可以讓你在處理十六進制數據時更加高效、準確。在結合其他字符串處理函數使用時， hexdec()能大大提升你的PHP 開發能力。

hexdec