README

帮助项目成长。请发送代码或项目文档的 pull request。

PHP SIGEP - 巴西邮政

• 在此处下载最新稳定版本：[链接](https://github.com/stavarengo/php-sigep/tags)

巴西邮政 SIGEP Web 服务实现。

在线查看演示、示例和文档。.

与巴西邮政 Web 服务集成。查询价格和期限，打印标签和 PLP 等。此 API 可以

• 计算订单的价格和交货期限。
• 获取订单的跟踪数据。
• 检查两种地址之间是否允许使用某种服务类型（快递、PAC 等）。
• 生成并发送预列表邮递（PLP）的 XML 到巴西邮政。
• 生成新的标签号码。
• 创建和/或验证标签校验位的有效性（通过 Web 服务或非 Web 服务）。
• 以 PDF 格式生成 PLP 报告。
• 以 PDF 格式生成邮递标签。
• 以 PDF 格式生成每种服务类型的戳记（每种服务类型的徽标）。
• 获取邮寄后 PLP 的数据[由 Sara 处理]。
• 申请、跟踪和取消邮寄授权（逆向物流）。

要求

• PHP >= 5.4.0
• 如果您需要打印标签和报告，请下载 FPDF 1.7 [链接](http://www.fpdf.org/)
  不要忘记在尝试打印报告之前配置 FPDF 以自动加载。

使用 Composer 安装（推荐）

• 我们不通过标签控制版本，但是 master 分支仅在代码稳定时更新。因此，最新稳定版本始终是 master 分支。

将以下行添加到您的 composer.json 文件中: "stavarengo/php-sigep": "dev-master"
"stavarengo/php-sigep-fpdf": "dev-master"

然后通过命令行执行 composer update。

手动安装

• 我们不通过标签控制版本，但是 master 分支仅在代码稳定时更新。因此，最新稳定版本始终是 master 分支。

• 下载最新版本。

• 要使用 php-sigep 类，您只需加载 "php-sigep/src/PhpSigep/Bootstrap.php" 文件。这将注册加载器。

常见问题

PHP 5.3 的问题

该问题已在此处报告：[链接](https://github.com/stavarengo/php-sigep/issues/35) 一些用户在 PHP 版本问题上遇到了与巴西邮政 Web 服务连接和认证的问题。为了解决这个问题，您可以使用 PHP 更新版本（>=5.4）或从巴西邮政下载 WSDL 并在您的服务器上使用它进行连接。如果您选择下载 WSDL，请按照以下步骤操作：[链接](https://apps.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente?wsdl)

1. 将此文件保存在您的本地环境 [链接](https://apps.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente?wsdl)
2. 更改您生产环境中的配置以指向您下载的文件。以下是一个示例。

$config = new \PhpSigep\Config();
$config->setEnv(\PhpSigep\Config::ENV_PRODUCTION);
$config->setWsdlAtendeCliente('CAMINHO-DO-SEU-ARQUIVO-LOCAL');
\PhpSigep\Bootstrap::start($config);

注意：在 Wamp、Xammp 等本地服务器上不会正常工作。

功能

缓存

PhpSigep的缓存组件受到了Zend Framework的缓存组件的启发。

默认情况下，PhpSigep的缓存是禁用的。
此缓存存储了一些邮政Web服务的响应，这些响应可以在以后重用。除了提高请求响应速度外，还可以避免用户在邮政服务器不稳定时无法继续操作（相信我：它经常不稳定）。

要启用缓存，请在创建PhpSigep配置时使用“cacheOptions”键。例如：php new \PhpSigep\Config(array('cacheOptions' => array('storageOptions' => array('enabled' => true, 'ttl' => 60*60*24*7,// 一周),), ...), ); 在storageOptions数组内部，您可以使用PhpSigep\Cache\Storage\Adapter\AdapterOptions类中的任何属性名。

贡献力量

要运行测试套件，通过命令行执行./vendor/bin/phpunit。

1. 进行Fork
2. 创建用于功能性的分支（git checkout -b nova-funcionalidade）
3. 提交您的修改（git commit -am '添加新功能'）
4. 将分支推送到远程（git push origin nova-funcionalidade）
5. 创建新的Pull Request