告别传统传真：那些年我们踩过的“坑”
还记得那些年，为了收发一份重要的合同或文件，你可能需要：
- 找到一台尚能工作的传真机。
- 确保有足够的纸张和墨粉。
- 手动拨号，等待漫长的连接。
- 小心翼翼地放入文件，祈祷传真能顺利发送。
- 接收传真时，可能还要担心纸张用完，或者传真机繁忙导致漏收。
这些步骤不仅效率低下，而且在需要批量发送或接收传真时，简直是噩梦。纸质文档的堆积也给后续的归档、检索和与现有业务系统集成带来了巨大的障碍。在追求效率和数字化的今天，这种传统模式显然已经力不从心。我们急需一个现代化的解决方案，能够将传真功能融入到我们的应用程序中，实现自动化、可追溯和无纸化。
解决方案登场：Composer 与 InterFAX 库
在 PHP 的世界里，当我们遇到需要集成外部服务或复杂功能时，Composer 总是我们最得力的助手。它让依赖管理变得前所未有的简单和高效。而对于传真自动化，interfax/interfax 库就是那个能将我们从传真“泥潭”中解救出来的强大工具。
interfax/interfax 是 InterFAX REST API 的 PHP 客户端库，它允许你通过编写 PHP 代码来发送和接收传真。这意味着，你不再需要物理传真机，所有的传真操作都可以在你的应用程序中完成，实现真正的无纸化办公和自动化流程。
第一步：轻松安装，Composer 显神威
使用 Composer 安装 interfax/interfax 库非常简单。你只需要在项目根目录运行以下命令：
composer require interfax/interfax
如果你需要针对特定的 PHP 版本，也可以指定库的版本约束：
- PHP 5.6 - 7.2 用户：
composer require interfax/interfax:"^1"
- PHP 7.3 - 8.1 用户：
composer require interfax/interfax:"^2"
Composer 会自动处理所有的依赖关系，并将库下载到你的 vendor 目录。你只需在代码中引入 Composer 的自动加载文件，即可开始使用：
require_once 'vendor/autoload.php';
至此，interfax/interfax 库已经准备就绪，你可以开始编写代码来控制传真了！
第二步：发送传真，代码搞定一切
发送传真无疑是最核心的需求之一。interfax/interfax 库让这个过程变得异常简单。你需要一个 InterFAX 账户的用户名和密码来初始化客户端。
use Interfax\Client;
// 通过配置数组初始化客户端
$interfax = new Client(['username' => '你的InterFAX用户名', 'password' => '你的InterFAX密码']);
// 或者，如果你在环境变量中设置了 INTERFAX_USERNAME 和 INTERFAX_PASSWORD，
// 也可以直接这样初始化，更符合12因子应用原则：
// $interfax = new Client();
// 准备发送传真的参数
$faxNumber = '+11111111112'; // 接收传真的号码
$filePath = __DIR__ . '/path/to/your/document.pdf'; // 待发送的PDF文件路径
try {
// 发送传真
$fax = $interfax->deliver([
'faxNumber' => $faxNumber,
'file' => $filePath
]);
echo "传真已发送，ID: " . $fax->id . "\n";
// 简单轮询传真状态
echo "正在等待传真完成...\n";
while ($fax->refresh()->status < 0) { // 状态小于0表示仍在处理中
echo "当前状态: " . $fax->status . " (等待中...)\n";
sleep(5); // 每5秒查询一次
}
if ($fax->status === 0) {
echo "传真发送成功！\n";
} else {
echo "传真发送失败，状态码: " . $fax->status . "\n";
}
} catch (\Interfax\Exception\RequestException $e) {
echo "发送传真时发生错误: " . $e->getMessage() . "\n";
echo "HTTP 状态码: " . $e->getStatusCode() . "\n";
// 更多错误信息可以通过 $e->getWrappedException() 获取底层 Guzzle 异常
}这段代码不仅演示了如何发送一个 PDF 文件，还包含了简单的轮询机制来检查传真是否成功。file 参数非常灵活，除了本地文件路径，你还可以传入一个 URI、一个流资源，甚至是 Interfax\File 或 Interfax\Document 对象，以适应各种复杂的场景。
第三步：接收传真，洞察业务动态
除了发送，接收传真也同样重要。interfax/interfax 库提供了便捷的方法来查询和获取接收到的传真。
use Interfax\Client;
$interfax = new Client(['username' => '你的InterFAX用户名', 'password' => '你的InterFAX密码']);
// 获取最近的传入传真列表
$inboundFaxes = $interfax->inbound->incoming(['unreadOnly' => true]); // 只获取未读传真
echo "您有 " . count($inboundFaxes) . " 份未读传真。\n";
foreach ($inboundFaxes as $fax) {
echo "传真 ID: " . $fax->id . "\n";
echo "发送者号码: " . $fax->callerId . "\n";
echo "接收时间: " . $fax->completionTime . "\n";
// 获取传真图片并保存
$imagePath = 'received_faxes/fax_' . $fax->id . '.pdf'; // 可以保存为PDF或TIF
if ($fax->image()->save($imagePath)) {
echo "传真图片已保存到: " . $imagePath . "\n";
}
// 标记为已读
$fax->markRead();
echo "传真 ID: " . $fax->id . " 已标记为已读。\n";
}通过这段代码，你可以轻松获取未读传真列表，下载传真图片，甚至将传真标记为已读或未读。这为构建自动化的传真处理系统（例如，自动识别传真内容并导入到 ERP 系统）奠定了基础。
更多实用功能一览
interfax/interfax 库还提供了许多其他强大的功能，让你的传真管理如虎添翼：
-
查询账户余额：
$client->getBalance()随时了解你的传真信用额度。 -
取消传真：对于仍在处理中的传真，你可以通过
$fax->cancel()方法取消它。 - 搜索传真：通过各种参数（如传真号码、日期范围、状态等）搜索历史传真记录。
- 重发传真：将已发送或接收的传真重发给新的号码或邮箱。
-
处理大文件：对于超过 inline 文件限制的传真，可以使用
Interfax\Document类分块上传。 -
异常处理：所有与 API 交互的方法都可能抛出
Interfax\Exception\RequestException，方便你进行健壮的错误处理。
拥抱自动化：InterFAX 带来的变革
通过 Composer 和 interfax/interfax 库，传真业务不再是传统办公的“遗留问题”，而是可以被现代化系统无缝集成的强大功能。其带来的优势和实际应用效果显而易见：
- 全面自动化：告别手动操作，实现传真发送、接收、归档的全自动化流程。
- 无缝集成：轻松将传真功能集成到现有的 CRM、ERP、OA 等业务系统中，打破信息孤岛。
- 效率与成本双赢：大幅提升传真处理效率，减少人工成本、纸张消耗和设备维护费用。
- 可追溯性与合规性：所有传真记录都可编程查询和管理，便于审计和满足合规要求。
- 提升用户体验：客户和合作伙伴可以通过传真与你的系统进行交互，而无需改变他们的工作习惯。
想象一下，你的在线订单系统可以自动接收供应商的传真确认，你的财务系统可以定时发送账单传真给客户，而这一切都无需人工干预。这不仅仅是效率的提升，更是企业数字化转型的重要一步。
总结
在 PHP 项目中，Composer 是我们管理依赖的基石。而 interfax/interfax 库则为我们提供了一个优雅、高效的方式来处理传统传真业务。它将繁琐的物理操作转化为简单的代码调用，让你的应用程序能够与全球的传真网络无缝连接。如果你还在为传真业务的低效率而烦恼，那么现在就是时候拥抱 Composer 和 interfax/interfax，开启你的传真自动化之旅了！
