| 函式 | 回傳值 | 參數數量 | 格式化支援 | 主要用途 | 效能 |
|---|---|---|---|---|---|
echo | 無 (void) | 多個 (逗號分隔) | ❌ | 一般輸出、模板輸出、高頻列印 | **最快** |
print | int (永遠 1) | 單一 | ❌ | 需回傳值的表達式中 (極少見) | 略慢於 echo |
printf | int (輸出長度) | 格式字串 + 多參數 | ✅ C 風格格式化 | 格式化輸出 (數字對齊、進位、小數位) | 中等 |
sprintf | string (格式化結果) | 格式字串 + 多參數 | ✅ C 風格格式化 | **取得格式化字串不直接輸出** | 中等 |
var_dump | 無 | 多個 | ✅ 結構化 (型別+長度+值) | **除錯、變數檢視、開發環境** | 慢 (大量資料) |
print_r | bool/string | 1-2 | ✅ 易讀結構 | 除錯陣列/物件、第二參數 true 回傳字串 | 中 |
var_export | bool/string | 1-2 | ✅ 合法 PHP 代碼 | 除錯、產生可 eval 代碼、快取序列化 | 中 |
die/exit | 不回傳 (終止腳本) | 0-1 (字串/整數狀態碼) | ❌ | **緊急停止、錯誤中斷、CLI 狀態碼** | N/A |
<?php
// 多參數 (逗號) - 不會先串接字串,直接依序輸出,效能最佳
echo 'User: ', $name, ', Age: ', $age, '\n';
// 單參數 (括號可選)
echo('Hello World');
echo "Hello $name"; // 雙引號解析變數
// 輸出大量 HTML (Heredoc/Nowdoc)
echo <<
$title
$content
| 格式符 | 說明 | 範例 | 輸出 |
|---|---|---|---|
%d / %i | 有號十進位整數 | printf("%d", 42) | 42 |
%u | 無號十進位整數 | printf("%u", -1) | 4294967295 (32位) |
%f / %F | 浮點數 (區域設定敏感 / 不敏感) | printf("%.2f", 3.14159) | 3.14 |
%e / %E | 科學記號 | printf("%e", 12345) | 1.234500e+4 |
%s | 字串 | printf("%s", "hello") | hello |
%b | 二進位 | printf("%b", 10) | 1010 |
%o | 八進位 | printf("%o", 10) | 12 |
%x / %X | 十六進位 (小寫/大寫) | printf("%X", 255) | FF |
%c | ASCII 字元 | printf("%c", 65) | A |
%% | 字面 % 符號 | printf("100%%") | 100% |
<?php
// 寬度、對齊、填充字元
printf("[%10s]", "hello"); // [ hello] 右對齊
printf("[%-10s]", "hello"); // [hello ] 左對齊
printf("[%010d]", 42); // [0000000042] 零填充
printf("[%'#10s]", "hello"); // [#####hello] 自訂填充字元 '
// 參數交換 (位置指定符) - 適用於 i18n
$fmt = '第 %2$s 個參數是 %1$d';
printf($fmt, 42, '第一'); // 第 第一 個參數是 42
// sprintf 取得字串不輸出
$sql = sprintf("SELECT * FROM %s WHERE id = %d AND status = '%s'",
'users', 123, 'active');
// 產生: SELECT * FROM users WHERE id = 123 AND status = 'active'
<?php
$arr = ['id' => 1, 'tags' => ['php', 'laravel'], 'active' => true];
// var_dump: 型別+長度+值 (最詳細)
var_dump($arr);
/* 輸出:
array(3) {
["id"]=> int(1)
["tags"]=> array(2) { [0]=> string(3) "php" [1]=> string(7) "laravel" }
["active"]=> bool(true)
}
*/
// print_r: 易讀結構 (適合人眼閱讀)
print_r($arr);
/* 輸出:
Array
(
[id] => 1
[tags] => Array ( [0] => php [1] => laravel )
[active] => 1
)
*/
// 取得字串不輸出
$str = print_r($arr, true); // 第二參數 true
// var_export: 合法 PHP 代碼表示 (可 eval/存檔)
$code = var_export($arr, true);
/* 產生:
array (
'id' => 1,
'tags' => array ( 0 => 'php', 1 => 'laravel', ),
'active' => true,
)
*/
<?php
// 1. 輸出訊息並終止 (Web 環境)
if (!$user->isActive()) {
die('帳號已停用,請聯繫管理員');
}
// 2. 僅終止,不輸出 (CLI 回傳狀態碼)
if ($criticalError) {
error_log("Critical: $criticalError");
exit(1); // 非零碼表示異常
}
// 3. 條件性終止 (Guard Clause 模式)
function process(Order $order) {
if ($order->isCancelled()) return; // 提前返回優於 die
if (!$order->validate()) die('驗證失敗'); // 極端情況才用 die
// 正常流程...
}
// 4. 註冊關閉函式 (die/exit 也會觸發)
register_shutdown_function(function() {
$error = error_get_last();
if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR])) {
// 記錄致命錯誤、發送告警
}
});
<?php
// 開啟輸出緩衝
ob_start();
echo "Step 1\n";
// ... 大量輸出 ...
$content = ob_get_clean(); // 取得緩衝內容並關閉緩衝
// 處理後再輸出
echo strtoupper($content);
// 巢狀緩衝
ob_start();
echo "Outer ";
ob_start();
echo "Inner ";
$inner = ob_get_clean();
echo "[$inner] Outer";
$outer = ob_get_clean();
http_response_code(500))。| 寫法 | 耗時 (秒) | 相對 |
|---|---|---|
echo $a, $b, $c; | 0.18 | 1.00x (基準) |
echo $a . $b . $c; | 0.24 | 0.75x |
print $a . $b . $c; | 0.26 | 0.69x |
printf("%s%s%s", $a, $b, $c); | 0.42 | 0.43x |
**結論**:高頻輸出用 echo 多參數逗號分隔,避免字串串接開銷。
**echo 是效能之王**,**sprintf/printf 解決格式化**,**var_dump/print_r/var_export 是除錯三劍客**,**die/exit 是緊急剎車**。根據場景選擇正確工具,並善用輸出緩衝控制輸出時機,能寫出既高效又可維護的 PHP 代碼。