PHP fprintf()函数用法讲解
概述
在PHP中，<?php ... ?> 代码块内的格式化输出功能非常常用，其中 fprintf() 函数可以将格式化字符串写入到指定的文件流中。它与 printf() 类似，区别在于 printf() 直接输出到标准输出，而 fprintf() 将结果写入文件或网络流等资源句柄。
函数定义
fprintf() 的函数原型如下：
int fprintf(resource $stream, string $format [, mixed $args [, mixed $... ]])
$stream：目标资源句柄，例如由
fopen()打开的文件指针或网络连接。$format：格式化字符串，支持占位符与转义序列。
$args：可变参数列表，用于替换
$format中的占位符。返回值：成功时返回写入的字符数，失败时返回
FALSE。
格式化占位符说明
在 $format 中可使用以下常见占位符：
| 占位符 | 含义 | 示例 |
|---|---|---|
| %s | 字符串 | %s 表示以字符串形式输出变量 |
| %d | 十进制整数 | %d 用于输出整数值 |
| %f | 浮点数 | %.2f 保留两位小数 |
| %c | 单个字符 | %c 输出对应 ASCII 字符 |
| %b | 二进制整数 | %b 将整数转为二进制表示 |
| %x | 十六进制小写 | %x 以小写字母输出十六进制 |
| %X | 十六进制大写 | %X 以大写字母输出十六进制 |
基本用法示例
示例1：写入文本文件
以下示例演示如何将数据格式化后写入本地文件：
$filename = 'output.txt';
$file = fopen($filename, 'w');
if ($file) {
$name = 'Alice';
$age = 30;
$written = fprintf($file, '姓名：%s，年龄：%d' . PHP_EOL, $name, $age);
echo '写入字符数：' . $written . PHP_EOL;
fclose($file);
} else {
echo '无法打开文件' . PHP_EOL;
}执行后，output.txt 文件内容为：姓名：Alice，年龄：30
示例2：写入带格式的浮点数
控制小数位数常用于金额或精度数据：
$fp = fopen('data.txt', 'w');
$price = 1234.5678;
fprintf($fp, '价格：%.2f 元' . PHP_EOL, $price);
fclose($fp);文件 data.txt 内容为：价格：1234.57 元
示例3：写入多种数据类型
可以混合使用不同类型的占位符：
$handle = fopen('mixed.txt', 'w');
fprintf($handle, '编号：%04d，标识：%X，状态：%s' . PHP_EOL, 25, 255, '正常');
fclose($handle);mixed.txt 内容为：编号：0025，标识：FF，状态：正常
注意事项
必须保证
$stream是以写入模式打开的有效资源句柄，否则会触发警告并返回FALSE。格式化字符串应与后续参数类型匹配，否则可能产生意外结果或错误。
使用
fprintf()时建议配合fopen()的适当模式，如 w（覆盖写入）、a（追加写入）等。若需输出到标准输出，可直接使用
printf()；若需写入特定流，则选用fprintf()。
与类似函数的区别
PHP提供多个格式化输出函数，其差异主要在输出目标：
printf()：直接输出到标准输出（通常是浏览器或终端）。sprintf()：返回格式化后的字符串，不直接输出。vfprintf()：接受数组作为参数列表，适用于动态参数场景。fprintf()：将格式化结果写入指定流，兼具灵活性与定向输出能力。
应用场景
fprintf() 常用于日志记录、数据导出、配置文件生成等需要结构化写入文件的任务。例如，将用户信息批量写入 CSV 或自定义格式的文本文件，或者向网络套接字发送格式化协议数据。
在实际项目中，如果需要将分析结果按固定模板保存至 https://www.ipipp.com/logs/report.txt，可利用 fprintf() 实现高效且可控的写入操作。总结
fprintf() 是PHP中强大的格式化写入工具，能够结合丰富的占位符精确控制输出形态，并将结果定向到文件、网络或其他流资源。掌握其用法有助于提升数据持久化与输出的灵活性和可维护性。